Brief Description
- Game Process Event Notification
Request Method
- HTTPS
- POST
- Parameters are in JSON format and placed in the body
Request Parameters (additional fields may be added, please keep compatibility with the added fields on the server side)
| Parameter Name |
Required |
Type |
Description |
Example |
| notify_id |
Yes |
string |
Notification ID |
0795d77f85789da0eb387a5096 |
| notify_time |
Yes |
string |
Timestamp on the server when the notification is sent (in milliseconds) |
1647834452408 |
| app_id |
Yes |
string |
Application ID of the message recipient |
1 |
| notify_event |
Yes |
string |
Notification event |
sud.mg.merchant.game.process |
| data |
Yes |
GameProcessModel |
Notification data |
{} |
GameProcessModel
| Parameter Name |
Required |
Type |
Description |
Example |
| mg_id |
Yes |
string |
Game ID |
14615640800525066 |
| room_id |
Yes |
string |
Room ID |
9009 |
| game_round_id |
Yes |
string |
Game Round ID |
ce56b6lzi1a7-v8eoi58qanhk-vjzmzss |
| event |
Yes |
string |
Event name |
chess_end |
| players |
Yes |
PlayerModel [] |
Array of players |
[] |
| payload |
No |
object |
Additional fields |
{} |
| Parameter Name |
Required |
Type |
Description |
Example |
| uid |
Yes |
string |
Player UID |
u001 |
| type |
No |
string |
Player type (used in cross-domain scenarios):
INTERNAL: Internal
EXTERNAL: External |
INTERNAL |
| payload |
No |
object |
Additional fields |
{} |
Event Data Parameters Corresponding Table
- LUDO, Game ID = 1468180338417074177
| Event |
payload |
Payload in PlayerModel |
Description |
| chess_end |
{} |
{} |
Chess piece reaches the end point |
- Battle Elimination, Game ID=1689904909564116994
| Event |
Payload |
PlayerData Payload |
Description |
| self_die |
{} |
{} |
Eliminated Player |
- Minesweeper, Game ID=1472142640866779138
| Event |
Payload |
PlayerData Payload |
Description |
| self_die |
{} |
{} |
Eliminated Player |
- Jump, Game ID=1680881367829176322
| Event |
Payload |
PlayerData Payload |
Description |
| self_die |
{} |
{} |
Eliminated Player |
- Monopoly, game ID = 1704460412809043970
| Event |
payload |
Payload in PlayerData |
Description |
| self_die |
{} |
{} |
Eliminated player |
Message Signature Verification
Signature Verification
Request Example
{
"notify_id": "0795d77f85789da0eb387a50964993a3eba1fedfec2b12f729861392a9b5ad04",
"notify_time": "1647844976502",
"app_id": "14615640800525066",
"notify_event": "sud.mg.merchant.game.process",
"data": {
"mg_id": "14615640800525066",
"room_id": "9009",
"game_round_id": "ce56b6lzi1a7-v8eoi58qanhk-vjzmzss",
"event": "chess_end",
"players": [{
"uid": "u001",
"type": "INTERNAL"
}]
}
}
Notification Response
| Parameter Name |
Required |
Type |
Description |
Example |
| ret_code |
Yes |
int32 |
Return status code, 0 for successful notification, other error codes for failure |
0 |
| ret_msg |
Yes |
string |
Return message |
SUCCESS |
Response Example
{
"ret_code": 0,
"ret_msg": "SUCCESS",
}