手機話費 - API文檔

手機話費充值接口文檔下載：  點擊下載

1、概要

1.1 文檔說明

本文檔主要提供給互億平臺的用戶對接接口的使用說明，開發(fā)者可以利用 ihuyi 提供的 HTTP 接口，調(diào)用 ihuyi 的手機話費充值服務。

1.2 接口內(nèi)容

本文檔包含單號碼話費充值、賬戶余額查詢、充值狀態(tài)推送、訂單信息查詢、充值狀態(tài)批量查詢等。

1.3 提交方式

GET / POST

1.4 加密方式

1、采用HTTPS協(xié)議提交請求
2、通過MD5動態(tài)簽名方式加密

1.5 API ID / API KEY

登錄用戶中心，進入【數(shù)字權(quán)益】模塊，在產(chǎn)品總攬頁面右上角。

2、單號碼充值

2.1 接口描述

通過POST、 GET 方式進行短信提交，數(shù)據(jù)編碼采用utf-8格式，24小時全天發(fā)送。

2.2 請求地址

http(s)://api.ihuyi.com/f/phone?action=recharge

2.3 請求方式

GET / POST

2.4 請求內(nèi)容類型（Content-Type）

x-www-form-urlencoded

2.5 請求參數(shù)

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 接口描述

通過接口可以方便的查詢你的賬戶數(shù)字權(quán)益余額。

3.2 請求地址

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

3.3 請求方式

GET / POST

3.4 請求內(nèi)容類型（Content-Type）

x-www-form-urlencoded

3.5 請求參數(shù)

返回值(JSON格式)：

4、充值狀態(tài)推送

4.1 接口描述

我們會以POST 方式推送到您配置的Url，Content-Type為multipart/form-data。

4.2 推送參數(shù)

注意：成功接收請輸出字符"success" （不包含引號）結(jié)束推送，處理失敗可輸出任意字符，最多推送5次。

5、訂單信息查詢

5.1 接口描述

通過接口可以方便的查詢你的賬戶充值訂單狀態(tài)，僅支持查詢7天內(nèi)的訂單數(shù)據(jù)。

5.2 請求地址

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

5.3 請求方式

GET / POST

5.4 請求內(nèi)容類型（Content-Type）

x-www-form-urlencoded

5.5 請求參數(shù)

返回值(JSON格式)：

6、獲取話費包檔位

6.1 接口描述

通過接口可以方便的獲取手機話費套餐檔位。

6.2 請求地址

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

6.3 請求方式

GET / POST

6.4 請求內(nèi)容類型（Content-Type）

x-www-form-urlencoded

6.5 請求參數(shù)

返回值(JSON格式)：

7、狀態(tài)碼

8、簽名說明

在生成簽名時，需要將接口請求參數(shù)中“參與驗簽”一列中標為“是”的參數(shù)，以及您賬戶的APIKEY(登錄系統(tǒng)獲取) 以鍵值對的形式拼接起來，并將參數(shù)名（鍵）按照 asc (升序)的方式排序，鍵值對字符串的參數(shù)名小寫，再用 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&timestamp=%s&username=%s", 
        $apikey, 
        $mobile,
        $orderid,
        $package, 
        date("YmdHis"), 
        $username));  

PHP充值代碼DEMO：

http://m.422ajvm.cn/demo/marketing/hfphp.html