您的位置:首页 >  接口中心 > 短信接口说明
  短信接口说明
 

1. 请求

(1) 求地址:

https://u.smsyun.cc/sms-partner/access/{用户帐号}/sendsms

注意:为了确保数据隐私和安全,用户需要通过Https Post方式请求,消息格式:json表达式。

(2) Https标准包头字段:

Accept:application/json;

Content-Type:application/json;charset=utf-8;

(3) 体:

属性

类型

约束

clientid

String

必选

帐号,6位,

如:a00012,b00012

password

String

必选

密码,8-12位,MD5加密后32位,写,

如:1bbd886460827015e5d605ed44252251

mobile

String

必选

发送手机号码,

国内短信不要加前缀,国际短信号码前须带相应的国家区号,如日本:0081,

支持多号码,号码之间用英文逗号隔开,最多100个。

国内手机号码如:18612341234

国际号码如:0085265656565

smstype

String

短信类型,

"0":通知短信,"4":验证码短信,"5":营销短信

content

String

必选

【签名】+ 短信内容,UTF-8编码,

信内容最长500个字(包括英文字母),其签名2-12(包括英文字母)

sendtime

String

 

时发送时间

为空表示立即发送,定时发送格式2016-11-11 09:00:00

(未生效)

extend

String

自扩展端口,

1-4位,只能为数字,可以为空

(注:请先询问配置的通道是否支持自扩展端口,如果不支持,请填空)

uid

String

用户透ID,

状态报告返回,最长60

① extend字段用于客户传送由客户自行分配给子客户的扩展端口,用于上行短信回来与之对应。

如:某客户下有A、B、C三个子客户,并且该客户获得某通道两位自扩展,分别对其子客户自行分配的扩展端口依次为子客户A01,子客户B:02,子客户C:03

若子客户A在发送下行短信时将该扩展端口01填入此字段即可,上行短信将会把此字段的扩展端口01发给客户,用于客户区分哪个子客户的上行短信,子客户A可根据上行短信中的电话号码对应之前的下行手机号码;

② uid字段用户在单、群发短信时,由用户生成并下发到平台的序列号(最长不超过60位),该uid将在应答状态报告中返回给客户,用于客户区分或对应单、群发短信的批次。

 

次最多100个号码(目前不支持多内容组发)。

(4) JSON请求示例:

{

"clientid":"test",

"password":"6918d0046aab6a1ee290f751e02bd0b2",

"mobile":"13800138000,13800138001,19800138002,19800138003",

"smstype":"4",

"content":"云通讯您的验证码为1234",

"sendtime":"2016-11-11 09:00:00",

"extend":"00",

"uid":"00"

}

 

包头/包体

实例

备注

Header

POST /sms-partner/access/test/sendsms HTTP/1.1

Accept-Encoding:identity

Content-Length:191

Host:172.16.5.20:9999

Accept:application/json

Content-Type:application/json;charset=utf-8

色字体为可变部分

保证路径正确,采用HTTPSPOST方式发送

Body

{"clientid":"test","password":"6918d0046aab6a1ee290f751e02bd0b2","mobile":"13800138000,13800138001,19800138002,19800138003","smstype":"4","content":"云通讯】您的验证码为1234","sendtime":"2016-11-11 09:00:00","extend":"00","uid":"00"}

色字体为可变部分

 


2. 

(1) 响应包体:

属性

类型

约束

total_fee

Int

必选

短信发送的计费总条数

data



个手机号送的详细情况

code

Int

必选

短信请求响应返回码参考请求响应返回定义的返回码

(详见第九章第1节)

msg

String

必选

短信请求响应返回中文描述,参考请求响应返回定义的中文描述(详见第九章第1节)

fee

Int

必选

功发送的短信计费条数计费规则如下70个字一条,超出70个字时按每67字一条计费(英文按字母个数计算)

mobile

String

接收短信的手机号码

sid

String

短信标识符(用于匹配状态报告),一个手机号对应一个sid

uid

String

用户透ID,状态报告返回

① total_fee表示单短(长)短信总共计费的条数,该条数等于data域中各个fee字段数量之和

② fee表示每个短信接收的手机号码收到短信的计费条数(长短信按照短信计费规则进行计费,长短信拆分最大不超过10条);

③ sid是短信平台产生的唯一标示与后面返回的状态报告中的sid一一对应用于下发短息与状态报告相对应

④ uid字段返回内容和第一章第1节请求中的“用户透ID”一致用于客户区分或对应单、群发短信的批次;

 

(2) JSON响应示例

{

"total_fee":2,

"data":[

    {

    "code":0,

"msg":"成功",

"fee":1,

"mobile":"13800138000",

"sid":"08faf6-5728-438d-95ed-e0e0cec4fd37",

"uid":"1234"

},

    {

    "code":0,

"msg":"成功",

"fee":1,

"mobile":"13800138001",

"sid":"09faf6-5728-838d-95ed-e0e0cec4fd39",

"uid":"1234"

},

    {

    "code":-7,

"msg":"手机号码格式错误"

"fee":0,

"mobile":"19800138002",

"sid":"753af6-5728-838d-95ed-e0e0cec4fd39",

"uid":"1234"

},

    {

    "code":-7,

"msg":"手机号码格式错误"

"fee":0,

"mobile":"19800138003",

"sid":"95sw6-5728-838d-95ed-e0e0cec4fd39",

"uid":"1234"

}

]

}

 

包头/包体

实例

备注

Header

HTTP/1.1 200 OK

Accept-Encoding:identity

Content-Length:424

Host:172.16.5.21:45302

Accept:application/json

Content-Type:application/json;charset=utf-8

色字体为可变部分

Body

{"total_fee":2,"data":[{"code":0,"msg":"发送成功","fee":1,"mobile":"13800138000","sid":"08faf6-5728-438d-95ed-e0e0cec4fd37"},{"code":0,"msg":"发送成功","fee":1,"mobile":"13800138001","sid":"09faf6-5728-838d-95ed-e0e0cec4fd39"},{"code":-7,"msg":"手机号码格式错误","fee":0, "mobile":"19800138002", "sid":"753af6-5728-838d-95ed-e0e0cec4fd39"}, {"code":-7,"msg":"手机号码格式错误","fee":0, "mobile":"19800138003","sid":"95sw6-5728-838d-95ed-e0e0cec4fd39","uid":"1234"}]}

色字体为可变部分