在线接口
一. 接口说明
-
接口例子:
http://api.gameurl.com/today_online.php?time=1312256449&serverid=1&flag=e89f29e5d0b811195c52832269d0e22b
接口地址由游戏方提供(格式可自定义),平台方只提供参数(接口例子的红色部分)
-
游戏合服后:
请确保原有请求一样可以获取到在线数据
如 2、3 服 合并到1服..请保证原来取2、3 服的链接一样可以获得合服后的数据,平台方不修改请求地址。
二. 参数说明
| 参数 | 说明 | 例子 | 备注 |
|---|---|---|---|
| time | UNIX时间戳 | 1499306159 | 建议做超时验证,同时加密的验证里面要该参数 |
| flag | 加密串 | e89f29e5d0b811195c52832269d0e22b | md5 ( time + 密钥 ) |
| serverid | 服务器id | 1 | 若有传serverid,则取对应服务器在线人数 若serverid为空,则取回所有服务器在线数据。 |
三. 返回值说明
| 返回值说明 | 返回值 | 备注 |
|---|---|---|
| 有传serverid返回值格式 | 1000|1200|400 | 当前在线人数 | 当日最高在线人数 | 当天最低在线人数 |
| serverid为空返回值格式 | [{"serverid":"1","online":"1000|1200|400"},{"serverid":"2","online":"1000|1200|400"}] |
返回所有区服在线数据 online字段格式为: 当前在线人数 | 当日最高在线人数 | 当天最低在线人数 |
| 提交参数不全 | -1 | |
| 验证失败 | -2 |
四. 接口测试
ERROR 403
当前状态为文档访问模式,不支持接口测试功能
相关权限开通,请联系4399相关技术人员