📗
KOMO API V3 Documentation
  • Getting Started
  • Player API Reference
    • Introduction
    • 🔓Account & Authentication
    • 💰NFT and Wallet Portfolio
    • 🎒Inventory
    • 🤝Friend
    • 🏆Tournament
      • Read Tournament Result
    • Tournament Leaderboard
    • Ads
    • 💸Purchasing In-Game Items
  • Admin / Server API Reference
    • Introduction
    • 🙍‍♂️Player Account
    • 🏆Tournament
      • Creating a Tournament
      • Read Tournament Result
      • Managing Tournament (Single Elimination)
      • Managing Tournament (Round Robin)
    • Tournament Leaderboard
Powered by GitBook
On this page
  • Create Tournament Leaderboard
  • Get Leaderboard Tournament
  • Get List Leaderboard Tournament
  • Update Tournament Leaderboard
  1. Admin / Server API Reference

Tournament Leaderboard

Create Tournament Leaderboard

POST [endpoint]/v2/tournament/create

API to Create Tournament Leaderboard

Headers

Name
Type
Description

X-Api-Key*

String

API Key

Request Body

Name
Type
Description

game_id*

String

Game Id

tournament_type*

String

Tournament Type Option : leaderboard, single_elim, double_elim, round_robin

tournament_name*

String

Tournament Name

description*

String

Tournament Description

start_time*

String

Start Time Tournament

end_time*

String

End Time Tournament

participant_limit*

Number

Participant Limit Tournament

listLeaderboard*

Array

Array Object. The Object field is komo_username(String Required), score_type(String Required), value(Double Required)

{
    "message": "Create Game Successfully!",
    "status": "Success"
}

Get Leaderboard Tournament

Get List Leaderboard Tournament

GET [endpoint]/v2/leaderboard/{tournament_id}

Headers

Name
Type
Description

X-Api-Key*

String

API Key

Request Body

Name
Type
Description

sortBy*

String

Sort By Score Type like kill, assist, death, etc.

sortAsc*

Boolean

True will sorting ascending, False will Descending

{
    "status": "success",
    "data": {
        "scoreType": [
            "kill",
            "assist",
            "death"
        ],
        "rank": [
            {
                "komo_username": "Aviabee",
                "scores": [
                    {
                        "kill": 10
                    },
                    {
                        "assist": 4
                    },
                    {
                        "death": 7
                    }
                ]
            },
            {
                "komo_username": "komochess",
                "scores": [
                    {
                        "kill": 11
                    },
                    {
                        "assist": 4
                    },
                    {
                        "death": 0
                    }
                ]
            }
        ]
    }
}
{
    "status": "error",
    "message": {
        "sortBy": [
            "The sort by field is required."
        ],
        "sortAsc": [
            "The sort asc field is required."
        ]
    }
}

Update Tournament Leaderboard

PUT [endpoint]/v2/leaderboard/{tournament_id}

This request will type in body with JSON format. The format is Array of Object.

Headers

Name
Type
Description

X-Api-Key*

String

API Key

Request Body

Name
Type
Description

komo_username*

String

Komo Username

score_type*

String

Score Type Tournament

value*

Number

Value Score Tournament

{
    "message": "Update Tournament Leaderboard Successfully!",
    "status": "Success"
}
{
    "status": "error",
    "message": "Update Tournament Leaderboard Failed! Wrong Request!"
}
PreviousTournament

Last updated 2 years ago