api接口说明书

《api接口说明书》由会员上传分享，免费在线阅读，更多相关内容在教育资源-天天文库。

1、深圳市创盾网络科技有限公司API接口说明书版本更新内容时间3.1增加短信群发功能2016.9.263.0签名生成方式2013.11.122.0参数注释2013.07.241.1验证服务器ip2013.02.081.0创建文档2012.12.21概述什么情况下需要API？假如你公司希望自己的网站、软件产品或是微信公众号等终端拥有手机话费、QQ业务、游戏充值等业务，那么你公司可以调用速度达API充值接口进行二次开发。速度达用户可免费对接API充值接口，但需要具备一定的编程能力，比如java、php、asp等。只需根据

2、本文档提示自行对接即可。假如你方没有聘用技术人员，可申请由速度达官方技术人员代为对接，但会收取一定的技术费用，详情请加微信号cd866321/21深圳市创盾网络科技有限公司目录1、API介绍31.1通讯协议31.2充值流程31.3权限版本（power）41.4版本号（ver）41.5时间戳（timestamp）41.6订单号（orderid）41.7数字签名（sign和signkey）42、API调用说明52.1在线充值52.1.1IOS充值62.2订单回调62.3商品进价表72.4渠道商信息92.5游戏区服表1

3、02.6用户余额112.7手机号码归属地122.8系统时间戳132.9销售软件132.10激活码开通软件142.11下级用户列表142.12财务记录152.13订单记录172.14转账182.15短信群发193、注意事项194、通用状态码205、附录205.1全国省份直辖市ID对照表205.2IOS充值产品ID表2121/21深圳市创盾网络科技有限公司1、API介绍1.1通讯协议1.联系速度达技术人员（微信号：cd8663）获取密钥KEY，及接口地址。2.接口采用GET/POST方式提交请求3.返回XML或JSO

4、N，传入参数增加format=xml或者format=json1.2充值流程一次请求保存在本地1请求时间戳系统启动，获取服务器时间戳[api/sys_now]2请求产品表、渠道表、区服表获取充值产品表[api/product]、渠道表[api/product_channel]、区服表[api/product_area](该步骤执行一次存储在本地即可)多次请求3选择产品根据所要充值的业务需要先调用本地数据(游戏充值需调用区服表、手机充值需调用渠道表并请求归属地[api/sys_phone])，然后选择产品。4提交订

5、单将充值订单提交到充值接口[api/recharge]。其中productid就是api/product的i；area的值就是手机号码归属地对应的值（见附录）如果是游戏则是api/product_area的i。5回调订单状态回调订单状态[api/status]。21/21深圳市创盾网络科技有限公司1.3权限版本（power）13代表普及版15代表专业版16代表豪华版17代表旗舰版1.4版本号（ver）固定值等于3，每个api接口必须要传的参数。1.5时间戳（timestamp）时间戳是自1970年1月1日（00:

6、00:00GMT）至当前时间的总秒数。时间戳的有效期为10分钟。如果您的本机时间为准确的“北京时间”，可使用本机时间戳，否则可通过接口获取当前服务器的时间戳，以它为基本，开始自动计时。时间戳是很多接口必须要传的一个参数。时间戳的目的是为了使一个接口产生的URL在10分钟后失效，提高安全性。1.6订单号（orderid）为防止重复提交，很多接口都必须传入订单号。建议按如下方法生成：取系统当前时间按年月日小时分钟秒毫秒，再与用户编号用字母“v”相连。生成如：20131112170125156v1234561.7数字签

7、名（sign和signkey）sign以时间戳作为秘钥signkey以KEY值和时间戳作为秘钥如下请求为例，来说明signkey生成步骤http://***.sududa.com/api/recharge?count=1&orderid=1384243215449v9631&productid=1139×tamp=1384243215&to=13800138000&username=test4@sududa.com&ver=3&signkey=d38d6a9180d9d7791fb11f187813c1

8、05将除“signkey”外的所有参数按key进行字典升序排列，将接口名和排序后的参数(key=value)用&拼接起来。例如：/api/recharge?count=1&orderid=1384243215449v9631&productid=1139×tamp=1384243215&to=13800138000&username=test4@sududa.c