Get Player Information
Retrieve the player's identity information. This API endpoint is provided by the merchant (operator) for the game platform to call.
Request URL
POST {API_URL_ROOT}/player/getPlayer
Note: This URL can be configured in the merchant backend, but the request and response parameters must follow the specifications below.
Request Parameters
Header
| Field | Required | Type | Description |
|---|---|---|---|
| sign | YES | string | Signature computed using the Signature Algorithm. |
| timestamp | YES | int | UTC timestamp in seconds since 1970-01-01, e.g. 1741837297. |
| Accept-Language | YES | string | Language codes, see Language List, e.g. zh,en. Enables localized error messages. |
| Content-Type | YES | string | "application/json; charset=utf-8" |
Body
| Field | Type | Description |
|---|---|---|
| tenantId | int | Merchant ID, the unique integer assigned to you by the platform. |
| userId | string | Merchant's player ID that uniquely identifies each player. |
Response Parameters
| Field | Required | Type | Description |
|---|---|---|---|
| userId | YES | string | Merchant's player ID that uniquely identifies each player. |
| nickName | YES | string | Player nickname. |
| balance | NO | double | Player balance. |
| currency | NO | string | Game currency. |
Example
{
"isSuccess": true,
"code": 0,
"data": {
"userId": "t1_276682",
"nickName": "Player276682",
"balance": 100000,
"currency": "BRL"
}
}