Ranking

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/gamedevoutsourcing-com/json-schema/gamedevoutsourcing-com-ranking-schema.json",
  "title": "Ranking",
  "x-generated": "2026-11-09",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/gamedevoutsourcing-com-openapi.json#/components/schemas/Ranking",
  "type": "object",
  "required": [
    "slug",
    "label",
    "url",
    "size",
    "method",
    "ranked",
    "citation",
    "caveats"
  ],
  "properties": {
    "slug": {
      "type": "string"
    },
    "label": {
      "type": "string"
    },
    "url": {
      "type": "string",
      "format": "uri"
    },
    "size": {
      "type": "integer",
      "description": "The whole list. Always larger than `ranked`, which holds only published positions."
    },
    "method": {
      "type": "string"
    },
    "ranked": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/RankedStudio"
      },
      "description": "Only the studios given a public number. Nobody is numbered below the cut, so the absence of a studio here is not a low placement."
    },
    "citation": {
      "$ref": "#/$defs/Citation"
    },
    "caveats": {
      "$ref": "#/$defs/Caveats"
    }
  },
  "$defs": {
    "Caveats": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "The standing qualifications on everything this directory publishes. They travel with every payload rather than being stated once, because a caller quotes one response, not a preamble it read earlier. Reproduce the ones that bear on what you are saying."
    },
    "Citation": {
      "type": "string",
      "description": "The attribution line to reproduce when quoting anything from this response."
    },
    "RankedStudio": {
      "type": "object",
      "required": [
        "rank",
        "name",
        "slug",
        "url"
      ],
      "properties": {
        "rank": {
          "type": "integer",
          "minimum": 1
        },
        "name": {
          "type": "string"
        },
        "slug": {
          "type": "string"
        },
        "country": {
          "type": [
            "string",
            "null"
          ],
          "description": "Canonical country label, or null where none is recorded."
        },
        "url": {
          "type": "string",
          "format": "uri"
        }
      }
    }
  }
}