Player Management and Player Data

Create a unique player token and manage player data

Get Public Key

Auth: None

Get the public key to verify JWT user tokens

GET https://api.gaimin.gg/api/public/v1/public-key

Headers

Name	Type	Description
accept*	String	*/*

Example Request:

curl --location -g 'https://{{gaimin_link}}/api/public/v1/public-key' \
--header 'accept: */*'

Example Response:

{
  "data": {
    "publicKey": "MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEDsvDNG6PmWbBFaWQJnx0V7/EKST+KV8Xr0QeMmuuJfGbPkKyHWAAmqJYxJefIX5ZrPiTmGp/hWOFSh2UJYOkig=="
  },
  "success": true
}

Create Player Token

Auth: USER

Create a new player token, valid for 24 hours

GET https://api.gaimin.gg/api/public/v1/player/token

Players in a game are identified within the game with a unique player token. A player token, valid for 24 hours needs to be generated for each player.

Headers

Name	Type	Description
accept*	String	*/*
Authorization*	String	Bearer

200: OK TBA - playerToken (?)

Example Request:

curl --location 'https://api.qa.gaimin.gg/api/public/v1/player/token' \
--header 'accept: */*' \
--header 'Authorization: Bearer eyJraWQiOiJXWDUwa1hoeXRhSE5rd1lCQnNwemNjNzFMRldmQXdWT3Aybm52eGEtcWV3IiwiYWxnIjoiUlMyNTYifQ.eyJ2ZXIiOjEsImp0aSI6IkFULnVYX19XRmdidFNoYklRUDJaSmgwNi1NeFdFYWlMODFKUWVySlN6VXR0VnMiLCJpc3MiOiJodHRwczovL29rdGEuZ2FpbWluLm5ldC9vYXV0aDIvZGVmYXVsdCIsImF1ZCI6ImFwaTovL2RlZmF1bHQiLCJpYXQiOjE2NzU5NTEwNTksImV4cCI6MTY3NTk1NDY1OSwiY2lkIjoiMG9hNDNxcHkzYTA4QnMyMXg0eDYiLCJ1aWQiOiIwMHU2OHltczIwclRZYmdWRTR4NyIsInNjcCI6WyJvcGVuaWQiLCJlbWFpbCJdLCJhdXRoX3RpbWUiOjE2NzU5NTEwNTksInN1YiI6Im5lcGdhaW1pbkB0aGVyYXZlbi50ZWNoIn0.X9kBD55DYBxvAJIWQ2Rgh2rkTneLac-lM8V2L7IbvnvbrsD1K0axQArPh8k76fT0fc8EpA5S19w6FydyU_f6v4zwCfOCpmkqGt-cMTO6qQupWb_uxGTZaiq0J00uHkPYe3gf9ZPRs98nxHji2smn_YIweVjN1R5C8yWDyC1tBVbzcfuvoZ6zdD68LAK1BYxTbWnBZgwqqQa0WDjHI_p3-GVnVyY2ECw_Ok5sWw1ikoQugO0vCuJzkm5xgaDIAfIz6HIlb0Y0BXU-CNywcL3T8wwEM8sAjL28K6b2bM-M_hk3YlrqIkAVL27tcpgJH_pAgaCby1aqeUXHGb9LlkNy8Q'

Example Response:

{
  "data": {
    "token": "eyJhbGciOiJFUzI1NiJ9.eyJzdWIiOiIwMHU2OHltczIwclRZYmdWRTR4NyIsImV4cCI6MTY3NjAzODc5Mn0.ortJhGh0waufsWoitahssnvt8iSSarqeghnKsnvC6Mv9nY5AMWiVLy5KeaJEi2PYyD4HofpPo3jCxyHCcOMl2g"
  },
  "success": true
}

Obtain Player Details

Auth: NONE

Get the player data associated with a playerToken

GET https://api.gaimin.gg/api/public/v1/player/details

Get player's data which includes id, username and GMRX balance.

Headers

Name	Type	Description
accept*	String	*/*

Request Body

Name	Type	Description
playerToken*	String	Player Token

200: OK Player Information

- userId
- username
- amount (GMRX balance)

Example Request:

curl --location 'https://api.qa.gaimin.gg/api/public/v1/player/balance?playerToken=eyJhbGciOiJFUzI1NiJ9.eyJzdWIiOiIwMHU2OHltczIwclRZYmdWRTR4NyIsImV4cCI6MTY3NjAzNzM1NX0.UAFqjq9lLJ8em4C9OsaMEX8vQQZiz1pkzKe35yF-ZVwZszWznP0iXh61sPNfGFnA4pDTlD6LXi2VLLjbS8MIpw' \
--header 'accept: */*'

Example Response:

{
  "data": {
    "userId": 7000568,
    "username": "GAIMIN",
    "amount": 240660.57437323895
  },
  "success": true
}