Apache Pinot · API Governance Rules

Apache Pinot API Rules

Spectral linting rules defining API design standards and conventions for Apache Pinot.

5 Rules error 4 info 1
View Rules File View on GitHub

Rule Categories

info operation response

Rules

error
info-title-required
$.info
error
operation-summary-required
$.paths[*][*]
error
operation-operationId-required
$.paths[*][*]
info
operation-summary-apache-prefix
$.paths[*][get,post,put,delete,patch].summary
error
response-success-required
$.paths[*][get,post,put].responses

Spectral Ruleset

Raw ↑
extends: "spectral:oas"
rules:
  info-title-required:
    severity: error
    given: "$.info"
    then:
      field: title
      function: truthy
  operation-summary-required:
    severity: error
    given: "$.paths[*][*]"
    then:
      field: summary
      function: truthy
  operation-operationId-required:
    severity: error
    given: "$.paths[*][*]"
    then:
      field: operationId
      function: truthy
  operation-summary-apache-prefix:
    severity: info
    given: "$.paths[*][get,post,put,delete,patch].summary"
    then:
      function: pattern
      functionOptions:
        match: "^Apache Pinot"
  response-success-required:
    severity: error
    given: "$.paths[*][get,post,put].responses"
    then:
      function: schema
      functionOptions:
        schema:
          required: ["200"]