#

SUD

简要描述

  • 玩家状态事件通知

请求方式

  • 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:托管
消息验签

验签

请求示例

{
    "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",
}

results matching ""

    No results matching ""