短信上行-推送方式
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"} | 蓝色字体为可变部分 |