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