
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. |