手机流量 - API文档

手机流量充值接口文档下载：  点击下载

1、概要

1.1 文档说明

本文档主要提供给互亿平台的用户对接接口的使用说明，开发者可以利用 ihuyi 提供的 HTTP 接口，调用 ihuyi 的手机话费流量服务。

1.2 接口内容

本文档包含单号码流量充值、账户余额查询、充值状态推送、订单信息查询、充值状态批量查询等。

1.3 提交方式

GET / POST

1.4 加密方式

1、采用HTTPS协议提交请求
2、通过MD5动态签名方式加密

1.5 API ID / API KEY

登录用户中心，进入【奖励营销】模块，在产品总揽页面右上角。

2、单号码充值

2.1 接口描述

通过POST、 GET 方式进行短信提交，数据编码采用utf-8格式，24小时全天发送。

2.2 请求地址

http://f.ihuyi.com/v2

2.3 请求参数

返回值(JSON格式)：

3、余额查询

3.1 接口描述

通过接口可以方便的查询你的账户奖励营销余额。

3.2 请求地址

http://f.ihuyi.com/v2

3.3 请求参数

返回值(JSON格式)：

4、充值状态推送

4.1 接口描述

用户先提供数据接收地址，然后绑定到互亿无线系统后台，平台会以POST方式实时的将回执信息推送到此地址。

4.2 推送参数

注意：充值状态查询和充值状态推送两种⽅式只能选择其中⼀种。成功接收请输出字符"success" （不包含引号）结束推送，处理失败可输出任意字符，最多推送5次。

5、订单信息查询

5.1 接口描述

通过接口可以方便的查询你的账户充值订单状态。

5.2 请求地址

http://f.ihuyi.com/v2

5.3 请求参数

返回值(JSON格式)：

6、充值状态批量查询

6.1 接口描述

通过接口可以方便的批量查询你的账户充值订单状态。

6.2 请求地址

http://f.ihuyi.com/v2

6.3 请求参数

返回值(JSON格式)：

注意：状态获取后服务器则会删除状态，充值状态查询和充值状态推送两种⽅式只能选择其中⼀种。

7、获取话费包档位

7.1 接口描述

通过接口可以方便的获取手机话费套餐档位。

7.2 请求地址

http://f.ihuyi.com/v2

7.3 请求参数

返回值(JSON格式)：

8、状态码

9、签名说明

需要把apikey（登录系统获取）放到要签名的键值对中，按照asc排序键值对参数名排序，拼接键值对字符串（参数名⼩写），再⽤32位md5加密

注意：API ID请使用小写。

例如:

sign=md5(aaaa=aaaa&bbbb=bbbb&cccc=cccc&dddd=dddd) 

PHP充值签名代码如下:

$sign = 
md5(sprintf("apikey=%s&mobile=%s&orderid=%s&package=%s×tamp=%s&username=%s", 
        $apikey, 
        $mobile,
        $orderid,
        $package, 
        date("YmdHis"), 
        $username));  

GET方式地址如下：

http://f.ihuyi.com/v2?action=recharge&username=testname&mobile=13800000000&orderid=2016061210101010000&package=10×tamp=20160612123001&sign=e08ecdcedac8f9e07b1727e1005b8d32 

PHP充值代码DEMO：

https://www.ihuyi.com/demo/marketing/llphp.html