dev.tsunagite.getLeaderboard

{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "leaderboard": {
      "description": "A sorted leaderboard of associated scores, with an index for assembling longer leaderboards.",
      "properties": {
        "components": {
          "ref": "dev.tsunagite.game#scoreComponentMap",
          "type": "ref"
        },
        "cursor": {
          "description": "The integer index of the next score after this slice. If not present, no further scores remain.",
          "minimum": 0,
          "type": "integer"
        },
        "scores": {
          "description": "The scores in this slice of leaderboard, sorted in descending order by the specified property.",
          "items": {
            "ref": "dev.tsunagite.defs#associatedScore",
            "type": "ref"
          },
          "type": "array"
        }
      },
      "type": "object"
    },
    "main": {
      "description": "List the leaderboard for a given chart. Does not require auth.",
      "errors": [
        {
          "description": "No chart matching the given URI was found.",
          "name": "chartNotFound"
        },
        {
          "description": "No score component for the game matching the given ID was found.",
          "name": "invalidComponent"
        },
        {
          "description": "There are fewer scores than the requested cursor point.",
          "name": "cursorOutOfBounds"
        }
      ],
      "output": {
        "encoding": "application/json",
        "schema": {
          "ref": "dev.tsunagite.getLeaderboard#leaderboard",
          "type": "ref"
        }
      },
      "parameters": {
        "properties": {
          "chart": {
            "description": "Must point to type `dev.tsunagite.chart`",
            "format": "at-uri",
            "type": "string"
          },
          "cursor": {
            "description": "The index of the highest score to query in this slice.",
            "minimum": 0,
            "type": "integer"
          },
          "inputMethod": {
            "type": "string"
          },
          "limit": {
            "default": 50,
            "description": "How many scores to get in this slice.",
            "maximum": 100,
            "minimum": 1,
            "type": "integer"
          },
          "mode": {
            "type": "string"
          },
          "sortBy": {
            "description": "The ID of the score component to sort the leaderboard by. Will default to the game's default component if not present. Set to `timestamp` to sort by newest/oldest.",
            "format": "record-key",
            "type": "string"
          },
          "versions": {
            "description": "The md5 hashes of the chart versions to list scores for. Will default to the chart's current ranked versions if not present.",
            "items": {
              "maxLength": 16,
              "minLength": 16,
              "type": "bytes"
            },
            "type": "array"
          }
        },
        "required": [
          "chart"
        ],
        "type": "params"
      },
      "type": "query"
    }
  },
  "description": "Defnitions related to querying leaderboards hosted via Tsunagite.",
  "id": "dev.tsunagite.getLeaderboard",
  "lexicon": 1
}