手機流量 - 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

登錄用戶中心，進入【獎勵營銷】模塊，在產(chǎn)品總攬頁面右上角。

2、單號碼充值

2.1 接口描述

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

2.2 請求地址

http://f.ihuyi.com/v2

2.3 請求參數(shù)

返回值(JSON格式)：

3、余額查詢

3.1 接口描述

通過接口可以方便的查詢你的賬戶獎勵營銷余額。

3.2 請求地址

http://f.ihuyi.com/v2

3.3 請求參數(shù)

返回值(JSON格式)：

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

4.1 接口描述

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

4.2 推送參數(shù)

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

5、訂單信息查詢

5.1 接口描述

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

5.2 請求地址

http://f.ihuyi.com/v2

5.3 請求參數(shù)

返回值(JSON格式)：

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

6.1 接口描述

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

6.2 請求地址

http://f.ihuyi.com/v2

6.3 請求參數(shù)

返回值(JSON格式)：

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

7、獲取話費包檔位

7.1 接口描述

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

7.2 請求地址

http://f.ihuyi.com/v2

7.3 請求參數(shù)

返回值(JSON格式)：

8、狀態(tài)碼

9、簽名說明

需要把apikey（登錄系統(tǒng)獲?。┓诺揭灻逆I值對中，按照asc排序鍵值對參數(shù)名排序，拼接鍵值對字符串（參數(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×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://m.422ajvm.cn/demo/marketing/llphp.html