<sup id="6k0c4"></sup>
<ul id="6k0c4"></ul>
  • <ul id="6k0c4"></ul>
  • <ul id="6k0c4"></ul>
  • <strike id="6k0c4"><menu id="6k0c4"></menu></strike>

    互億通信 · API接口文檔

    國(guó)際短信 - API文檔


    國(guó)際短信接口文檔下載:  點(diǎn)擊下載

    1、概要

    1.1 文檔說(shuō)明

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

    1.2 接口內(nèi)容

    本文檔包含國(guó)際短信發(fā)送、余額查詢(xún)、發(fā)送回執(zhí)推送等。

    1.3 提交方式

    GET / POST

    1.4 加密方式

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

    1.5 API ID / API KEY

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

    1.6 國(guó)際驗(yàn)證碼模版

    國(guó)際驗(yàn)證碼模板是對(duì)您將要發(fā)送的短信進(jìn)行相似性提取后的內(nèi)容。舉個(gè)例子,
    A用戶(hù)在您平臺(tái)注冊(cè)會(huì)員,需要發(fā)送一條短信,內(nèi)容如下:

    您好,您的驗(yàn)證碼是:666666

    同時(shí),B用戶(hù)也在您的平臺(tái)注冊(cè)會(huì)員,發(fā)送了如下短信:

    您好,您的驗(yàn)證碼是:888888

    我們提取相似度以后,可以制作以下短信模板:

    您好,您的驗(yàn)證碼是:【變量】

    其中,變量是可變的,可以是 數(shù)字、字母、漢字。

    2、國(guó)際短信發(fā)送

    2.1 接口描述

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

    2.2 請(qǐng)求地址

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

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

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

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

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

    2.4 響應(yīng)示例

    示例(成功)

     2 提交成功 60495654 
    

    示例(失敗)

     405 用戶(hù)名或密碼不正確 0 
    

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

    code msg
    0 提交失敗
    2 提交成功
    400 非法ip訪(fǎng)問(wèn)
    401 帳號(hào)不能為空
    402 密碼不能為空
    403 手機(jī)號(hào)碼不能為空
    4030 手機(jī)號(hào)碼已被列入黑名單
    404 短信內(nèi)容不能為空
    405 用戶(hù)名或密碼不正確
    4050 賬號(hào)被凍結(jié)
    4051 剩余條數(shù)不足
    4052 訪(fǎng)問(wèn)ip與備案ip不符
    406 手機(jī)格式不正確
    407 短信內(nèi)容含有敏感字符
    4071 沒(méi)有提交備案模板
    4072 你提交過(guò)來(lái)短信內(nèi)容必須與報(bào)備過(guò)的模板格式相匹配
    40722 變量?jī)?nèi)容超過(guò)指的的長(zhǎng)度
    4073 短信內(nèi)容超出長(zhǎng)度限制
    408 您的帳戶(hù)疑被惡意利用,已被自動(dòng)凍結(jié),如有疑問(wèn)請(qǐng)與客服聯(lián)系。

    2.6 請(qǐng)求示例

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

    3、余額查詢(xún)

    3.1 接口描述

    通過(guò)接口可以方便的查詢(xún)你的賬戶(hù)國(guó)際驗(yàn)證碼剩余條數(shù)。

    3.2 請(qǐng)求地址

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

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

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

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

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

    3.4 響應(yīng)示例

    示例(成功)

     2 提交成功 0 

    示例(失敗)

     405 用戶(hù)名或密碼不正確 0 

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

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

    3.6 GET請(qǐng)求示例

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

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

    4.1 接口描述

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

    4.2 推送參數(shù)

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

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

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

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

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

    例如:

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

    注意:因?yàn)槎绦艃?nèi)容會(huì)包含unicode字符,所以字符編碼統(tǒng)一為UTF-8。

    查詢(xún)剩余條數(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

    互億通信短信平臺(tái)支持簽名認(rèn)證

    為短信加上您的公司品牌和LOGO

    更高信任度,更高轉(zhuǎn)化率

    在線(xiàn)咨詢(xún)
    電話(huà)咨詢(xún)

    服務(wù)熱線(xiàn):

    4008 808 898

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

    4008 808 898

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

    4008 808 898

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

    4008 808 898

    主站蜘蛛池模板: 国产精品免费精品自在线观看| 精品无码久久久久国产| 亚洲七七久久精品中文国产| 精品久久久久久国产91| 色一乱一伦一图一区二区精品 | 久久精品国产亚洲沈樵| 亚洲精品中文字幕乱码三区| 国产精品成人一区二区| 国产成人精品日本亚洲直接| 亚洲欧洲精品无码AV| 久久se这里只有精品| 91精品国产麻豆国产自产在线| 久久狠狠高潮亚洲精品| 亚洲精品无码久久毛片| 精品国产欧美一区二区三区成人 | 久久久久人妻精品一区| 欧美日韩国产精品系列| 国产亚洲精品a在线观看| 午夜精品美女写真福利| 国产精品专区第二| 国产精品久久久久久吹潮| 日本VA欧美VA精品发布| 亚洲精品无码激情AV| 亚洲精品乱码久久久久久蜜桃| 男女男精品网站免费观看| 国产一区麻豆剧传媒果冻精品| 免费91麻豆精品国产自产在线观看| 国产成人精品久久免费动漫 | 国産精品久久久久久久| 国产精品成人精品久久久| 99久久精品免费| 国产精品无码素人福利不卡| 国产精品激情综合久久| 99久久国产综合精品成人影院| 国产亚洲精品a在线观看app| 好属妞这里只有精品久久| 国产精品青草久久久久婷婷| 成人精品视频在线观看| 精品午夜久久福利大片| 日本精品久久久久中文字幕8| 久久精品国产精品青草|