手機(jī)流量 - API文檔

手機(jī)流量充值接口文檔下載：  點(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)碼流量充值、賬戶余額查詢、充值狀態(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)入【獎(jiǎng)勵(lì)營(yíng)銷】模塊，在產(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://f.ihuyi.com/v2

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

返回值(JSON格式)：

3、余額查詢

3.1 接口描述

通過(guò)接口可以方便的查詢你的賬戶獎(jiǎng)勵(lì)營(yíng)銷余額。

3.2 請(qǐng)求地址

http://f.ihuyi.com/v2

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

返回值(JSON格式)：

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

4.1 接口描述

用戶先提供數(shù)據(jù)接收地址，然后綁定到互億無(wú)線系統(tǒng)后臺(tái)，平臺(tái)會(huì)以POST方式實(shí)時(shí)的將回執(zhí)信息推送到此地址。

4.2 推送參數(shù)

注意：充值狀態(tài)查詢和充值狀態(tài)推送兩種?式只能選擇其中?種。成功接收請(qǐng)輸出字符"success" （不包含引號(hào)）結(jié)束推送，處理失敗可輸出任意字符，最多推送5次。

5、訂單信息查詢

5.1 接口描述

通過(guò)接口可以方便的查詢你的賬戶充值訂單狀態(tài)。

5.2 請(qǐng)求地址

http://f.ihuyi.com/v2

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

返回值(JSON格式)：

6、充值狀態(tài)批量查詢

6.1 接口描述

通過(guò)接口可以方便的批量查詢你的賬戶充值訂單狀態(tài)。

6.2 請(qǐng)求地址

http://f.ihuyi.com/v2

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

返回值(JSON格式)：

注意：狀態(tài)獲取后服務(wù)器則會(huì)刪除狀態(tài)，充值狀態(tài)查詢和充值狀態(tài)推送兩種?式只能選擇其中?種。

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

7.1 接口描述

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

7.2 請(qǐng)求地址

http://f.ihuyi.com/v2

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

返回值(JSON格式)：

8、狀態(tài)碼

9、簽名說(shuō)明

需要把a(bǔ)pikey（登錄系統(tǒng)獲?。┓诺揭灻逆I值對(duì)中，按照asc排序鍵值對(duì)參數(shù)名排序，拼接鍵值對(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));  

GET方式地址如下：

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

PHP充值代碼DEMO：

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