查询角色

前言

在阅读下文之前，请先阅读基本功能概述，了解后端回调接口的基本流程与签名规则。

备注

此部分功能可选接入，请根据游戏内容与平台人员沟通是否需要接入这些功能。

查询游戏角色

查询指定用户的角色信息，查询消息类型为 QUERY_ROLE 。

请求示例

{
  "notify_type": "QUERY_ROLE",
  "timestamp": 1624529209,
  "version": "v2",
  "sign_type": "MD5",
  "sign": "20386d447256c1b3310d7274b74c0f25",
  "body": {
    "user_id": 700098915,
    "game_id": "119121100",
    "server_id": ""
  }
}

请求参数说明

参数	类型	长度限制	示例	说明
user_id	int		700098915	平台的用户 ID
game_id	string	255	119121100	平台的游戏 ID
server_id	string	255		游戏方区服 ID，跨端内选服忽略此参数

响应示例

将用户拥有的所有角色信息放在 data 数组返回。

{
  "code": 0,
  "message": "success",
  "data": [
    {
      "id": "11232131",
      "name": "角色名称",
      "level": 0,
      "created_at": 1642509786
    }
  ]
}

响应参数说明

参数	类型	长度限制	示例	说明
id	string	255	11232131	游戏方角色唯一标识
name	string	255	角色名称	游戏方角色名称
level	int		0	角色等级，没有就传 0
created_at	int		1642509786	角色创建时间戳

查询游戏内所有角色

消息类型为 QUERY_ALL_ROLE 。

信息

此消息类型用于平台的活动运营，游戏方不需要主动接入。当游戏方需要接入此类消息时，平台方会主动与游戏方沟通。

请求示例

{
  "notify_type": "QUERY_ALL_ROLE",
  "timestamp": 1624529209,
  "version": "v2",
  "sign_type": "MD5",
  "sign": "20386d447256c1b3310d7274b74c0f25",
  "body": {
    "user_id": 700098915,
    "game_id": "119121100"
  }
}

请求参数说明

参数	类型	长度限制	示例	说明
user_id	int		700098915	平台的用户 ID
game_id	string	255	119121100	平台的游戏 ID

响应示例

{
  "code": 0,
  "message": "success",
  "data": [
    {
      "server_id": "111",
      "server_name": "区服名称",
      "role_id": "11",
      "role_name": "角色名称1",
      "level": 100,
      "online_at": 1642509786
    },
    {
      "server_id": "111",
      "server_name": "区服名称",
      "role_id": "22",
      "role_name": "角色名称2",
      "level": 120,
      "online_at": 1642509786
    }
  ]
}

响应参数说明

注意

data 列表存在排序规则。先按照开服时间排序，将最新区服排在前面；再按照创角时间排序，将最新角色在前面。

参数	类型	长度限制	示例	说明
server_id	string	255	11232131	游戏方区服 ID
server_name	string	255	区服名称	游戏方区服名称
role_id	string	255	11	游戏方角色 ID
role_name	string	255	角色名称	游戏方角色名称
level	int		0	角色等级，没有就传 0
online_at	int		1642509786	区服开服时间戳