HomeCreator GuideIntegration GuideReference

Public API

Public API endpoints for the Gamify Extension

Fetch the top of the Project-level leaderboard

get

Returns limit records (defaults to 10). May additionally include specified user records even if they are outside of the range.

Path parameters
projectIdstring · uuidRequired

ID of the Project

leaderboardIdstring · enumRequiredPossible values:
Query parameters
includestringOptional

Comma-separated list of user IDs

limitinteger · min: 1 · max: 100Optional

Maximum number of records to return

Default: 10
Responses
200

success

application/json
get
/projects/{projectId}/leaderboards/{leaderboardId}
GET /projects/{projectId}/leaderboards/{leaderboardId} HTTP/1.1
Host: 
Accept: */*

{
  "data": [
    {
      "rank": 1,
      "score": 1000,
      "userId": "123e4567-e89b-12d3-a456-426614174000",
      "publicProfile": {
        "username": "Joe"
      }
    }
  ],
  "totalCount": 1
}

Fetch a single record from the Project-level leaderboard

get
Path parameters
projectIdstring · uuidRequired

ID of the Project

leaderboardIdstring · enumRequiredPossible values:
userIdstringRequired

User Id

Responses
200

success

application/json
get
/projects/{projectId}/leaderboards/{leaderboardId}/users/{userId}
GET /projects/{projectId}/leaderboards/{leaderboardId}/users/{userId} HTTP/1.1
Host: 
Accept: */*

{
  "data": {
    "rank": 1,
    "score": 1000,
    "userId": "123e4567-e89b-12d3-a456-426614174000",
    "publicProfile": {
      "username": "Joe"
    }
  }
}

Fetch the top of the Event-level leaderboard

get

Returns limit records (defaults to 10). May additionally include specified user records even if they are outside of the range.

Path parameters
projectIdstring · uuidRequired

ID of the Project

eventIdone ofRequired

ID of the Event

string · uuidOptional
or
string · enumOptionalPossible values:
leaderboardIdstring · enumRequired

N is positive integer value for a round number. For example round_2

Possible values:
Query parameters
includestringOptional

Comma-separated list of user IDs

limitinteger · min: 1 · max: 100Optional

Maximum number of records to return

Default: 10
Responses
200

success

application/json
get
/projects/{projectId}/events/{eventId}/leaderboards/{leaderboardId}
GET /projects/{projectId}/events/{eventId}/leaderboards/{leaderboardId} HTTP/1.1
Host: 
Accept: */*

{
  "data": [
    {
      "rank": 1,
      "score": 1000,
      "userId": "123e4567-e89b-12d3-a456-426614174000",
      "publicProfile": {
        "username": "Joe"
      }
    }
  ],
  "totalCount": 1
}

Fetch a single record from the Event-level leaderboard

get
Path parameters
projectIdstring · uuidRequired

ID of the Project

eventIdone ofRequired

ID of the Event

string · uuidOptional
or
string · enumOptionalPossible values:
leaderboardIdstring · enumRequired

N is positive integer value for a round number. For example round_2

Possible values:
userIdstringRequired

User Id

Responses
200

success

application/json
get
/projects/{projectId}/events/{eventId}/leaderboards/{leaderboardId}/users/{userId}
GET /projects/{projectId}/events/{eventId}/leaderboards/{leaderboardId}/users/{userId} HTTP/1.1
Host: 
Accept: */*

{
  "data": {
    "rank": 1,
    "score": 1000,
    "userId": "123e4567-e89b-12d3-a456-426614174000",
    "publicProfile": {
      "username": "Joe"
    }
  }
}

Last updated