聊天消息同步
游戏方将游戏内玩家的聊天消息主动告知平台,以便平台能够观察游戏内的聊天情况,并及时对违规玩家做出处理。
新增聊天消息
请求地址
https://api2-youxi.xunlei.com/cp/message/v1/sync
请求体概述
- HTTP 请求方法:
POST - HTTP 请求标头:
Content-Type: application/json
请求示例
curl -iv --location 'https://api2-youxi.xunlei.com/cp/message/v1/sync' \
--header 'Content-Type: application/json' \
--data '{
"game_id": "a1234567",
"account": "a010202",
"server_id": "s992",
"server_create_time": "2023-10-30 09:00:00",
"role_id": "r_912722",
"role_name": "愤怒的小鸟",
"msg": "来吧,这里有钱领",
"sign": "6bb6b47fa8b5e035521de23092bdf420",
"ts": 1702957771,
"msg_type": 1
}'
请求参数
| 参数 | 类型 | 说明 | 示例 |
|---|---|---|---|
| game_id | string | 游戏 ID | a1234567 |
| account | string | 迅雷平台的用户 ID | xxxxxx |
| server_id | string | 游戏的区服 ID | s101 |
| server_create_time | string | 游戏的开服时间 | 2023-10-01 10:00:00 |
| role_id | string | 游戏的角色 ID | r920922 |
| role_name | string | 游戏的角色名称 | 愤怒的小鸟 |
| msg | string | 消息内容 | xxxx |
| msg_type | int32 | 消息类型 ,1 - 世界 、 2 - 私聊、 3 - 其它 | 1 |
| sign | string | 签名(查看签名规则) | xxxxxxxxxx |
| ts | int64 | Unix 时间戳(单位:秒) | 1702957771 |
特别提醒
msg_type ts 参数值为整数类型,其余为字符串类型,如您使用了错误的数据类型,会上报失败并响应以下错误
{
"code": 20010,
"message": "invalid body"
}
响应示例(上报成功)
{
"code": 0,
"message": "success"
}
响应参数说明
| 参数 | 类型 | 说明 |
|---|---|---|
| code | int32 | 业务码 |
| message | string | 业务信息 |
响应业务码
| 业务码 | 业务码说明 |
|---|---|
| 0 | 成功 |
| 20010 | 请求数据不合法 |
| 20011 | 缺少字段 |
| 20020 | 签名不正确 |
| 20050 | 系统错误 |