深圳市创盾网络科技有限公司
API接口说明书
版本 3.0 2.0 1.1 1.0 参数注释 验证服务器ip 创建文档 更新内容 签名生成方式 2013.11.12 2013.07.24 2013.02.08 2012.12.21 时间
1 / 20
深圳市创盾网络科技有限公司
目录
1、API介绍 ...................................................................................................................................... 3
1.1通讯协议............................................................................................................................. 3 1.2充值流程............................................................................................................................. 3 1.3权限版本 (power) ........................................................................................................ 3 1.4版本号 (ver) ................................................................................................................. 4 1.5时间戳 (timestamp) ..................................................................................................... 4 1.6订单号 (orderid) ........................................................................................................... 4 1.7数字签名(sign和signkey) ............................................................................................ 4 2、API调用说明 .............................................................................................................................. 5
2.1在线充值............................................................................................................................. 5 2.2订单回调............................................................................................................................. 7 2.3商品进价表 ......................................................................................................................... 7 2.4渠道商信息 ......................................................................................................................... 9 2.5游戏区服表 ....................................................................................................................... 11 2.6用户余额........................................................................................................................... 12 2.7手机号码归属地 ............................................................................................................... 12 2.8系统时间戳 ....................................................................................................................... 13 2.9销售软件........................................................................................................................... 13 2.10激活码开通软件 ............................................................................................................. 14 2.11下级用户列表 ................................................................................................................. 15 2.12财务记录......................................................................................................................... 16 2.13订单记录......................................................................................................................... 17 2.14转账 ................................................................................................................................ 19 3、注意事项................................................................................................................................... 19 4、通用状态码 ............................................................................................................................... 20 5、附录 .......................................................................................................................................... 20
5.1全国省份直辖市ID对照表 ............................................................................................. 20
2 / 20
深圳市创盾网络科技有限公司
1、API介绍
1.1通讯协议
1. 联系速度达技术(QQ:1551369420)获取密钥KEY,及接口地址。 2. 接口采用GET/POST方式提交请求
3. 返回XML或JSON,传入参数增加format=xml或者format=json
1.2充值流程
一次请求 保存在本地
1
请求时间戳
系统启动,获取服务器时间戳 [api/sys_now] 2
请求产品表、渠道表、区服表
获取充值产品表 [api/product]、渠道表
[api/product_channel]、区服表 [api/product_area](该步骤执行一次存储在本地即可) 3
选择产品
根据所要充值的业务需要先调用本地数据(游戏充值需调用区服表、手机充值需调用渠道表并请求归属地 [api/sys_phone]),然后选择产品。 4
提交订单
多次请求
将充值订单提交到充值接口 [api/recharge]。其中productid就是api/product的 i ;area的值就是手机号码归属地对应的值(见附录)如果是游戏则是api/product_area的i。 5
回调订单状态
回调订单状态 [api/status]。
1.3权限版本 (power)
13代表普及版 15代表专业版
3 / 20