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