国际短信
国际短信

 

群发短信

说明:

       支持 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 get 调用方式:

http://Ip:20003/sendsms?account=***&password=***&smstype=0&numbers=10010,1008611&content=***&mmstitle=mmstitle_text

http post 调用方式:

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]]}