#

简要描述
- 玩家状态事件通知
请求方式
- HTTPS
- POST
- 参数为Json格式,放在body内
请求参数(可能会新增加字段,请服务端保持新增加字段兼容性)
| 参数名 | 必选 | 类型 | 说明 | 示例值 |
|---|---|---|---|---|
| notify_id | 是 | string | 通知ID | 0795d77f85789da0eb387a5096 |
| notify_time | 是 | string | 通知时服务端的时间戳(毫秒) | 1647834452408 |
| app_id | 是 | string | 消息接收方的应用id | xxx |
| notify_event | 是 | string | 通知事件 | sud.mg.merchant.player.status |
| data | 是 | PlayerStatusModel | 通知数据 | {} |
PlayerStatusModel
| 参数名 | 必选 | 类型 | 说明 | 示例值 |
|---|---|---|---|---|
| mg_id | 是 | string | 游戏id | 14615640800525066 |
| room_id | 是 | string | 房间id | 9009 |
| game_round_id | 否 | string | 游戏局id(处于游戏中的事件才有值) | ce56b6lzi1a7-v8eoi58qanhk-vjzmzss |
| event | 是 | string | 事件名 | manage_status |
| players | 是 | PlayerModel [] | 玩家数组 | [] |
| payload | 否 | object | 扩展字段 | {} |
- PlayerModel
| 参数名 | 必选 | 类型 | 说明 | 示例值 |
|---|---|---|---|---|
| uid | 是 | string | 玩家uid | u001 |
| type | 否 | string | 玩家类型(跨域等场景使用): INTERNAL: 内部 EXTERNAL: 外部 |
INTERNAL |
| timestamp | 是 | string | 事件发生毫秒时间戳 | xxx |
| payload | 否 | object | 扩展字段 | {} |
event 事件数据参数对应表
1.飞行棋LUDO,游戏ID=1468180338417074177
| 事件 | payload | PlayerModel中payload | 说明 |
|---|---|---|---|
| manage_status | {} | {“is_managed”:1} | 0:取消托管 1:托管 |
2.UMO,游戏ID=1472142559912517633
| 事件 | payload | PlayerModel中payload | 说明 |
|---|---|---|---|
| manage_status | {} | {“is_managed”:1} | 0:取消托管 1:托管 |
3.蛇梯,游戏ID=1716668321022017537
| 事件 | payload | PlayerModel中payload | 说明 |
|---|---|---|---|
| manage_status | {} | {“is_managed”:1} | 0:取消托管 1:托管 |
4.多米诺,游戏ID=1537330258004504578
| 事件 | payload | PlayerModel中payload | 说明 |
|---|---|---|---|
| manage_status | {} | {“is_managed”:1} | 0:取消托管 1:托管 |
5.排雷兵,游戏ID=1472142640866779138
| 事件 | payload | PlayerModel中payload | 说明 |
|---|---|---|---|
| manage_status | {} | {“is_managed”:1} | 0:取消托管 1:托管 |
6.数字炸弹,游戏ID=1468091457989509190
| 事件 | payload | PlayerModel中payload | 说明 |
|---|---|---|---|
| manage_status | {} | {“is_managed”:1} | 0:取消托管 1:托管 |
消息验签
请求示例
{
"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}
}]
}
}
通知应答
| 参数名 | 必选 | 类型 | 说明 | 示例值 |
|---|---|---|---|---|
| ret_code | 是 | int32 | 返回状态码, 0为消息通知成功,其他错误码为失败 | 0 |
| ret_msg | 是 | string | 返回消息 | SUCCESS |
应答示例
{
"ret_code": 0,
"ret_msg": "SUCCESS",
}