BJ's Wholesale Club · API Governance Rules

BJ's Wholesale Club API Rules

Spectral linting rules defining API design standards and conventions for BJ's Wholesale Club.

5 Rules warn 5
View Rules File View on GitHub

Rule Categories

bjs

Rules

warn
bjs-membership-number-required
Orders and membership verifications must include a membershipNumber
$.paths['/membership/verify'].post.requestBody.content['application/json'].schema
warn
bjs-order-status-enum
Order status must be one of the defined enum values
$.components.schemas.Order.properties.status
warn
bjs-product-price-positive
Product price must be defined as a number type
$.components.schemas.Product.properties.price
warn
bjs-api-key-security
All endpoints must use ApiKeyAuth security scheme
$.paths[*][*]
warn
bjs-operations-have-tags
All operations should have at least one tag
$.paths[*][*]

Spectral Ruleset

Raw ↑
rules:
  bjs-membership-number-required:
    description: Orders and membership verifications must include a membershipNumber
    message: "{{description}}"
    given: "$.paths['/membership/verify'].post.requestBody.content['application/json'].schema"
    then:
      field: required
      function: schema
      functionOptions:
        schema:
          type: array
          contains:
            const: membershipNumber

  bjs-order-status-enum:
    description: Order status must be one of the defined enum values
    message: "Order status field must use defined enum values"
    given: "$.components.schemas.Order.properties.status"
    then:
      field: enum
      function: truthy

  bjs-product-price-positive:
    description: Product price must be defined as a number type
    message: "Product price must be a numeric type"
    given: "$.components.schemas.Product.properties.price"
    then:
      field: type
      function: pattern
      functionOptions:
        match: "^number$"

  bjs-api-key-security:
    description: All endpoints must use ApiKeyAuth security scheme
    message: "Endpoint must specify ApiKeyAuth security"
    given: "$.paths[*][*]"
    then:
      field: security
      function: truthy

  bjs-operations-have-tags:
    description: All operations should have at least one tag
    message: "Operation must include at least one tag"
    given: "$.paths[*][*]"
    then:
      field: tags
      function: truthy