功能示例 / Example

語音接口

開發(fā)流程 / Process

  • 注冊(cè)開發(fā)者賬號(hào)

  • 免費(fèi)測(cè)試語音發(fā)送

  • 購買語音套餐

  • 快速調(diào)用接口

  • 完成開發(fā)

接口介紹 / Introduction

  • 輕松開發(fā)

    標(biāo)準(zhǔn)HTTP(S)協(xié)議,提供完善的技術(shù)開發(fā)文檔

  • 超高并發(fā)

    分布式集群架構(gòu),多點(diǎn)部署,安全穩(wěn)定

  • 專業(yè)服務(wù)

    專業(yè)技術(shù)團(tuán)隊(duì)答疑解難,24小時(shí)運(yùn)維監(jiān)控

應(yīng)用場(chǎng)景 / Scenes

  • 登錄注冊(cè)

    適用于網(wǎng)站/APP的語音驗(yàn)證碼登錄、賬號(hào)注冊(cè)場(chǎng)景,保障企業(yè)賬號(hào)體系安全

  • 支付確認(rèn)

    適用于線上支付環(huán)節(jié),有效確保用戶支付安全

  • 密碼找回

    適用于網(wǎng)站/APP的身份校驗(yàn)場(chǎng)景,簡(jiǎn)單高效地維護(hù)企業(yè)賬號(hào)體系安全

  • 概要
  • 語音發(fā)送
  • 余額查詢
  • 發(fā)送回執(zhí)推送
  • 生成動(dòng)態(tài)密碼方式

1、概要

1.1 文檔說明

本文檔主要提供給互億平臺(tái)的用戶對(duì)接接口的使用說明,開發(fā)者可以利用 ihuyi 提供的 HTTP 接口,調(diào)用 ihuyi 的語音驗(yàn)證碼服務(wù)。

1.2 接口內(nèi)容

本文檔包含語音發(fā)送、余額查詢、發(fā)送回執(zhí)推送等。

1.3 提交方式

GET / POST

1.4 加密方式

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

1.5 API ID / API KEY

登錄用戶中心,進(jìn)入【語音驗(yàn)證碼】模塊,在【產(chǎn)品總攬】頁面右上角,如下圖所示:

2、語音發(fā)送

2.1 接口描述

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

2.2 請(qǐng)求地址

http://api.voice.ihuyi.com/webservice/voice.php?method=Submit

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

參數(shù)名稱 參數(shù)值描述 必填
account APIID(請(qǐng)登錄用戶中心【語音驗(yàn)證碼】-【產(chǎn)品縱覽】查看)
password 1、APIKEY(請(qǐng)登錄用戶中心【語音驗(yàn)證碼】-【產(chǎn)品縱覽】查看)
2、動(dòng)態(tài)密碼(生成動(dòng)態(tài)密碼方式請(qǐng)看該文檔末尾的說明)
mobile 接收手機(jī)號(hào)碼,只能提交1個(gè)號(hào)碼
content 驗(yàn)證碼(4-6位數(shù)字)
time Unix時(shí)間戳(10位整型數(shù)字,當(dāng)使用動(dòng)態(tài)密碼方式時(shí)為必填)
format 返回格式(可選值為:xml或json,系統(tǒng)默認(rèn)為xml)

用戶通過http 或 https提交發(fā)送短信請(qǐng)求到服務(wù)器后,服務(wù)器會(huì)返回一串xml格式的字符串,SubmitResult結(jié)構(gòu)說明如下:

參數(shù)名稱 類型 描述
code int 返回值為2時(shí),表示提交成功
smsid string 當(dāng)提交成功后,此字段為流水號(hào),否則為0
msg string 提交結(jié)果描述

2.4 響應(yīng)示例

示例(成功)


 2 提交成功 60495654 

示例(失?。?/p>


 405 用戶名或密碼不正確 0 

2.5 響應(yīng)參數(shù)

code msg
0 提交失敗
2 提交成功
400 非法ip訪問
401 帳號(hào)不能為空
402 密碼不能為空
403 手機(jī)號(hào)碼不能為空
4030 手機(jī)號(hào)碼已被列入黑名單
404 語音內(nèi)容不能為空
405 用戶名或密碼不正確
4050 賬號(hào)被凍結(jié)
4051 剩余條數(shù)不足
4052 訪問ip與備案ip不符
406 手機(jī)格式不正確
407 短信內(nèi)容含有敏感字符
4070 語音驗(yàn)證碼內(nèi)容必須為4-6位數(shù)字
408 您的帳戶疑被惡意利用,已被自動(dòng)凍結(jié),如有疑問請(qǐng)與客服聯(lián)系。

2.6 請(qǐng)求示例

http://api.voice.ihuyi.com/webservice/voice.php?method=Submit&account=APIID&password=APIKEY&mobile=手機(jī)號(hào)碼&content=1125

3、余額查詢

3.1 接口描述

通過接口可以方便的查詢你的賬戶語音驗(yàn)證碼剩余條數(shù)。

3.2 請(qǐng)求地址

http://api.voice.ihuyi.com/webservice/voice.php?method=GetNum

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

參數(shù)名稱 參數(shù)值描述 是否必填
account APIID(請(qǐng)登錄用戶中心【語音驗(yàn)證碼】-【產(chǎn)品縱覽】查看)
password 1、APIKEY(請(qǐng)登錄用戶中心【語音驗(yàn)證碼】-【產(chǎn)品縱覽】查看)
2、動(dòng)態(tài)密碼(生成動(dòng)態(tài)密碼方式請(qǐng)看該文檔末尾的說明)
time Unix時(shí)間戳(10位整型數(shù)字,當(dāng)使用動(dòng)態(tài)密碼方式時(shí)為必填)
format 返回格式(可選值為:xml或json,系統(tǒng)默認(rèn)為xml)

用戶通過http 或 https提交帳戶余額查詢請(qǐng)求到服務(wù)器后,服務(wù)器會(huì)返回一串xml格式的字符串,GetNumResult結(jié)構(gòu)說明如下:

參數(shù)名稱 類型 描述
code int 狀態(tài)返回值
msg string 查詢結(jié)果描述
num string 剩余數(shù)量

3.4 響應(yīng)示例

示例(成功)


 2 查詢成功 856 

示例(失?。?/p>


 405 用戶名或密碼不正確 0 

3.5 響應(yīng)參數(shù)

code msg
2 查詢成功
400 非法ip訪問
401 帳號(hào)不能為空
402 密碼不能為空
405 用戶名或密碼不正確
4050 賬號(hào)被凍結(jié)

3.6 GET請(qǐng)求示例

http://api.voice.ihuyi.com/webservice/voice.php?method=GetNum&account=APIID&password=APIKEY 

4、發(fā)送回執(zhí)推送

4.1 接口描述

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

4.2 推送參數(shù)

參數(shù)名稱 參數(shù)值描述
code 狀態(tài)值(2成功 其他為失敗)
msg 回執(zhí)狀態(tài)說明
mobilephone 手機(jī)號(hào)碼
task_id 流水號(hào)(對(duì)應(yīng)提交時(shí)返回的task_id)
report_time 回執(zhí)時(shí)間

注意: 成功接收請(qǐng)輸出字符 "success" (不包含引號(hào))結(jié)束推送,否則以接收失敗處理。每個(gè)回執(zhí)最多推送3次。每次間隔疊加60秒。

5、生成動(dòng)態(tài)密碼方式

以PHP為例,提交語音驗(yàn)證碼的生成方式:

$time = time();
$password = md5($account.$apikey.$mobile.$content.$time);

例如:

APIID: test
APIKEY:1q784322ba1d9bb88d50cf5cdfd89k7d
手機(jī)號(hào):138xxxxxxxx
內(nèi)容:1125
time:1451544941
結(jié)果:$password=md5('test1q784322ba1d9bb88d50cf5cdfd89k7d138xxxxxxxx11251451544941');

查詢剩余條數(shù)的生成方式:

$time = time();
$password = md5($account.$apikey.$time);

例如:

APIID: test
APIKEY:1q784322ba1d9bb88d50cf5cdfd89k7d
手機(jī)號(hào):138xxxxxxxx
time:1451544941
結(jié)果:$password=md5('test1q784322ba1d9bb88d50cf5cdfd89k7d1451544941');

Unix時(shí)間戳參考地址:http://tool.chinaz.com/Tools/unixtime.aspx

語音發(fā)送錯(cuò)誤碼參照:

code msg
0 提交失敗
2 提交成功
400 非法ip訪問
401 帳號(hào)不能為空
402 密碼不能為空
403 手機(jī)號(hào)碼不能為空
4030 手機(jī)號(hào)碼已被列入黑名單
404 語音內(nèi)容不能為空
405 用戶名或密碼不正確
4050 賬號(hào)被凍結(jié)
4051 剩余條數(shù)不足
4052 訪問ip與備案ip不符
406 手機(jī)格式不正確
407 短信內(nèi)容含有敏感字符
4070 語音驗(yàn)證碼內(nèi)容必須為4-6位數(shù)字
408 您的帳戶疑被惡意利用,已被自動(dòng)凍結(jié),如有疑問請(qǐng)與客服聯(lián)系。

余額查詢錯(cuò)誤碼參照:

code msg
2 查詢成功
400 非法ip訪問
401 帳號(hào)不能為空
402 密碼不能為空
405 用戶名或密碼不正確
4050 賬號(hào)被凍結(jié)

代碼示例

語言 詳情鏈接
PHP http://422ajvm.cn/demo/voice/php.html
JAVA http://422ajvm.cn/demo/voice/java.html
ASP http://422ajvm.cn/demo/voice/asp.html
ASP.NET(C#) http://422ajvm.cn/demo/voice/aspx.html
JSP http://422ajvm.cn/demo/voice/jsp.html
C http://422ajvm.cn/demo/voice/c.html
C++ http://422ajvm.cn/demo/voice/cpp.html
GO http://422ajvm.cn/demo/voice/go.html
PYTHON http://422ajvm.cn/demo/voice/python.html
SHELL http://422ajvm.cn/demo/voice/shell.html
VB6 http://422ajvm.cn/demo/voice/vb6.html

常見問題

目錄 詳情鏈接
模板審核標(biāo)準(zhǔn) http://422ajvm.cn/faq/qianmingguifan.html
簽名審核標(biāo)準(zhǔn) http://422ajvm.cn/faq/qianmingshenhebiaozhun.html
支付問題 http://422ajvm.cn/faq/pay.html
賬號(hào)問題 http://422ajvm.cn/faq/account.html
產(chǎn)品問題 http://422ajvm.cn/faq/voice.html

客戶服務(wù)

內(nèi)容 聯(lián)系方式
400熱線 400-880-8898
聯(lián)系電話 021-5169 8929
郵箱 service@ihuyi.com
郵政編碼 201203

市場(chǎng)合作/渠道代理

內(nèi)容 聯(lián)系方式
聯(lián)系電話 15902129325
郵箱 linsn@ihuyi.com

技術(shù)支持

內(nèi)容 聯(lián)系方式
聯(lián)系電話 4008 808 898
郵箱 support@ihuyi.com

公司地址

內(nèi)容 聯(lián)系方式
上??偣?/td> 上海市浦東新區(qū)納賢路800號(hào)A座401
南京分公司 南京市秦淮區(qū)瞻園路19號(hào)
成都分公司 中國(guó)(四川)自由貿(mào)易試驗(yàn)區(qū)成都高新區(qū)天府街69號(hào)

熱門接口

在線咨詢
電話咨詢

服務(wù)熱線:

4008 808 898

服務(wù)熱線(工作時(shí)間):

4008 808 898

業(yè)務(wù)咨詢(非工作時(shí)間):

售后咨詢(非工作時(shí)間):

驗(yàn)證碼已發(fā)送到您的手機(jī),請(qǐng)查收!

輸入驗(yàn)證碼后,點(diǎn)擊“開通體驗(yàn)賬戶”按鈕可立即開通體驗(yàn)賬戶。

收不到短信驗(yàn)證碼?
互億無線不提供接碼服務(wù),接碼用戶請(qǐng)勿點(diǎn)擊開通按鈕。
×