首頁 > 開發者中心 > HTTPS API > 會員營銷短信接口
會員營銷短信接口
- 請求地址:
- http://客戶端地址/sms.aspx?action=send
- 請求方式:
- POST
- 編碼格式:
- UTF-8
- 響應格式:
- JSON,XML
- 請求包頭:
- Content-type:application/x-www-form-urlencoded
請求參數說明
| 參數名稱 | 類型 | 約束 | 說明 |
|---|---|---|---|
| accountSid | String | 必選 | 開發者主賬號ID(ACCOUNT SID)。由32個英文字母和阿拉伯數字組成的開發者賬號唯一標識符。 |
| smsContent | String | 必選 | 短信內容。(短信簽名+短信內容。如:【今信科技】您的優惠券就快過期啦!不想白白浪費,就快來使用吧!戳: m.jinxinkeji.cn 使用!回TD退訂。) |
| to | String | 必選 | 短信接收端手機號碼集合。用英文逗號分開,每批發送的手機號數量不得超過50000個。 |
| portNumber | String | 可選 | 平臺分配給開發者的端口號,暫不支持。 |
| timestamp | String | 必選 | 時間戳。當前系統時間(24小時制),格式"yyyyMMddHHmmss"。時間戳有效時間為5分鐘。 |
| sig | String | 必選 | 簽名。MD5(ACCOUNT SID + AUTH TOKEN + timestamp)。共32位(小寫)。
注意:MD5中的內容不包含”+”號。 |
| respDataType | String | 可選 | 響應數據類型,JSON 或 XML 格式。默認為JSON。 |
請求實例
url:
http://客戶端地址/sms.aspx?action=send
post數據:
accountSid=a14f6bfd43ce44c9b019de57f4e2de4b&smsContent=【今信科技】您的優惠券就快過期啦!不想白白浪費,就快來使用吧!戳: m.jinxinkeji.cn 使用!回TD退訂。&to=13896543210,13965893652,13698568547,18569533265×tamp=20150821100312&sig=a14f6bfd43ue44c9b019du57f4e2ee4r&respDataType=JSON
返回參數說明
| 參數名稱 | 類型 | 約束 | 說明 |
|---|---|---|---|
| respCode | String | 必選 | 請求狀態碼,取值00000(成功: 此步響應只表明客戶的短信請求發送成功,不表明短信通道已經發送短信成功。) 具體可參照《附:返回狀態碼列表》 |
| failCount | String | 必選 | 表示會員營銷短信發送失敗的條數。 |
| failList | String | 可選 | 失敗列表,包含失敗號碼、失敗原因。 |
| smsId | String | 必選 | 短信標識符。一個由32個字符組成的短信唯一標識符。 |
返回示例
JSON返回包體
{
"respCode":"00000",
"failCount":"2",
"failList":
[
{
"phone":"13896543210",
"respCode":"00111"
},
{
"phone":"13965893652",
"respCode":"00111"
}
],
"smsId":"913945fec0204b1e94baa75a5c013f59"
}
XML響應實例
<?xml version="1.0" encoding="utf-8"?>
<result>
<respCode>00000</respCode>
<smsId>913945fec0204b1e94baa75a5c013f59</smsId>
<failCount>2</failCount>
<failList>
<phone>13896543210</phone>
<respCode>00111</respCode>
</failList>
<failList>
<phone>13965893652</phone>
<respCode>00111</respCode>
</failList>
</result>