Zally · Schema

ReviewStatisticsResponse

Linting results and review statistics for a given interval in time

API DesignAPI LintingAPI QualityOpen SourceOpenAPIZalando

Properties

Name Type Description
total_reviews integer Total number of lintings
total_reviews_deduplicated integer Unique APIs linted
successful_reviews integer Number of successful lintings
number_of_endpoints integer Number of endpoints in the linted APIs
must_violations integer Number of MUST violations
should_violations integer Number of SHOULD violations
may_violations integer Number of MAY violations
hint_violations integer Number of HINTS
View JSON Schema on GitHub

JSON Schema

zally-api-review-statistics-response-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "ReviewStatisticsResponse",
  "description": "Linting results and review statistics for a given interval in time",
  "$id": "https://raw.githubusercontent.com/api-evangelist/zally/refs/heads/main/json-schema/zally-api-review-statistics-response-schema.json",
  "type": "object",
  "properties": {
    "total_reviews": {
      "type": "integer",
      "format": "int32",
      "example": 23,
      "description": "Total number of lintings"
    },
    "total_reviews_deduplicated": {
      "type": "integer",
      "format": "int32",
      "example": 12,
      "description": "Unique APIs linted"
    },
    "successful_reviews": {
      "type": "integer",
      "format": "int32",
      "example": 17,
      "description": "Number of successful lintings"
    },
    "number_of_endpoints": {
      "type": "integer",
      "format": "int32",
      "example": 10,
      "description": "Number of endpoints in the linted APIs"
    },
    "must_violations": {
      "type": "integer",
      "format": "int32",
      "example": 123,
      "description": "Number of MUST violations"
    },
    "should_violations": {
      "type": "integer",
      "format": "int32",
      "example": 81,
      "description": "Number of SHOULD violations"
    },
    "may_violations": {
      "type": "integer",
      "format": "int32",
      "example": 32,
      "description": "Number of MAY violations"
    },
    "hint_violations": {
      "type": "integer",
      "format": "int32",
      "example": 5,
      "description": "Number of HINTS"
    }
  },
  "required": [
    "total_reviews",
    "total_reviews_deduplicated",
    "successful_reviews",
    "number_of_endpoints",
    "must_violations",
    "should_violations",
    "may_violations",
    "hint_violations"
  ]
}