d63af51f84
Some checks failed
api-governance / spectral-lint (push) Has been cancelled
Docs CI / lint-and-preview (push) Has been cancelled
oas-ci / oas-validate (push) Has been cancelled
SDK Publish & Sign / sdk-publish (push) Has been cancelled
Policy Lint & Smoke / policy-lint (push) Has been cancelled
Policy Simulation / policy-simulate (push) Has been cancelled
devportal-offline / build-offline (push) Has been cancelled
114 lines
3.1 KiB
YAML
114 lines
3.1 KiB
YAML
extends:
|
|
- "spectral:oas"
|
|
|
|
formats:
|
|
- "oas3"
|
|
|
|
rules:
|
|
stella-info-title:
|
|
description: "OpenAPI info.title must be present"
|
|
message: "Add a descriptive `info.title`"
|
|
given: "$.info.title"
|
|
severity: error
|
|
then:
|
|
function: truthy
|
|
|
|
stella-info-version:
|
|
description: "OpenAPI info.version must be present"
|
|
message: "Set `info.version` (SemVer or release tag)"
|
|
given: "$.info.version"
|
|
severity: error
|
|
then:
|
|
function: truthy
|
|
|
|
stella-servers-https:
|
|
description: "Servers should use https"
|
|
given: "$.servers[*].url"
|
|
severity: warn
|
|
then:
|
|
function: pattern
|
|
functionOptions:
|
|
match: "^https://"
|
|
|
|
operation-operationId-required:
|
|
description: "Every operation must have an operationId"
|
|
message: "Add an `operationId` for this operation"
|
|
given: "$.paths[*][*]"
|
|
severity: error
|
|
then:
|
|
field: operationId
|
|
function: truthy
|
|
|
|
stella-2xx-response-examples:
|
|
description: "Every 2xx response must include at least one example"
|
|
message: "Add an example or examples block to 2xx responses"
|
|
given: "$.paths[*][*].responses[?(@property.match(/^2\\d\\d$/))].content.*"
|
|
severity: error
|
|
then:
|
|
function: schema
|
|
functionOptions:
|
|
schema:
|
|
anyOf:
|
|
- required: [examples]
|
|
- required: [example]
|
|
|
|
stella-pagination-params:
|
|
description: "Paged GETs must expose limit/cursor parameters"
|
|
message: "Add limit/cursor parameters for paged collection endpoints"
|
|
given: "$.paths[*][get]"
|
|
severity: warn
|
|
then:
|
|
function: schema
|
|
functionOptions:
|
|
schema:
|
|
type: object
|
|
properties:
|
|
parameters:
|
|
type: array
|
|
allOf:
|
|
- contains:
|
|
$ref: '#/components/parameters/LimitParam'
|
|
- contains:
|
|
$ref: '#/components/parameters/CursorParam'
|
|
|
|
stella-idempotency-header:
|
|
description: "POST/PUT/PATCH operations on collection/job endpoints should accept Idempotency-Key"
|
|
message: "Add Idempotency-Key header parameter for idempotent submissions"
|
|
given: "$.paths[*][?(@property.match(/^(post|put|patch)$/))]"
|
|
severity: warn
|
|
then:
|
|
function: schema
|
|
functionOptions:
|
|
schema:
|
|
type: object
|
|
properties:
|
|
parameters:
|
|
type: array
|
|
contains:
|
|
type: object
|
|
properties:
|
|
name:
|
|
const: Idempotency-Key
|
|
in:
|
|
const: header
|
|
required: [name, in]
|
|
|
|
|
|
stella-jobs-idempotency-key:
|
|
description: "Orchestrator job submissions must accept Idempotency-Key header"
|
|
given: "$.paths['/jobs'].post.parameters"
|
|
severity: warn
|
|
then:
|
|
function: schema
|
|
functionOptions:
|
|
schema:
|
|
type: array
|
|
contains:
|
|
type: object
|
|
properties:
|
|
name:
|
|
const: Idempotency-Key
|
|
in:
|
|
const: header
|
|
required: [name, in]
|