<rp id="vce0m"></rp>
  • <button id="vce0m"><acronym id="vce0m"></acronym></button>
    <th id="vce0m"><track id="vce0m"><video id="vce0m"></video></track></th><dd id="vce0m"><pre id="vce0m"></pre></dd><tbody id="vce0m"></tbody>

      <rp id="vce0m"></rp>

      <th id="vce0m"><big id="vce0m"><video id="vce0m"></video></big></th>
        API文檔

        模板短信接口請求方式

        1 短信發送接口

        1.1 業務流程說明

        1.2 Base URL

        模板短信API引用的地址有Base URL。
        生產環境的Base URL: https://sms.dahancloud.com/

        1.3 統一請求包頭

        URL格式: /API/sendMessage?sig={SigParameter}
        在URL格式中 {}內的內容表示為參數。
        屬性 類型 約束 說明
        SigParameter String 必選 REST API 驗證參數,生成規則如下
        1.使用MD5加密(賬戶Id + 賬戶授權令牌 + 時間戳)。其中賬戶Id和賬戶授權令牌根據url的驗證級別對應主賬戶。 時間戳是當前系統時間,格式"yyyyMMddHHmmss"。時間戳有效時間為24小時,如:20170904112030
        2.SigParameter參數需要大寫,如不能寫成sig=abcdefg而應該寫成sig=ABCDEFG

        1.4 HTTP標準包頭字段

        Accept:application/json;
        Content-Type:application/json;charset=utf-8;
        Content-Length:256;
        Authorization:

        屬性 類型 約束 說明
        Accept String 必選 客戶端響應接收數據格式:application/json
        Content-Type String 必選 類型:application/json;charset=utf-8
        Content-Length String 必選 Content-Length
        Authorization String 必選 驗證信息,生成規則詳見下方說明
        1.使用Base64編碼(賬戶Id + 冒號 + 時間戳)其中賬戶Id根據url的驗證級別對應主賬戶
        2.冒號為英文冒號
        3.時間戳是當前系統時間,格式"yyyyMMddHHmmss",需與SigParameter中時間戳相同。

        1.5 請求包體

        屬性 類型 約束 說明
        to String 必選 短信接收端手機號碼集合,用英文逗號分開,每批發送的手機號數量不得超過500個
        appId String 必選 應用Id
        templateId String 必選 模板Id
        datas String 必選 內容數據,用于替換模板中{序號}


        1.5.1 JSON請求示例

        POST /API/sendMessage?sig=C1F20E7A9733CE94F680C70A1DBABCDE HTTP/1.1
        Host: https://sms.dahancloud.com/
        content-length: 139
        Accept:application/json;
        Content-Type:application/json;charset=utf-8;
        Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDExNTABCDE=
        {"to":"13955821xxx,15064001xxx,13874771xxx","appId":
        "ff8080813fc70a7b013fc7231232xxxx","templateId":"1","datas":["替換內容","替換內容"]}

        1.6 響應

        此步響應只表明客戶的短信請求發送成功,不表明短信通道已經發送短信成功。
        屬性 類型 約束 說明
        statusCode String 必選 請求狀態碼,取值000000(成功)
        smsMessageSid String 必選 短信唯一標識符
        dateCreated String 必選 短信的創建時間

        1.6.1 JSON響應示例

        HTTP/1.1 200 OK
        Content-Length: 641
        {"statusCode":"000000","templateSMS":{"dateCreated":"20170904112030",
        "smsMessageSid":" ff8080813c373cab013c94b0f0512xxx"}}

        1.7 判斷發送失敗,重發

        對響應解析后,statusCode為"000000"表示請求發送成功。statusCode不是"000000",表示請求發送失敗,客戶服務端可以根據自己的邏輯進行重發或者其他處理。

        2 短信狀態報告接口

        2.1 請求方式

        POST請求(僅支持POST請求)


        2.2 請求參數

        2.2.1 請求完整路徑    (注:此接口最多只能獲取三天的狀態報告,如需獲取更多狀態報告,請聯系平臺客服人員)

        https://report.dahancloud.com/sms/report


        2.2.1 HTTP標準包頭字段

        Accept:application/json;
        Content-Type:application/json;charset=utf-8;
        Content-Length:256;
        Authorization:” ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDN2M6MxNTABCDE= ”
        sig:”c1f20e7a9733ce94f680c70a1dbabcde”
        					
        屬性 類型 說明
        sig String 1、使用MD5加密(賬戶Id + 賬戶授權令牌 + 時間戳)。其中賬戶Id和賬戶授權令牌根據url的驗證級別對應主賬戶。 時間戳是當前系統時間,格式"yyyyMMddHHmmss"。
        2、時間戳有效時間為24小時,如:20170904112030
        Authorization String 1、使用Base64編碼(賬戶Id + 冒號 + 時間戳)其中賬戶Id根據url的驗證級別對應主賬戶
        2、冒號為英文冒號
        3、時間戳是當前系統時間,格式"yyyyMMddHHmmss",需與sig中時間戳相同。

        2.3 返回內容

        2.3.1 提交響應數據格式

        {
        	"code":"DH:0000",
        	"datas":
        		[{
        			"msgId ":"502f34ea6eae47288bd0917c46d83003",
        			"phone ":"155**********",
        			"status ":0,
        			"time ":"2018-06-27 18:32:00"
        		}],
        	"msg":"請求成功"
        }
        
        						

        2.3.2 字段解釋

        屬性 類型 說明
        code String 請求狀態碼
        msg String 請求狀態碼對應描述
        datas phone String 下行手機號碼
        status String 短信發送狀態
        time String 狀態報告時間
        msgId String 短信編號id

        妈妈丝袜