查询角色

接口说明

需要查角色时，KeepSDK POST 你的 role_url。按本文回统一角色列表。

请求方式

• Method：POST
• Content-Type：application/json
• 地址：后台填写的 role_url
• 密钥：login_key

参数说明

{
  "app_id": "lmyxweb",
  "uid": "45yx_web:joy_acc_895111",
  "server_id": "330",
  "time": "1757250000",
  "sign": "..."
}

参数	必填	说明
app_id	是	游戏 app_id
uid	是	KeepSDK 账号。查库用这个 + server_id
server_id	是	区服
time	是	时间戳秒
sign	是	签名，login_key

响应

{
  "code": 0,
  "message": "ok",
  "data": [
    {
      "role_id": "10001",
      "role_name": "测试角色",
      "server_id": "330",
      "level": 1,
      "power": 100,
      "sex": 1,
      "job": "战士",
      "ext": {
        "create_time": "1671098144",
        "last_login": "1671099000",
        "duration": "3000"
      }
    }
  ]
}

只要有渠道要用的字段，统一都按必填回。空值渠道可能不认。

字段	必填	说明
role_id	是	角色 ID
role_name	是	角色名
server_id	是	区服。与请求里同一套
level	是	等级
power	是	战力
sex	是	0 未知 / 1 男 / 2 女，不要回 男
job	是	职业
ext	是	对象，只认下表三个键，其它忽略

ext

字段	必填	说明
create_time	是	创角时间，Unix 秒
last_login	是	上次登录，Unix 秒
duration	是	今日在线时长（秒）

data 正规写法用数组。

code	本接口
0	成功，data 必须有角色，不要空数组
1201	没角色 / 未创角。不要用 0 + 空数组
1202	区服不存在
1203	用户不存在
1101	其它失败

码表见 错误码。