文字簡訊介面對接傳送簡訊後如何獲取狀態報告以及回覆報告

樂訊通雲通訊發表於2024-01-18

上篇文章為大家介紹了文字簡訊如何介面對接,今天我們們來詳細瞭解下文字簡訊介面對接傳送簡訊後如何獲取狀態報告以及回覆報告。


首先先給大家介紹下文字簡訊介面對接的使用場景


驗證碼簡訊

可用於驗證碼型別簡訊傳送,型別定義為:簡訊內容屬於使用者主動獲取,使用者需要得到,而不是引導消費型別,簡訊內容不帶有任何引導消費性質及促銷性質內容。

會員通知簡訊

可用於通知、應用型別簡訊傳送,簡訊內容不帶有任何引導消費性質及促銷性質內容。

會員營銷簡訊

可用於會員營銷、產品推廣、優惠告知、客戶關懷、生日祝福等場景。


文字簡訊-獲取狀態報告


此狀態報告儲存時間為72小時,請及時處理。單次最大返回個數為1000。

請求協議:http

請求方式:採用post方式提交請求

請求報文

action=sms&username=zhangsan&password=E10ADC3949BA59ABBE56E057F20F883E&rece=json&timestamp=636949832321055780&sign=96E79218965EB72C92A54

引數說明

引數名稱 是否必須 描述 示例
action 操作型別 (固定值)action=sms
username 賬戶名 username=zhangsan
password 賬戶密碼, 密碼必須MD5加密並且取32位大寫 password=E10ADC3949BA59ABBE56E057F20F883E
rece 返回型別json、xml,預設(json) rece=json
timestamp 時間戳, 13位時間戳,單位(毫秒) timestamp=636949832321055780
sign 簽名校驗 sign=96E79218965EB72C92A54

sign引數詳細說明

簽名由引數action,username,password,timestamp進行MD5加密組成

比如這些值拼接後為action=sms&username=zhangsan&password=E10ADC3949BA59ABBE56E057F20F883E&timestamp=636949832321055780,那麼就MD5加密這個引數字串得到結果後作為sign的值sign=96E79218965EB72C92A54

響應報文

引數名稱 描述 示例
statusbox 狀態包,無資料則返回空陣列 "statusbox":[]
status 返回狀態 "status": "10"
taskid 任務ID "taskid": "159135036852978cb"
mobile 接收手機號 "mobile": "13812345678"
receivetime 報告接收時間 "receivetime": "2020-06-05 17:53:17"
errorcode 錯誤碼 "errorcode": "DELIVRD"

JSON成功返回示例

{
    "statusbox":[
        {
            "taskid": "159135036852978cb",
            "status": "10",
            "mobile": "13812345678",
            "receivetime": "2020-06-05 17:53:17",
            "errorcode": "DELIVRD"
        }
    ]
}

JSON失敗返回示例

{
    "returnstatus":"error",
    "code":"-4",
    "remark":"賬戶密碼錯誤!"
}

XML成功返回示例

<?xml version="1.0" encoding="utf-8"?><returnsms>
  <statusbox>
    <taskid>159135031626323c8</taskid>
    <status>10</status>
    <mobile>17731234567</mobile>
    <receivetime>2020-06-05 17:51:25</receivetime>
    <errorcode>DELIVRD</errorcode>
  </statusbox>
</returnsms>

XML失敗返回示例

<?xml version="1.0" encoding="gb2312"?><returnsms>
  <returnstatus>error</returnstatus>
  <code>-4</code>
  <remark>賬戶密碼錯誤!</remark>
</returnsms>


文字簡訊-獲取回覆報告


此狀態報告儲存時間為120小時,請及時處理

請求協議:http

請求方式:採用post方式提交請求

請求報文

action=sms&username=zhangsan&password=E10ADC3949BA59ABBE56E057F20F883E&rece=json&timestamp=636949832321055780&sign=96E79218965EB72C92A54

引數說明

引數名稱 是否必須 描述 示例
action 操作型別 (固定值)action=sms
username 賬戶名 username=dashanghai
password 賬戶密碼, 密碼必須MD5加密並且取32位大寫 password=E10ADC3949BA59ABBE56E057F20F883E
rece 返回型別json、xml,預設(json) rece=json
timestamp 時間戳, 13位時間戳,單位(毫秒) timestamp=636949832321055780
sign 簽名校驗 sign=96E79218965EB72C92A54

sign引數詳細說明

簽名由引數action,username,password,timestamp進行MD5加密組成

比如這些值拼接後為action=sms&username=zhangsan&password=E10ADC3949BA59ABBE56E057F20F883E&timestamp=636949832321055780,那麼就MD5加密這個引數字串得到結果後作為sign的值sign=96E79218965EB72C92A54

響應報文

引數名稱 描述 示例
callbox 無資料則返回空陣列 "callbox":[]
taskid 任務ID "taskid": "159135036852978cb"
mobile 接收手機號 "mobile": "13812345678"
receivetime 報告接收時間 "receivetime": "2020-06-05 17:53:17"

JSON成功返回示例

{
    "callbox":[
        {
            "taskid": "159135036852978cb",
            "mobile": "13812345678",
            "content": "T",
            "receivetime": "2020-06-05 17:53:17"
        }
    ]
}

JSON失敗返回示例

{
    "returnstatus":"error",
    "code":"-4",
    "remark":"賬戶密碼錯誤!"
}

XML成功返回示例

<?xml version="1.0" encoding="utf-8"?><returnsms>
  <callbox>
    <taskid>159135031626323c8</taskid>
    <content>T</content>
    <mobile>13812345678</mobile>
    <receivetime>2020-06-05 17:51:25</receivetime>
  </callbox>
</returnsms>

XML失敗返回示例

<?xml version="1.0" encoding="gb2312"?><returnsms>
  <returnstatus>error</returnstatus>
  <code>-4</code>
  <remark>賬戶密碼錯誤!</remark>
</returnsms>


來自 “ ITPUB部落格 ” ,連結:https://blog.itpub.net/70036589/viewspace-3004268/,如需轉載,請註明出處,否則將追究法律責任。

相關文章