
Description
- The server retrieves player result data corresponding to the game round ID in pages.
Request URL
Request Method
- Transfer Protocol: HTTPS
- Request Method: POST
- Parameters are passed in the body in JSON format (see request example).
- The following header needs to be added: Content-Type: application/json;charset=utf-8
- The following header needs to be added: Authentication Request Header Authorization
Request Parameters
| Parameter Name |
Required |
Type |
Description |
| game_round_id |
Yes |
string |
Game round ID |
| page_no |
Yes |
int32 |
Page number |
| page_size |
Yes |
int32 |
Number of pages |
Request Example
{
"game_round_id": "ce56b6lzi1a7-cehobjt7pk35-vy5fes0t9b0",
"page_no": 0,
"page_size": 10
}
Return Parameters
| Parameter Name |
Required |
Type |
Description |
| ret_code |
Yes |
int |
Response code |
| ret_msg |
Yes |
string |
Response message |
| data |
Yes |
PlayerResultsPage |
Response data |
| Parameter Name |
Required |
Type |
Description |
| total |
Yes |
int32 |
Total number of player results in this round |
| results |
Yes |
PlayerResult[] |
Array of player results |
| Parameter Name |
Required |
Type |
Description |
| uid |
Yes |
string |
User ID, empty string for robot |
| rank |
Yes |
int32 |
Ranking starts from 1, same for tie |
| is_escaped |
Yes |
int32 |
0: normal, 1: escaped |
| is_ai |
Yes |
int32 |
0: normal user, 1: robot |
| role |
No |
int32 |
0: no role information, user's role in the game Game Role Description |
| score |
No |
int32 |
The score the player received in the current round |
| commission_score |
No |
int32 |
Commission score |
| is_win |
No |
int32 |
Result 0: no information, 1: lose, 2: win, 3: tie |
| award |
No |
int32 |
Award |
| extras |
No |
string |
Extended parameters Extended Description |
| is_managed |
No |
int32 |
Whether it is managed 0: not managed 1: managed |
Return Example
{
"ret_code": 0,
"ret_msg": "",
"data": {
"total": 2,
"results": [
{
"is_ai": 0,
"uid": "9ae93a2e",
"rank": 1,
"is_escaped": 0,
"extras": "{\"bet_chip\":[0,0,10]\"bet_award\":0,\"room_id\":\"9001\"}"
},
{
"is_ai": 0,
"uid": "a3b9dbcd",
"rank": 2,
"is_escaped": 0,
"extras": "{\"bet_chip\":[10,20,0]\"bet_award\":30,\"room_id\":\"9001\"}"
}
]
}
}
Business Error Codes
| Error Code |
Error Description |
Solution |
| 10030 |
The program is being processed. Please try again later. |
Please try again later. |
| 70426 |
Invalid game round ID |
Check the request parameters. Currently, only game rounds within the last two months can be queried. |