DeepSeek · API Governance Rules

DeepSeek API Rules

Spectral linting rules defining API design standards and conventions for DeepSeek.

4 Rules error 1 warn 3

View Rules File View on GitHub

Rule Categories

deepseek

Rules

warn

deepseek-chat-server

Servers should reference the DeepSeek API base URL.

$.servers[*].url

error

deepseek-chat-completions-path

API should expose the /chat/completions resource.

$.paths

warn

deepseek-chat-operation-id

Chat completion operations should declare an operationId.

$.paths[*][*]

warn

deepseek-chat-bearer-auth

Security schemes should include HTTP bearer authentication.

$.components.securitySchemes[*]

Spectral Ruleset

extends:
  - spectral:oas
rules:
  deepseek-chat-server:
    description: Servers should reference the DeepSeek API base URL.
    given: $.servers[*].url
    severity: warn
    then:
      function: pattern
      functionOptions:
        match: "api.deepseek.com"
  deepseek-chat-completions-path:
    description: API should expose the /chat/completions resource.
    given: $.paths
    severity: error
    then:
      function: pattern
      functionOptions:
        match: "/chat/completions"
  deepseek-chat-operation-id:
    description: Chat completion operations should declare an operationId.
    given: $.paths[*][*]
    severity: warn
    then:
      field: operationId
      function: truthy
  deepseek-chat-bearer-auth:
    description: Security schemes should include HTTP bearer authentication.
    given: $.components.securitySchemes[*]
    severity: warn
    then:
      field: scheme
      function: truthy