验证码通知短信接口
- 请求地址:
- http://客户端地址/sms.aspx?action=send
- 请求方式:
- POST
- 编码格式:
- UTF-8 gbk
- 响应格式:
- JSON,XML
- 请求包头:
- Content-type:application/x-www-form-urlencoded
请求参数说明
| 参数名称 | 类型 | 约束 | 说明 |
|---|---|---|---|
| Userid | String | 必选 | 企业ID(ACCOUNT SID)。由32个英文字母和阿拉伯数字组成的开发者账号唯一标识符。 |
| action | String | 必选 | 设置为固定的:send |
| account | String | 必选 | 用户帐号,由系统管理员发放。 |
| password | String | 必选 | 用户账号对应的密码 |
| Content | String | 必选 | 短信内容。(短信签名+短信内容。如【今信科技】您的验证码是345678,30分钟输入有效。) |
| mobile | String | 必选 | 短信接收端手机号码集合。用英文逗号分开,每批发送的手机号数量不得超过100个。 |
| extno | String | 可选 | 平台分配给开发者的端口号。 |
| sendtime | String | 必选 | 时间戳。当前系统时间(24小时制),格式"yyyyMMddHHmmss"。时间戳有效时间为5分钟。 |
请求实例
url:
http://客户端地址/sms.aspx?action=send
post数据:
action=send&userid=12&account=账号&password=密码&mobile=15023239810,13527576163&content=内容&sendTime=&extno=
返回参数说明
| 参数名称 | 类型 | 约束 | 说明 |
|---|---|---|---|
| respCode | String | 必选 | 请求状态码,取值00000(成功: 此步响应只表明客户的短信请求发送成功,不表明短信通道已经发送短信成功。) 具体可参照《附:返回状态码列表》 |
| failCount | String | 必选 | 表示验证码通知短信发送失败的条数。 |
| failList | String | 可选 | 失败列表,包含失败号码、失败原因。 |
| smsId | String | 必选 | 短信标识符。一个由32个字符组成的短信唯一标识符。 |
返回示例
XML返回包体:
<?xml version="1.0" encoding="utf-8"?>
<returnsms>
<returnsms>status</returnsms>
<message>message;/message;
<remainpoint>remainpoint</remainpoint>
<successCounts>successCounts</successCounts>
<taskID>
<phone>13896543210 </phone>
<returnsms>00111 </returnsms>
</taskID>
</returnsms>