说明:
支持 http get 方式来提交发送短信,get发送一次性最多100个号码,post方式一次性最多提交10000个号码。
查询到的数据(HTTP 消息的 body 段)是由一个或者多个字段组成的 JSON 格式字符串。
提交的结果数据(HTTP 消息的body 段)是由一个或者多个字段组成的JSON 格式字符串。
HTTP 头参数“Content-Type”的值为“application/json;charset=utf-8”
参数 |
说明 |
是否必填 |
类型 |
version |
协议版本号 |
否(默认 1.0) |
String |
account |
帐号 |
是 |
String |
password |
1、服务器不加密时,则为明文密码 2、服务器加密时,则为 MD5 密码Md5 值 = md5 ( 用户名+ 明文密码 +seq+time+协商key) 协商的key 由服务端提供 |
是 |
String |
seq |
序列号,每次请求递增,初始值为 1 |
服务器要求加 密时必填 |
Int |
time |
请求发起的时间戳 |
服务器要求加 密时必填 |
Int |
smstype |
短信类型(0:普通短信,1:彩信) |
否(默认 0) |
Int |
mmstitle |
彩 信 标 题 ( get 方 式 需 要 做 urlEncode) |
否 |
String |
sender |
发件人 |
否 |
String |
numbers |
短信接收号码,多个号码之间以英文 逗号分隔(get 最多 100 个,post 最多 10000 个) |
是 |
|
content |
发 送 内 容 ( get 方 式 需 要 做urlEncode) |
是 |
String 长度不能超过1024 |
sendtime |
定时发送时间(为空为立即发送) 比如:20171001123015,表示 2017 年 10 月 1 日 12 时 30 分 15 秒 |
否 |
String(14) |
http://Ip:20003/sendsms?account=***&password=***&smstype=0&numbers=10010,1008611&content=***&mmstitle=mmstitle_text
http://Ip:20003/sendsms body:{"account":"chenkc","password":"123456","content":"test","smstype":0,"mmstitle":"mms title decs","numbers":"123456"}
参数 |
说明 |
类型 |
status |
发送提交状态0:获取成功 -1:认证错误 -2:Ip 访问受限 -3:短信内容含有敏感字符 -4:短信内容为空 -5:短信内容过长 -6:不是模板的短信 -7:号码个数过多 -8:号码为空 -9:号码异常 -10:该通道余额不足,不能满足本次发送 -11:定时时间格式不对 -12:由于平台的原因,批量提交出错,请与管理员联系 -13;用户被锁定 |
INT |
success |
提交成功的次数 |
INT |
fail |
提交失败的个数 |
INT |
array |
提交短信成功的数组 数组中依次包含“号码、号码的发送结果查询 ID”,数据均为数字字符 |
|
备注:提交发送短信成功后,系统会给提供成功的号码生成一个 Id,以后客户可以根据这个 Id 来查询该短信的发送结果。
{"status":0, "success":2, "fail":0, "array":[[10010,1], [1008611,2]]}