
Description
- Query all round IDs of a single game session.
Request URL
Request Method
- Transmission protocol: HTTPS
- Request method: POST
- Parameters are passed in the body in JSON format (see the request example).
- The following header needs to be added: Content-Type: application/json;charset=utf-8
- The following header needs to be added: Authorization header for authentication.
Request Parameters
Parameter Name |
Required |
Type |
Description |
match_id |
Optional |
string |
Game session ID. Cannot be empty at the same time as report_game_info_key. |
report_game_info_key |
Optional |
string |
The report information key passed in at the beginning of the game. Can be empty at the same time as match_id. If both report_game_info_key and match_id exist at the same time, match_id has a higher priority. |
Request Example
{
"match_id": "1659497694003"
}
Response Parameters
Parameter Name |
Required |
Type |
Description |
ret_code |
Yes |
int |
Response code |
ret_msg |
Yes |
string |
Response message |
data |
Yes |
AppServerQueryMatchRoundIdsResp |
Response data |
- AppServerQueryMatchRoundIdsResp
Parameter Name |
Required |
Type |
Description |
match_id |
Yes |
string |
Game session ID. |
total |
Yes |
int32 |
Total number of game sessions. |
round_ids |
Yes |
string[] |
List of game session IDs (sorted by game session index). |
report_game_info_key |
No |
string |
The report information key passed in at the beginning of the game. |
Response Example
{
"ret_code": 0,
"ret_msg": "",
"data": {
"match_id": "ce56b6lzi1a7-cf75m85c4b1f-cxzdyxkqqal0",
"total": 4,
"round_ids": [
"ce56b6lzi1a7-cf75m85c4b1f-cxzd9yv2m9jd",
"ce56b6lzi1a7-cf75m85c4b1f-cxzdh4am1l70",
"ce56b6lzi1a7-cf75m85c4b1f-cxzdjb01m3gz",
"ce56b6lzi1a7-cf75m85c4b1f-cxzdgbk9zfbd"
],
"report_game_info_key": ""
}
}
Business Error Codes
Error Code |
Error Description |
Solution |
10002 |
Parameter error |
Check the request parameters and resubmit the request after modification. |
70420 |
The game session does not exist |
Check whether the order number and report information key are correct, and then resubmit the request. |