Brief Description
- Room seat change 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 (in milliseconds) when the notification was sent by the server |
1647834452408 |
| app_id |
Yes |
string |
Application ID of the message receiver |
1 |
| notify_event |
Yes |
string |
Notification event |
sud.mg.merchant.room.seat.changed |
| data |
Yes |
SeatChangedModel |
Notification data |
{} |
SeatChangedModel
| Parameter |
Required |
Type |
Description |
Example Value |
| mg_id |
Yes |
string |
Game ID |
14615640800525066 |
| room_id |
Yes |
string |
Room ID |
9009 |
| changed_time |
Yes |
string |
Timestamp of change (ms) |
1750144904293 |
| seat_changed |
Yes |
ChangedObject[] |
List of players changed |
[] |
| seat_players |
No |
PlayerObject[] |
Player status after change |
[] |
ChangedObject
| Parameter |
Required |
Type |
Description |
Example |
| uid |
Yes |
string |
ID of the player changed |
xxx |
| changed_type |
Yes |
int32 |
1.Sit down 2.Stand up 3.Ready 4.Cancel |
1 |
PlayerObject
| Parameter |
Required |
Type |
Description |
Example |
| uid |
Yes |
string |
User UID |
xxx |
| seat_index |
Yes |
int32 |
Seat index (starting from 0) |
0 |
| status |
Yes |
string |
User status enum:
IDLE: Not ready
READY: Ready |
IDLE |
Message Signature Verification
Signature Verification
Request Example
{
"notify_id": "xxx",
"notify_time": "1749635780743",
"app_id": "xxx",
"notify_event": "sud.mg.merchant.room.seat.changed",
"data": {
"mg_id": "xxx",
"room_id": "xxx",
"changed_time": "1749635780843",
"seat_changed": [
{
"uid": "xxx",
"changed_type": 3
}
],
"seat_players": [
{
"uid": "xxx",
"seat_index": 0,
"status": "READY"
}
]
}
}
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",
}