#
Brief description
- Player status event notification
Request method
- HTTPS
- POST
- Parameters are in Json format and placed in the body
Request parameters (new fields may be added, please keep the server compatible with the newly added fields)
| Parameter name |
Required |
Type |
Description |
Example value |
| notify_id |
Yes |
string |
Notification ID |
0795d77f85789da0eb387a5096 |
| notify_time |
Yes |
string |
Timestamp of the server when notifying (milliseconds) |
1647834452408 |
| app_id |
Yes |
string |
Application ID of the message recipient |
xxx |
| notify_event |
yes |
string |
Notification event |
sud.mg.merchant.player.status |
| data |
yes |
PlayerStatusModel |
Notification data |
{} |
PlayerStatusModel
| Parameter name |
Required |
Type |
Description |
Example value |
| mg_id |
yes |
string |
Game id |
14615640800525066 |
| room_id |
yes |
string |
Room id |
9009 |
| game_round_id |
no |
string |
Game round id (only events in the game have value) |
ce56b6lzi1a7-v8eoi58qanhk-vjzmzss |
| event |
yes |
string |
Event name |
manage_status |
| players |
yes |
PlayerModel [] |
Player array |
[] |
| payload |
No |
object |
Extended fields |
{} |
| Parameter name |
Required |
Type |
Description |
Example value |
| uid |
Yes |
string |
Player uid |
u001 |
| type |
No |
string |
Player type (used in cross-domain scenarios, etc.):
INTERNAL: Internal
EXTERNAL: External |
INTERNAL |
| timestamp |
Yes |
string |
Millisecond timestamp of event occurrence |
xxx |
| payload |
No |
object |
Extended fields |
{} |
Event Data Parameters Corresponding Table
- LUDO, game ID = 1468180338417074177
| Event |
payload |
Payload in PlayerModel |
Description |
| manage_status |
{} |
{“is_managed”:1} |
0: Cancel hosting 1: Host |
- UMO, game ID = 1472142559912517633
| Event |
payload |
Payload in PlayerModel |
Description |
| manage_status |
{} |
{“is_managed”:1} |
0: Cancel hosting 1: Host |
- Snakes and Ladders, game ID = 1716668321022017537
| Event |
payload |
Payload in PlayerModel |
Description |
| manage_status |
{} |
{“is_managed”:1} |
0: Cancel hosting 1: Hosting |
- Domino, game ID = 1537330258004504578
| Event |
payload |
Payload in PlayerModel |
Description |
| manage_status |
{} |
{“is_managed”:1} |
0: Cancel hosting 1: Hosting |
Message signature verification
Signature verification
Request example
{
"notify_id": "xxx",
"notify_time": "xxx",
"app_id": "xxx",
"notify_event": "sud.mg.merchant.player.status",
"data": {
"mg_id": "xxx",
"room_id": "xxx",
"game_round_id": "xxx",
"event": "manage_status",
"players": [{
"uid": "xxx",
"timestamp": "xxx",
"type": "INTERNAL",
"payload": {"is_managed":1}
}]
}
}
Notification response
| Parameter name |
Required |
Type |
Description |
Example value |
| ret_code |
Yes |
int32 |
Return status code, 0 means successful message notification, other error codes mean failure |
0 |
| ret_msg |
Yes |
string |
Return message |
SUCCESS |
Response example
{
"ret_code": 0,
"ret_msg": "SUCCESS",
}