手機(jī)話費(fèi) - API文檔

手機(jī)話費(fèi)充值接口文檔下載：  點(diǎn)擊下載

1、概要

1.1 文檔說(shuō)明

本文檔主要提供給互億平臺(tái)的用戶對(duì)接接口的使用說(shuō)明，開(kāi)發(fā)者可以利用 ihuyi 提供的 HTTP 接口，調(diào)用 ihuyi 的手機(jī)話費(fèi)充值服務(wù)。

1.2 接口內(nèi)容

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

1.3 提交方式

GET / POST

1.4 加密方式

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

1.5 API ID / API KEY

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

2、單號(hào)碼充值

2.1 接口描述

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

2.2 請(qǐng)求地址

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

2.3 請(qǐng)求方式

GET / POST

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

x-www-form-urlencoded

2.5 請(qǐng)求參數(shù)

GET 方式請(qǐng)求示例：

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

返回值(JSON格式)

3、余額查詢

3.1 接口描述

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

3.2 請(qǐng)求地址

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

3.3 請(qǐng)求方式

GET / POST

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

x-www-form-urlencoded

3.5 請(qǐng)求參數(shù)

返回值(JSON格式)：

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

4.1 接口描述

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

4.2 推送參數(shù)

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

5、訂單信息查詢

5.1 接口描述

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

5.2 請(qǐng)求地址

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

5.3 請(qǐng)求方式

GET / POST

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

x-www-form-urlencoded

5.5 請(qǐng)求參數(shù)

返回值(JSON格式)：

6、獲取話費(fèi)包檔位

6.1 接口描述

通過(guò)接口可以方便的獲取手機(jī)話費(fèi)套餐檔位。

6.2 請(qǐng)求地址

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

6.3 請(qǐng)求方式

GET / POST

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

x-www-form-urlencoded

6.5 請(qǐng)求參數(shù)

返回值(JSON格式)：

7、狀態(tài)碼

8、簽名說(shuō)明

在生成簽名時(shí)，需要將接口請(qǐng)求參數(shù)中“參與驗(yàn)簽”一列中標(biāo)為“是”的參數(shù)，以及您賬戶的APIKEY(登錄系統(tǒng)獲取) 以鍵值對(duì)的形式拼接起來(lái)，并將參數(shù)名（鍵）按照 asc (升序)的方式排序，鍵值對(duì)字符串的參數(shù)名小寫(xiě)，再用 32 位 md5 加密。

注意：API ID請(qǐng)使用小寫(xiě)。

例如:

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：

http://xhl96.com/demo/marketing/hfphp.html