Apache HTTP Server · API Governance Rules

Apache HTTP Server API Rules

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

7 Rules error 2 warn 4 info 1
View Rules File View on GitHub

Rule Categories

httpd

Rules

error
httpd-operation-summary
All Apache httpd API operations must have a summary
$.paths[*][get,put,post,delete,patch]
error
httpd-operation-id
All Apache httpd API operations must have an operationId
$.paths[*][get,put,post,delete,patch]
warn
httpd-operation-tags
All Apache httpd API operations must have at least one tag
$.paths[*][get,put,post,delete,patch]
warn
httpd-schema-description
All Apache httpd schema components must have a description
$.components.schemas[*]
info
httpd-property-description
All Apache httpd schema properties should have descriptions
$.components.schemas[*].properties[*]
warn
httpd-info-contact
API info must include contact information
$.info
warn
httpd-info-license
API info must include license information
$.info

Spectral Ruleset

Raw ↑ 
rules:
  httpd-operation-summary:
    description: All Apache httpd API operations must have a summary
    severity: error
    given: "$.paths[*][get,put,post,delete,patch]"
    then:
      field: summary
      function: truthy

  httpd-operation-id:
    description: All Apache httpd API operations must have an operationId
    severity: error
    given: "$.paths[*][get,put,post,delete,patch]"
    then:
      field: operationId
      function: truthy

  httpd-operation-tags:
    description: All Apache httpd API operations must have at least one tag
    severity: warn
    given: "$.paths[*][get,put,post,delete,patch]"
    then:
      field: tags
      function: truthy

  httpd-schema-description:
    description: All Apache httpd schema components must have a description
    severity: warn
    given: "$.components.schemas[*]"
    then:
      field: description
      function: truthy

  httpd-property-description:
    description: All Apache httpd schema properties should have descriptions
    severity: info
    given: "$.components.schemas[*].properties[*]"
    then:
      field: description
      function: truthy

  httpd-info-contact:
    description: API info must include contact information
    severity: warn
    given: "$.info"
    then:
      field: contact
      function: truthy

  httpd-info-license:
    description: API info must include license information
    severity: warn
    given: "$.info"
    then:
      field: license
      function: truthy