Apache HttpComponents · API Governance Rules

Apache HttpComponents API Rules

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

7 Rules error 2 warn 4 info 1

View Rules File View on GitHub

Rule Categories

http

Rules

error

http-client-operation-summary

All Apache HttpComponents API operations must have a summary

$.paths[*][get,put,post,delete,patch]

error

http-client-operation-id

All Apache HttpComponents API operations must have an operationId

$.paths[*][get,put,post,delete,patch]

warn

http-client-operation-tags

All Apache HttpComponents API operations must have at least one tag

$.paths[*][get,put,post,delete,patch]

warn

http-client-schema-description

All Apache HttpComponents schema components must have a description

$.components.schemas[*]

info

http-client-property-description

All Apache HttpComponents schema properties should have descriptions

$.components.schemas[*].properties[*]

warn

http-client-info-contact

API info must include contact information

$.info

warn

http-client-info-license

API info must include license information

$.info

Spectral Ruleset

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

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

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

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

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

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

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