玄兵骑战 - 获取区服数据接口

文档修改记录

编码格式	密级
utf-8	公开

变更时间	修改记录	版本	修改人
2022-01-13	新建文档	1.0.0	蔡力文

应用场景

场景介绍

• 获取区服数据

接口协议阐述

请求方式

• Http GET

请求参数

参数	类型	是否必填	字段释义	示例
platform	string	是	平台标识	51
goods_sign	int	是	研发方使用的游戏区服id, 如1006	1006
date	string	是	日期	2022-01-13
time	int	是	请求unixtime时间戳， 10位整数，此时间只参与token的加密，判断接口请求时间是否过期，不参与数据的获取	1630143222
token	string	是	验证token, 32位小写字符串,加密方法见文档	573aa095fe89accbe9d8b44d5de3b187

特殊参数说明

a. token的加密算法

• 注意参与加密的字段，并不是所有的字段都参与加密
• 加密算法的PHP代码如下

// 加密规则，php代码示例：
$time = time();  //获取当前的unixtime时间戳
$sec_key = '';   //加密秘钥，双方约定，一般由平台方直接给出 
$token = strtolower(md5($platform.$goods_sign.$date.$sec_key));

注意：PHP语言中.(点)是字符串连接符，跟java语言中的+一样  

返回数据（response）

字段	类型	字段释义	示例
ret	int	是否成功	1=成功 0=失败
code	int	返回码	自定义
info	string	返回信息	自定义
data	array	返回数据	自定义

{
    "ret": 0,
    "code": 200,
    "info": "Success",
    "data": {
        "register_num": 1,
        "pay_num": 1,
        "pay_amount": 1,
        ...
    }
}