短信上行-推送方式
1. 請求
(1) 請求地址:
需要第三方自行配置URL地址,接受http post請求,消息格式:json表達式。
該接口一次推送1條上行。
(2) 請求包體:
屬性 | 類型 | 約束 | 說明 |
moid① | String | 必選 | 上行標識符 |
mobile | String | 必選 | 短信發(fā)送端手機號碼 |
content | String | 必選 | 短信內(nèi)容, UTF-8編碼,最長600個字 |
sign | String | 必選 | 簽名字段, UTF-8編碼 |
extend② | String | 可選 | 擴展端口 (注:此功能需要通道支持) |
reply_time | String | 必選 | 上行時間 |
注:
① moid是由短信平臺產(chǎn)生的唯一標示,可用于客戶到平臺查詢上行情況;
② extend字段返回內(nèi)容和第一章(或第二章)第1節(jié)請求中的“擴展端口”一致,請查看之前詳細說明;
上行短信中的extend字段與客戶自行分配給子客戶的擴展端口相對應,子客戶即可通過上行中的電話號碼找到之前下發(fā)的下行短信與之對應;
(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方式發(fā)送; |
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"
}//成功
失?。?/span>
{
"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"} | 藍色字體為可變部分 |