会员营销短信接口
- 请求地址:
- 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>