验证码通知短信接口
- 请求地址:
- 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>