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

 短信上行-推送方式

1. 请求

(1) 请求地址:

需要第三方自行配置URL地址,接受http post请求,消息格式:json表达式。

该接口一次推送1条上行。

(2) 请求包体:

属性

类型

约束

说明

moid①

String

必选

上行标识符

mobile

String

必选

短信发送端手机号码

content

String

必选

短信内容,

UTF-8编码,最长600个字

sign

String

必选

签名字段,

UTF-8编码

extend②

String

可选

扩展端口

(注:此功能需要通道支持)

reply_time

String

必选

上行时间

注:

① moid是由短信平台产生的唯一标示,可用于客户到平台查询上行情况;

② extend字段返回内容和第一章(或第二章)第1节请求中的“扩展端口”一致,请查看之前详细说明;

上行短信中的extend字段与客户自行分配给子客户的扩展端口相对应,子客户即可通过上行中的电话号码找到之前下发的下行短信与之对应;

(3) JSON请求示例:

{

    "moid":"79a11e15-5363-4a0f-b3f0-46240bd3cea6",

"mobile":"13800138000",

"content":"短信上行1",

"sign":"云通讯",

"extend":"00",

"reply_time":"2016-04-02 17:52:15"

}

包头/包体

实例

备注

Header

POST /xxx/xxx/xxx HTTP/1.1

Accept-Encoding:identity

Content-Length:157

Host:172.16.5.20:9999

Accept:application/json

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

蓝色字体为可变部分,

保证路径正确,采用HTTPS的POST方式发送;

Body

{"moid":"79a11e15-5363-4a0f-b3f0-46240bd3cea6","mobile":"13800138000","content":"短信上行1","sign":"云通讯","extend":"00","reply_time":"2016-04-02 17:52:15"}

蓝色字体为可变部分

 


2. 响应

(1) 响应包体:

属性

类型

约束

说明

code

String

必选

返回错误码,

0:成功,其它失败

errmsg

String

可选

返回错误详细描述

 

(2) JSON响应示例:

成功:

{

"code":"0"

}//成功

 

失败:

{

"code":"403",

"errmsg":"ip limit"

}//ip非法

 

包头/包体

实例

备注

Header

HTTP/1.1 200 OK

Accept-Encoding:identity

Content-Length:13

Host:172.16.5.21:45302

Accept:application/json

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

蓝色字体为可变部分

Body

{"code":"0"}

或

{"code":"403","errmsg":"ip limit"}

蓝色字体为可变部分