手机话费 - 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(s)://api.ihuyi.com/f/phone?action=recharge

2.3 请求方式

GET / POST

2.4 请求内容类型（Content-Type）

x-www-form-urlencoded

2.5 请求参数

GET 方式请求示例：

http://api.ihuyi.com/f/phone?action=recharge&username=testname&mobile=13800000000&orderid=xxxxxxxxx&package=10&timestamp=20161028120101&sign=e08ecdcedac8f9e07b1727e1005b8d32

返回值(JSON格式)

3、余额查询

3.1 接口描述

通过接口可以方便的查询你的账户数字权益余额。

3.2 请求地址

api.ihuyi.com/f/basic?action=getbalance

3.3 请求方式

GET / POST

3.4 请求内容类型（Content-Type）

x-www-form-urlencoded

3.5 请求参数

返回值(JSON格式)：

4、充值状态推送

4.1 接口描述

我们会以POST 方式推送到您配置的Url，Content-Type为multipart/form-data。

4.2 推送参数

注意：成功接收请输出字符"success" （不包含引号）结束推送，处理失败可输出任意字符，最多推送5次。

5、订单信息查询

5.1 接口描述

通过接口可以方便的查询你的账户充值订单状态，仅支持查询7天内的订单数据。

5.2 请求地址

api.ihuyi.com/f/phone?action=getorderinfo

5.3 请求方式

GET / POST

5.4 请求内容类型（Content-Type）

x-www-form-urlencoded

5.5 请求参数

返回值(JSON格式)：

6、获取话费包档位

6.1 接口描述

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

6.2 请求地址

api.ihuyi.com/f/phone?action=getpackages

6.3 请求方式

GET / POST

6.4 请求内容类型（Content-Type）

x-www-form-urlencoded

6.5 请求参数

返回值(JSON格式)：

7、状态码

8、签名说明

在生成签名时，需要将接口请求参数中“参与验签”一列中标为“是”的参数，以及您账户的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));  

PHP充值代码DEMO：

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