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

 推送方式

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

色字体为可变部分

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

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

色字体为可变部分