跳到主要内容

后台接口概览

Player Network 提供了一整套后台接口来支持业务运营。要访问这些后台接口，请先 在 Player Network 控制台配置您的游戏。

警告

不要在 Player Network SDK 正式环境中进行压力测试。如果游戏需要对自身模块进行压力测试，建议模拟 Player Network SDK 的认证请求。如需压测账号服务，请提前联系 Player Network 助手。

注意

后台接口设有权限控制，非 LI PASS 客户端或后台 HTTPS 的第三方平台在调用时，若出现权限错误（如 10000），请联系 Player Network 助手申请开通相应接口权限。

基本结构​

  • 接口协议：HTTPS
  • 字符编码：UTF-8
  • 标头：Content-Type: application/json
  • 接口超时时间：8,100 ms
  • 服务器 URL：取决于在 Player Network 控制台中配置的部署集群。从控制台 获取部署集群信息 来找到业务所需的服务器 URL。

URL 格式​

后台接口请求的标准 URL 格式为：

https://test.intlgame.com/v2/auth/verify_login?os=1&gameid=11&channelid=1&ts=1528097722&sdk_version=0.1&sig=xxx
\_______________________/\___________________/ \______________________________________________________________/
        服务器 URL                端点路径                           查询参数

鉴权​

Player Network 后台接口使用 hash 码来验证请求。有关 hash 值（sig 参数）的更多信息，请联系 Player Network 助手。

查询参数​

参数类型说明备注
osstring操作系统标识
1：Android
2：iOS
3：Web
4：Linux
5：Windows
6：Nintendo
7：Mac
8：PlayStation
9：Xbox
11: Xbox Series X|S (XSX)
12:WinGDK		必填
gameidstringPlayer Network 分配的游戏 ID必填
channelidint登录渠道 ID
1：WeChat
2：QQ
3：Guest
4：Facebook
5：GameCenter
6：GooglePlay
9：Twitter
10：Garena
14：LINE
15：Apple
19：VK
20：Xbox
21：Steam
24：Epic
26：Discord
27：PlayStation 5
30：DMM
32：SquareEnix
33：Supercell
35：Kakao
38：VNG
41：Nintendo Switch		必填
tsuintUnix 时间必填
sigstring用于验证请求的 hash 值，请联系 Player Network 助手了解详情必填
sourceint访问来源
0 或留空：客户端 SDK
1：游戏后台		必填
sdk_versionstring携带的 SDK 版本
默认为空		客户端调用都需要带上
seqstring透明传输的参数
包含在返回的 JSON 字符串中，用于异步调用
只允许英文字母、数字和下划线（_）
默认为空		选填

请求示例​

curl -sS -X POST -H 'Content-Type: application/json' 'https://test.intlgame.com/v2/auth/verify_login?channelid=11&gameid=11&os=5&source=0&ts=1590481177&sdk_version=2.0&sig=9d3a9c7257d445ae0b1ff31a4d69c16e' 
-d '{"openid":"5574152457717116678","token":"1d9d1dea1c094be1ddfeb9ef48f7f0aad72b5a8b"}'

Token 长度​

在不同的场景下 token 的长度不同，目前 token 的长度不会超过 2048 bytes。由于后续规划 token 长度上限可能会发生变化，建议您的应用支持长度可变的 token。

回包及错误描述​

通过 HTTP 协议发送数据以后，获取状态码。如果状态码不为 200，则表示请求失败，直接打印结果查看问题。如果状态码为 200，则表示请求正常，即可以获取 HTTP 返回的内容，将 JSON 字符串解析成数组。

回包格式如下：

{
    "ret": 0,
    "msg": "user is logged in"
}
  • ret = 0，表示请求成功。可以解析相关返回字段信息。
  • ret != 0，表示请求逻辑失败。msg 里面有具体错误信息，没有其它字段返回。

完整的 ret 值列表，请参见 后台错误码。