请求地址
名称 | 是否必须 | 示例值 | 说明 |
---|---|---|---|
请求地址 | UTF-8 | http://dc.28inter.com/sms.aspx | 如果服务器不支持解析,请联系技术人员进行协助处理! |
名称 | 是否必须 | 示例值 | 描述 |
---|---|---|---|
action | 必须 | 固定设置为:send | 任务命令为:发送任务命令 |
account | 必须 | 28inter | 注册或者系统管理员分配获取;登陆账号 |
password | 必须 | 123456 | 注册或者系统管理员分配获取;登陆密码 |
userid | 必须 | 1001 | 注册或者系统管理员分配获取,账户ID |
mobile | 必须 | 13000000000,13000000001 | 短信接收号码。支持单个或多个手机号码,传入号码为11位手机号码,不能加0或+86。群发短信需传入多个号码,以英文逗号分隔,示例:13000000000,13000000001 |
content | 必须 | 【创信信息】您的验证码是:123456 | 发送短信的内容,整体做urlencode.短信签名的格式为:【签名】放在内容的最前方。 示范:【创信信息】您本次注册的验证码是:888888, 其中签名可根据自己公司的名称或简称自定义,字数为2-8字,不可以是纯数字、电话号码或者网址,不可以是无意义的签名,比如【大家好】,【哈哈哈】,【提示】,【测试】等 正确示例:【创信信息】、【京东】、【百度】、【工商银行】 错误示例:【你好】、【通知】、【测试一下】、【哈哈哈】、【123123】 |
rt | 可选 | json | 返回值格式,默认为xml |
例如:http://dc.28inter.com/sms.aspx?action=send&userid=12&account=acc&password=pass&mobile=13568813957&content=【创信信息】验证码:123(utf8 urlencode编码)
响应实例
响应实例-xml |
---|
<xml version="1.0" encoding="utf-8"> <returnsms> <returnstatus>status</returnstatus> ---------- 返回状态值:成功返回Success 失败返回:Faild <message>message</message> ---------- 返回信息 <remainpoint> remainpoint</remainpoint> ---------- 返回余额 <taskID>taskID</taskID> ----------- 返回本次任务的序列ID <successCounts>successCounts</successCounts> --成功短信数:当成功后返回提交成功短信数 </returnsms> |
响应实例-json |
---|
{"ReturnStatus":"success","Message":"ok","RemainPoint":0,"TaskID":0,"SuccessCounts":0} |
响应参数
名称 | 含义 | 示例值 | 描述 |
---|---|---|---|
returnstatus | 调用结果 | success | 调用结果:success为成功,faild为失败 |
message | 调用信息 | OK | 调用成功返回OK,失败显示失败原因,具体原因见下表 |
remainpoint | 账户余额 | 100 | 账户余额 |
taskID | 任务序号 | 100001 | 每次任务对应唯一的任务id |
successCounts | 号码个数 | 1 | 发送号码的个数 |
返回信息
示例值 | 描述 |
---|---|
OK | 提交成功 |
用户名或密码不能为空 | 提交的用户名或密码为空 |
发送内容包含sql注入字符 | 包含sql注入字符 |
用户名或密码错误 | 用户名或密码错误 |
余额不足 | 短信余额不足 |