微端游戏接口文档
数填写说明:
Y—->必须,N—->非必须
商户密钥(key):
商户密钥是通讯中用户数据加密及签名验证过程中所需的加密钥匙,该钥匙由双方接口技术人员约定。
接口前缀:
测试地址:https://XXX.xcloudgame.com/
正式地址:https://XXX.xcloudgame.com/
必须实现接口
同步接口
游戏登录接口
游戏注册接口
注:其他接口实现视联运商各自的需求而定
接口调用地址及接口关系:
同步接口(post方式)(https://域名/Api/syn) 向游戏数据库写入ID信息,以标志用户身份。
游戏登陆接口(post方式)(https://域名/Api/login)
游戏注册接口(post方式)(https://域名/Api/registrar)
返回值类型:
json
同步接口参数
既将用户数据从商户导入到游戏数据库,后续所用到的user必须和此user一致。
| 参数名 | 参数类型 | 最大长度 | 是否必填 | 描述 |
|---|---|---|---|---|
| uid | int | 11 | Y | 用户编号 |
| String | 50 | Y | 用户email(用户账号) | |
| password | String | 50 | Y | 用户密码 |
| time | int | 11 | Y | 用户注册时间 unix 时间戳(以秒为单位) |
| sing | String | 50 | Y | 数字签名:双方需要验证此信息的正确性 |
sign=md5($uid $email $password $time $key)
Status:200、100、101……108、109、(见返回值代码说明)
登录接口参数
| 参数名 | 参数类型 | 最大长度 | 是否必填 | 描述 |
|---|---|---|---|---|
| String | 50 | Y | 用户email | |
| password | String | 50 | Y | 用户密码 |
| sid | int | 11 | Y | 游戏服ID |
| time | int | 11 | Y | 用户登录时间 unix 时间戳(以秒为单位) |
| sing | String | 50 | Y | 数字签名:双方需要验证此信息的正确性 |
sign=md5($email $password $sid $time $key)
Status:200、100、101……108、109、(见返回值代码说明)
注册接口参数
| 参数名 | 参数类型 | 最大长度 | 是否必填 | 描述 |
|---|---|---|---|---|
| String | 50 | Y | 用户email | |
| password | String | 50 | Y | 用户密码 |
| time | int | 11 | Y | 用户注册时间 unix 时间戳(以秒为单位) |
| sing | String | 50 | Y | 数字签名:双方需要验证此信息的正确性 |
sing=md5( $email $password $time $key)
Status:200、100、101……108、109、(见返回值代码说明)
错误码
| 错误码 | 描述 |
|---|---|
| 100 | email信息不全 |
| 101 | password信息不完整 |
| 102 | email 已被注册 |
| 103 | password 错误 |
| 104 | time信息不完整 |
| 105 | sign信息不完整或信息有误 |
| 106 | 数据库操作失败 |
| 107 | 分区信息不全 |
| 108 | Key错误 |
| 109 | sid 有误 |