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


    短信驗證碼/短信通知API接口文檔下載:  點擊下載

    1、概要

    1.1 文檔說明

    本文檔主要提供給億互通平臺的用戶對接接口的使用說明,開發者可以利用億互通平臺提供的 HTTP 接口,調用億互通平臺的短信驗證碼/通知服務。

    1.2 接口內容

    本文檔包含短信發送、余額查詢、發送回執推送、上行回復推送等。

    1.3 提交方式

    GET / POST

    1.4 加密方式

    1、采用HTTPS協議提交請求
    2、通過MD5動態簽名方式加密

    1.5 API ID / API KEY

    登錄用戶中心,進入【驗證碼通知短信】模塊,在產品總攬頁面右上角,如下圖所示:

    1.6 短信模版

    短信模板是對您將要發送的短信進行相似性提取后的內容。舉個例子,
    A用戶在您平臺注冊會員,需要發送一條短信,內容如下:

    您好,您的驗證碼是:666666

    同時,B用戶也在您的平臺注冊會員,發送了如下短信:

    您好,您的驗證碼是:888888

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

    您好,您的驗證碼是:【變量】

    其中,變量是可變的,可以是 數字、字母、漢字。

    注意:未付費用戶僅可使用默認短信模板,付費用戶可以通過左側導航【驗證碼通知短信】-【短信發送】-【簽名/模版管理】新增短信模板,運營商審核通過之后即可正式使用。

    1.7 短信簽名

    短信簽名是加在短信的開頭或結尾,在【】加上您的公司名稱或店鋪名稱的標識符,例如:【億互通】。 根據電信基礎運營商的規定,每條短信必須附加短信簽名,否則將無法正常發送。

    注意:未付費用戶僅可使用默認短信簽名【億互通】,付費用戶可以通過點擊左側導航【驗證碼通知短信】-【短信發送】-【簽名/模版管理】修改簽名,運營商審核通過之后即可正式使用。

    2、短信發送

    2.1 接口描述

    通過POST、 GET 方式進行短信提交,數據編碼采用utf-8格式,24小時全天發送。

    2.2 請求地址

    http://106.ihuyi.com/webservice/sms.php?method=Submit

    2.3 請求參數

    參數名稱 參數值描述 必填
    account APIID(請登錄用戶中心查看)
    password 1、APIKEY(32位字符串,可以登錄用戶中心查看)
    2、動態密碼(生成動態密碼方式請看該文檔末尾的說明)
    mobile 接收手機號碼,只能提交1個號碼
    content 短信內容(編碼格式為UTF-8,支持300個字的長短信,長短信按多條計費)
    例如:您的驗證碼是:1234。請不要把驗證碼泄露給其他人。
    time Unix時間戳(10位整型數字,當使用動態密碼方式時為必填)
    format 返回格式(可選值為:xml或json,系統默認為xml)

    用戶通過http 或 https提交發送短信請求到服務器后,服務器會返回一串xml格式的字符串,SubmitResult結構說明如下:

    參數名稱 類型 描述
    code int 返回值為2時,表示提交成功
    smsid string 當提交成功后,此字段為流水號,否則為0
    msg string 提交結果描述

    2.4 響應示例

    示例(成功)

    <?xml version="1.0" encoding="utf-8"?>
    <SubmitResult xmlns="106.ihuyi.com">
    <code>2</code>
    <msg>提交成功</msg>
    <smsid>14745625541233112231</smsid>
    </SubmitResult>
    

    示例(失?。?/p>

    <?xml version="1.0" encoding="utf-8"?>
    <SubmitResult xmlns="106.ihuyi.com">
    <code>405</code>
    <msg>用戶名或密碼不正確</msg>
    <smsid>0</smsid>
    </SubmitResult>
    

    2.5 響應參數

    code msg
    0 提交失敗
    2 提交成功
    400 非法ip訪問
    401 帳號不能為空
    402 密碼不能為空
    403 手機號碼不能為空
    4030 手機號碼已被列入黑名單
    404 語音通知內容不能為空
    405 用戶名或密碼不正確
    4050 賬號被凍結
    4051 剩余條數不足
    4052 訪問ip與備案ip不符
    406 手機格式不正確
    4071 沒有提交備案模板
    4072 你提交過來語音內容必須與報備過的模板格式相匹配
    40722 變量內容超過指的的長度
    4073 短信內容超出長度限制
    408 您的帳戶疑被惡意利用,已被自動凍結,如有疑問請與客服聯系。

    2.6 請求示例

    http://106.ihuyi.com/webservice/sms.php?method=Submit&account=APIID&password=APIKEY&mobile=手機號碼&content=您的驗證碼是:1234。請不要把驗證碼泄露給其他人。
    

    3、余額查詢

    3.1 接口描述

    通過接口可以方便的查詢你的賬戶驗證碼通知短信剩余條數。

    3.2 請求地址

    http://106.ihuyi.com/webservice/sms.php?method=GetNum

    3.3 請求參數

    參數名稱 參數值描述 是否必填
    account APIID(請登錄用戶中心查看)
    password 1、APIKEY(32位字符串,可以登錄用戶中心查看)
    2、動態密碼(生成動態密碼方式請看該文檔末尾的說明)
    time Unix時間戳(10位整型數字,當使用動態密碼方式時為必填)
    format 返回格式(可選值為:xml或json,系統默認為xml)

    用戶通過http 或 https提交帳戶余額查詢請求到服務器后,服務器會返回一串xml格式的字符串,GetNumResult結構說明如下:

    參數名稱 類型 描述
    code int 狀態返回值
    msg string 查詢結果描述
    num string 剩余數量

    3.4 響應示例

    示例(成功)

    <?xml version="1.0" encoding="utf-8"?>
    <GetNumResult xmlns="106.ihuyi.com">
    <code>2</code>
    <msg>查詢成功</msg>
    <smsid>856</smsid>
    </GetNumResult>

    示例(失敗)

    <?xml version="1.0" encoding="utf-8"?>
    <GetNumResult xmlns="106.ihuyi.com">
    <code>405</code>
    <msg>用戶名或密碼不正確</msg>
    <smsid>0</smsid>
    </GetNumResult>

    3.5 響應參數

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

    3.6 GET請求示例

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

    4、發送回執推送

    4.1 接口描述

    用戶先提供數據接收地址,然后綁定到億互通系統后臺,平臺會以POST方式實時的將回執信息推送到此地址。

    4.2 推送參數

    參數名稱 參數值描述
    mobilephone 手機號碼
    content 上行內容
    smsid 流水號(對應提交時返回的smsid)(僅作參考)
    reply_time 上行時間

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

    5、發送回執推送

    5.1 接口描述

    用戶先提供數據接收地址,然后綁定到億互通系統后臺,平臺會以POST方式實時的將回復信息推送到此地址。

    5.2 推送參數

    參數名稱 參數值描述
    code 狀態值(2成功 其他為失敗)
    msg 回執狀態說明
    mobilephone 手機號碼
    smsid 流水號(對應提交時返回的smsid)
    report_time 回執時間

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

    6、生成動態密碼方式

    以PHP為例,提交短信的生成方式:

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

    例如:

    APIID: test
    APIKEY:1q784322ba1d9bb88d50cf5cdfd89k7d
    手機號:138xxxxxxxx
    內容:您的驗證碼是:2546。請不要把驗證碼泄露給其他人。
    time:1451544941
    結果:$password=md5('test1q784322ba1d9bb88d50cf5cdfd89k7d138xxxxxxxx您的驗證碼是:2546。請不要把驗證碼泄露給其他人。1451544941');

    注意:因為短信內容會包含中文,所以字符編碼統一為UTF-8

    查詢剩余條數的生成方式:

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

    例如:

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

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

    現在注冊,即送新手專屬短信群發禮包

    感謝您選購億互通產品!
    為了能方便您管理訂單,請先登錄或注冊會員后再進行購買;
    系統會自動記錄您購買的產品,登錄會員中心后繼續購買流程即可。
    繼續
    在線咨詢
    電話咨詢

    服務熱線:

    4008 808 898

    服務熱線(工作時間):

    4008 808 898

    業務咨詢(非工作時間):

    4008 808 898

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

    4008 808 898

    主站蜘蛛池模板: 粉嫩精品美女国产在线观看| 亚洲国产小视频精品久久久三级| 99re久久精品国产首页2020| 国产精品无码一区二区在线 | 日韩精品无码一区二区三区不卡| 亚洲精品成人网久久久久久| 久久九九青青国产精品| 亚洲国产精品无码久久98| 精品多毛少妇人妻AV免费久久| 欧美在线精品一区二区三区| 午夜精品在线观看| 久久久久久久亚洲精品| 久久免费精品视频| 国语自产少妇精品视频| 久久se精品一区二区| 人妻少妇精品视中文字幕国语| 男女男精品网站免费观看| 国产精品99久久不卡| 香蕉久久夜色精品国产小说| 99久久久精品| 国产久热精品无码激情| 亚洲综合精品香蕉久久网| 992tv精品视频tv在线观看| 日本一区精品久久久久影院| 国内精品久久久久影院优| 日韩精品人妻系列无码专区| 亚洲欧美日韩国产成人精品影院| 久久精品国产亚洲Aⅴ蜜臀色欲| 国产精品无码DVD在线观看| 国产精品99爱免费视频| 国产精品九九九| 国产精品主播一区二区| 国产2021久久精品| 国产女人18毛片水真多18精品| 国产精品免费视频观看拍拍| 国产精品VIDEOSSEX久久发布| 国产成人毛片亚洲精品| 国产乱子伦精品无码专区| 精品国产成人国产在线观看| 久久精品无码一区二区app| 欧美日韩精品系列一区二区三区|