`
创蓝253
  • 浏览: 18220 次
  • 性别: Icon_minigender_1
  • 来自: 上海
文章分类
社区版块
存档分类
最新评论

创蓝-流链平台接口说明

 
阅读更多
创蓝-流链平台接口说明
一、流量充值接口
此接口,是商户通过流链平台充值手机流量的访问接口,信息如下:
接口地址:(请根据用户角色选择正确的地址,否则无法提交订单)
渠道: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之后的字符串必须转换为小写
分享到:
评论

相关推荐

    创蓝短信接口包

    创蓝短信接口包是一款专为开发者设计的通讯工具,它主要提供的是短信服务,特别是用于验证码的发送。这款产品以其高效、稳定和专业的特性,在IT行业内广受好评。"5秒必到"的承诺意味着该服务能够确保短信在极短的...

    创蓝短信接口

    创蓝短信接口是一种广泛应用于移动通信领域的服务,它允许开发者通过API调用来发送短信验证码、通知消息或营销信息。在互联网应用中,这种接口对于身份验证、账户安全、客户服务以及市场营销等方面都至关重要。创蓝...

    创蓝短信发送验证码校验示例

    - 创蓝短信平台提供了一个HTTP API接口,开发者可以通过调用这个接口来发送短信验证码。通常,这个接口会要求提供手机号码、验证码内容以及一些特定的API密钥或签名。 2. **PHP HTTP请求库**: - 要与创蓝短信...

    java版创蓝短信接入demo

    创蓝是一家提供短信服务的公司,其提供的API接口可以让开发者便捷地将短信功能集成到自己的应用程序中。本篇文章将深入讲解如何在Java环境下实现创蓝短信的接入,并通过提供的`ChuangLanSmsDemo`进行示例解析。 ...

    创蓝短信发送类.rar

    创蓝短信平台提供了这样的接口,让开发者能够方便地在自己的应用中集成短信发送功能。通常,这类接口会包括验证码发送、通知消息发送等多种服务。 2. **调用流程**: - 注册并获取API密钥:首先,开发者需要在创蓝...

    Java调取创蓝253短信验证码的实现代码

    在Java开发中,有时我们需要集成外部服务来发送短信验证码,比如使用创蓝253这样的第三方短信服务平台。本文将详细讲解如何使用Java调用创蓝253的短信接口API来实现短信验证码的发送功能。 首先,创蓝253提供了一个...

    C# 开发(创蓝253)手机短信验证码接口的实例

    在本文中,我们将深入探讨如何使用C#语言与创蓝253的API接口进行集成,以便实现手机短信验证码的发送功能。创蓝253是一家提供短信服务的平台,其API接口允许开发者轻松地向指定手机号码发送验证码,从而在用户注册、...

    java接入创蓝253短信验证码的实例讲解

    4. 等待创蓝253短信平台的响应,并处理相应的结果。 结论 Java接入创蓝253短信验证码实例讲解提供了一个完整的短信验证码发送示例。在实际应用中,我们可以根据需要修改和扩展该示例,以满足不同的业务需求。本文...

    PHP短信接口demo

    创蓝253是一个提供短信服务的PaaS平台,允许开发者通过API接口进行短信的发送、接收和状态报告。 在开始使用该接口之前,你需要完成以下步骤: 1. 访问`https://zz.253.com/site/login.html`并登录,以获取API账号...

    短信接口demo

    创蓝作为知名的短信服务提供商,其短信接口为开发者提供了便捷的接入方式,以实现快速发送短信的功能。 首先,我们要了解短信接口的基本原理。短信接口通常是一个HTTP(S) API,开发者通过向指定URL发送请求,携带...

    短信接口代码

    在IT行业中,短信接口代码是实现应用程序与短信服务提供商之间通信的关键部分,它允许系统向用户发送验证码、通知或其他信息。下面将详细讲解短信接口代码的相关知识点,包括接口设计、短信拆分、手机号码处理以及...

    2020年短信供应商近20个维度对比20200806.xlsx

    2020年短信供应商近20个维度对比20200806,主要对比了阿里大鱼、创蓝253、大汉三通、亿美软通、腾讯云等多个平台

    云EC电商系统 v1.2.4.zip

    支持阿里短信、腾讯短信、创蓝短信等多个接口 物流查询,批量打印快递单和发货单,运费计算设置 销售统计、排行榜、会员统计等 拥有限时抢购(秒杀)、分销、优惠券和拼团等丰富的营销工具 云EC系统安装基本要求...

    chuanglan253-go:chuanglan-demo-go

    go参数填写说明 //请登录zz.253.com获取API账号、密码以及短信发送的URL params["account"] = "" //创蓝API账号 params["password"] = "" //创蓝API密码 params["phone"] = "18721755342" //手机号码 //设置...

    chuanglan253

    创蓝(Chuanglan)是中国的一家知名短信服务商,提供了多种API接口供开发者集成。 2. **API**:API(Application Programming Interface)是软件之间的接口,允许不同应用之间进行数据交换和功能调用。在本案例中,...

    smsFactory.zip

    《短信发送工厂——集成阿里云、创蓝及亚马逊等多平台解决方案》 在现代通信领域,短信服务扮演着至关重要的角色,尤其在验证码发送、营销推广以及客户服务等方面。"smsFactory.zip"是一个专为实现这一功能而设计的...

    easy-sms:一款满足你的多种发送需求的短信发送组件

    253云通讯(创蓝) 融云 天毅无线 腾讯云 SMS 阿凡达数据 华为云 网易云信 云之讯 凯信通 七牛云 UE35.net Ucloud 短信宝 Tiniyo 摩杜云 融合云(助通) 蜘蛛云 环境需求 PHP >= 5.6 安装 $ composer require ...

    实现短信发送

    2. **获取API文档**:服务提供商通常会提供详细的API文档,说明如何调用他们的服务。例如,创蓝的API文档会包含请求格式、参数设置、错误码等信息。 3. **构建请求**:在Java中,你可以使用HttpURLConnection或者...

    云EC电商系统 v1.2.1

    支持阿里短信、腾讯短信、创蓝短信等多个接口 物流查询,批量打印快递单和发货单,运费计算设置 销售统计、排行榜、会员统计等 拥有限时抢购(秒杀)、分销、优惠券和拼团等丰富的营销工具 云EC系统安装基本要求 1...

Global site tag (gtag.js) - Google Analytics