<th id="p55v1"></th>
        
        
        <button id="p55v1"><acronym id="p55v1"><u id="p55v1"></u></acronym></button>
      1. <em id="p55v1"><acronym id="p55v1"></acronym></em>
        <dd id="p55v1"></dd>

          <form id="p55v1"><tr id="p55v1"><cite id="p55v1"></cite></tr></form>
          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

          妈妈丝袜