创蓝-流链平台接口说明

创蓝-流链平台接口说明
一、流量充值接口
此接口，是商户通过流链平台充值手机流量的访问接口，信息如下：
接口地址：（请根据用户角色选择正确的地址，否则无法提交订单）
渠道：http://api.liulian253.com/api/sendDistributor
直客：http://api.liulian253.com/api/send
请求方式：
POST/GET均可
请求参数：
参数名 类型 说明
account String 平台账号
timestamp String(10) 时间戳，1970/1/1到现在的秒数，10位
noncestr String 随机字符串（数字或字母组合），建议不超过7位
mobile String(11) 待充值的手机号码，11位数字
package String(5) 流量包代码（5位，例：00010）
signature String 签名摘要，算法如下：
SHA1(account=x&ext_id=x&mobile=x&noncestr=x&package=x&timestamp=x&key=x)  详见附件2
ext_id String 商户系统内部的订单号,保证唯一性，不可有"/&"
返回结果：
参数名 类型 说明
code String 返回码：请求成功为0；错误码详见附件1
desc String 订单提交信息描述
ext_id String 商户系统内部的订单号
示例：{"code":"0","desc":"发送成功","ext_id":"30201605302153191"}


二、异步通知接口
此接口，是充值流量后，流链平台将充值结果推送到商户提供的URL，商户接收请求。注意：商户接收回调后，请返回字符串：”OK”。信息如下：
推送内容：
参数名 类型 说明
code String 返回码：请求成功为0；错误码详见附件1
desc String 订单提交信息描述
ext_id String 商户系统内部的订单号
示例：{ "code" : "0", "desc" :"充值成功", "ext_id" : "20150602103851791397" }

三、订单状态查询
此接口，是商户查询订单状态的访问接口。信息如下：
接口地址：http://api.liulian253.com/api/checkStatus
请求方式：
POST/GET均可
请求参数：
参数名 类型 说明
account String 平台账号
ext_id String 商户系统内部的订单号 ，多个以半角","分隔
signature String 签名摘要，算法如下：SHA1(account=x&ext_id=x&key=x)
返回结果：
参数名 类型 说明
code String 订单状态 0充值成功；错误码详见附件1
desc String 订单提交信息描述
ext_id String 商户系统内部的订单号
示例：[{"code":"000099","desc":"充值中","ext_id":"30201605302153191"},
{"code":"000099","desc":"充值中","ext_id":"30201605302153191"}]
参数为空或没有数据:[]

流量包代码
移动 联通 电信
流量包 流量包代码 流量包 流量包代码 流量包 流量包代码
10M 00010 20M 00020 10M 00010
30M 00030 50M 00050 30M 00030
70M 00070 100M 00100 100M 00100
150M 00150 200M 00200 200M 00200
500M 00500 500M 00500 500M 00500
1G 01024 1G 01024
2G 02048 　 　 　 　
3G 03072 　 　 　 　
4G 04096 　 　 　 　
6G 06144 　 　
11G 11264 　 　


附件1错误码
错误码 说明
000001 参数不规范
000002 时间戳超时
000003 账号不存在或未启用
000004 手机号码格式不正确
000005 签名错误
000006 流量产品不存在
000007 余额不足
000008 号段不存在
000009 客户单号(ext_id)重复
000010 对应网关不存在或未开启
000012 对应协议不存在或未开启
000014 发送失败
000015 充值失败
000016 该IP地址与绑定IP地址不符
000020 创建订单错误
000030 通道维护中，订单缓存
000031 通道超时中，订单缓存
000090 未知错误
000099 充值中


附件2 签名算法

第一步：根据参数名称，升序拼接参数；最后拼接key（密码key由流链平台提供）。
string= account=test&ext_id=144610588611&mobile=18500818888&noncestr=abcdef&package=00020&timestamp=1446105886&key=XXX
第二步：用SHA1算法对拼接的字符串进行加密，生成签名。
signature = SHA1 (string)

示例：
签名前字符串：
account=chuanglan&ext_id=chuanglan1484546418718&mobile=18117351643&noncestr=aaabbb&package=00010&timestamp=1484546418&key=123456

签名后字符串：
4bd8d0692baeb743ba6af0b1bf295e46b2a98537

对接必看
1 如使用post请求以上接口,请使用x-www-form-urlencoded方式,不是流方式的参数(与浏览器表单一致,php语言出现此问题的居多) 我方异步通知是采用json流的方式, 请使用流的方式接收参数

2 时间戳超时, 我们的时间戳参数是10位的, 有些语言获取的是13位,需要除以1000, 如果依然超时, 请把服务器时间与北京时间同步

3 ext_id是客户订单号,24小时之内同一个客户ext_id不允许重复,否则直接返回失败

4 签名中的key由我方提供,不参与参数的传递,只参与签名使用,不是登陆密码,是独立的网关密码

5 接入流程：首先调用流量充值接口,接口直接返回成功代表本次请求成功,并不代表充值成功,充值成功以异步回调结果为准, 也可以主动发起查询

6 签名sha1之后的字符串必须转换为小写