<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接口文檔

    國際短信 - API文檔


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

    1、概要

    1.1 文檔說明

    本文檔主要提供給互億平臺(tái)的用戶對接接口的使用說明,開發(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é)議提交請求
    2、通過MD5動(dòng)態(tài)簽名方式加密

    1.5 API ID / API KEY

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

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

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

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

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

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

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

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

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

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

    2.1 接口描述

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

    2.2 請求地址

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

    2.3 請求參數(shù)

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

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

    參數(shù)名稱 類型 描述
    code int 返回值為2時(shí),表示提交成功
    smsid string 當(dāng)提交成功后,此字段為流水號,否則為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 帳號不能為空
    402 密碼不能為空
    403 手機(jī)號碼不能為空
    4030 手機(jī)號碼已被列入黑名單
    404 短信內(nèi)容不能為空
    405 用戶名或密碼不正確
    4050 賬號被凍結(jié)
    4051 剩余條數(shù)不足
    4052 訪問ip與備案ip不符
    406 手機(jī)格式不正確
    407 短信內(nèi)容含有敏感字符
    4071 沒有提交備案模板
    4072 你提交過來短信內(nèi)容必須與報(bào)備過的模板格式相匹配
    40722 變量內(nèi)容超過指的的長度
    4073 短信內(nèi)容超出長度限制
    408 您的帳戶疑被惡意利用,已被自動(dòng)凍結(jié),如有疑問請與客服聯(lián)系。

    2.6 請求示例

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

    3、余額查詢

    3.1 接口描述

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

    3.2 請求地址

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

    3.3 請求參數(shù)

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

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

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

    3.4 響應(yīng)示例

    示例(成功)

     2 提交成功 0 

    示例(失敗)

     405 用戶名或密碼不正確 0 

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

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

    3.6 GET請求示例

    http://api.isms.ihuyi.com/webservice/isms.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ī)號碼
    ismsid 流水號(對應(yīng)提交時(shí)返回的ismsid)
    reply_time 回執(zhí)時(shí)間

    注意: 成功接收請輸出字符 "success" (不包含引號)結(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ī)號: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。

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

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

    例如:

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

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

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

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

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

    在線咨詢
    電話咨詢

    服務(wù)熱線:

    4008 808 898

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

    4008 808 898

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

    4008 808 898

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

    4008 808 898

    主站蜘蛛池模板: 国产国产精品人在线观看| 国产偷亚洲偷欧美偷精品| 国产精品国色综合久久 | 精品久久久久久无码人妻热| 国产成人精品视频播放| 精品在线免费观看| 98香蕉草草视频在线精品看| 国内精品久久久久久野外| 亚洲精品国产精品乱码不卡| 欧美精品人爱a欧美精品| 亚洲国产精品日韩专区AV| 久久久久久国产精品免费免费| 久久精品国产精品亚洲艾草网美妙| 欧美成人精品第一区二区三区| 久久精品国产亚洲麻豆| 久久99精品综合国产首页| 在线精品亚洲一区二区小说| 亚洲2022国产成人精品无码区| 中文字幕在线精品视频入口一区| 99精品国产成人一区二区| HEYZO无码综合国产精品| 四虎永久在线精品国产免费 | 国产VA免费精品高清在线| 国产精品99| 欧美亚洲精品中文字幕乱码免费高清| 久久精品这里热有精品| 奇米影视7777久久精品| 国产精品污视频| 久久亚洲精品中文字幕| 中文字幕精品亚洲无线码二区| 精品无码国产污污污免费网站国产 | 嫖妓丰满肥熟妇在线精品| 国产精品片在线观看手机版| 四虎成人欧美精品在永久在线| 国产成人精品免费视频网页大全| 久久精品国产亚洲AV香蕉| 精品精品国产高清a毛片| 国内精品久久久久久久涩爱| 国产日韩欧美精品| 999精品视频| 精品四虎免费观看国产高清午夜|