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

3o选五开奖结果