Zally · Schema

LintingRequest

Request containing a swagger definition file. One of the following fields must be provided: api_definition, api_definition_string, or api_definition_url.

API DesignAPI LintingAPI QualityOpen SourceOpenAPIZalando

Properties

Name	Type	Description
api_definition	object	Specification object in OpenAPI format
api_definition_string	string	Raw API Specification string in OpenAPI format
api_definition_url	string	Link to the specification in OpenAPI format
ignore_rules	array	List of rule ids to be ignored

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "LintingRequest",
  "description": "Request containing a swagger definition file. One of the following fields must be provided:\napi_definition, api_definition_string, or api_definition_url.\n",
  "$id": "https://raw.githubusercontent.com/api-evangelist/zally/refs/heads/main/json-schema/zally-api-linting-request-schema.json",
  "type": "object",
  "properties": {
    "api_definition": {
      "type": "object",
      "description": "Specification object in OpenAPI format",
      "example": {}
    },
    "api_definition_string": {
      "type": "string",
      "description": "Raw API Specification string in OpenAPI format",
      "example": "example-value"
    },
    "api_definition_url": {
      "type": "string",
      "description": "Link to the specification in OpenAPI format",
      "example": "https://example.com/path/abc123"
    },
    "ignore_rules": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "List of rule ids to be ignored",
      "example": [
        "example-value"
      ]
    }
  }
}