Post leaderboard by leaderboard ID submission

POST /leaderboard/{leaderboard_id}/submission

Headers

Path parameters

application/json

Body Required

Responses

  • 200 application/json

    OK

    Hide response attributes Show response attributes object
    • $schema string(uri)

      A URL to the JSON Schema for this object.

    • submission_id string(uuid) Required

      Submission ID used for querying.
  • default application/problem+json

    Error

    Hide response attributes Show response attributes object
    • $schema string(uri)

      A URL to the JSON Schema for this object.

    • detail string

      A human-readable explanation specific to this occurrence of the problem.

    • errors array[object] | null

      Optional list of individual error details

      Hide errors attributes Show errors attributes object
      • location string

        Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'

      • message string

        Error message text

      • value

        The value at the given location

    • instance string(uri)

      A URI reference that identifies the specific occurrence of the problem.

    • status integer(int64)

      HTTP status code

    • title string

      A short, human-readable summary of the problem type. This value should not change between occurrences of the error.

    • type string(uri)

      A URI reference to human-readable documentation for the error.

      Default value is about:blank.
POST /leaderboard/{leaderboard_id}/submission 
curl \
 --request POST https://api.topktoday.dev/leaderboard/146b2edf-2d6f-4775-9b86-5537a2649589/submission \
 --header "Content-Type: application/json" \
 --header "UserID: 146b2edf-2d6f-4775-9b86-5537a2649589" \
 --data '{"link":"string","score":42}'
Request examples 
# Headers
UserID: 146b2edf-2d6f-4775-9b86-5537a2649589

# Payload
{
  "link": "string",
  "score": 42
}
Response examples (200) 
{
  "$schema": "https://api.topktoday.dev/schemas/SubmissionResponseBody.json",
  "submission_id": "146b2edf-2d6f-4775-9b86-5537a2649589"
}
Response examples (default) 
{
  "$schema": "https://api.topktoday.dev/schemas/ErrorModel.json",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "string",
      "message": "string"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example"
}