短信上行－推送方式
1. 請(qǐng)求
（1） 請(qǐng)求地址：
需要第三方自行配置URL地址，接受http post請(qǐng)求，消息格式：json表達(dá)式。
該接口一次推送1條上行。
（2） 請(qǐng)求包體：
屬性 | 類型 | 約束 | 說(shuō)明 |
moid① | String | 必選 | 上行標(biāo)識(shí)符 |
mobile | String | 必選 | 短信發(fā)送端手機(jī)號(hào)碼 |
content | String | 必選 | 短信內(nèi)容， UTF-8編碼，最長(zhǎng)600個(gè)字 |
sign | String | 必選 | 簽名字段， UTF-8編碼 |
extend② | String | 可選 | 擴(kuò)展端口 （注：此功能需要通道支持） |
reply_time | String | 必選 | 上行時(shí)間 |
注：
① moid是由短信平臺(tái)產(chǎn)生的唯一標(biāo)示，可用于客戶到平臺(tái)查詢上行情況；
② extend字段返回內(nèi)容和第一章（或第二章）第1節(jié)請(qǐng)求中的“擴(kuò)展端口”一致，請(qǐng)查看之前詳細(xì)說(shuō)明；
上行短信中的extend字段與客戶自行分配給子客戶的擴(kuò)展端口相對(duì)應(yīng)，子客戶即可通過(guò)上行中的電話號(hào)碼找到之前下發(fā)的下行短信與之對(duì)應(yīng)；
（3） JSON請(qǐng)求示例:
{
"moid":"79a11e15-5363-4a0f-b3f0-46240bd3cea6",
"mobile":"13800138000",
"content":"短信上行1",
"sign":"云通訊",
"extend":"00",
"reply_time":"2016-04-02 17:52:15"
}
包頭/包體 | 實(shí)例 | 備注 |
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 | 藍(lán)色字體為可變部分， 保證路徑正確,采用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"} | 藍(lán)色字體為可變部分 |
2. 響應(yīng)
（1） 響應(yīng)包體：
屬性 | 類型 | 約束 | 說(shuō)明 |
code | String | 必選 | 返回錯(cuò)誤碼， 0：成功，其它失敗 |
errmsg | String | 可選 | 返回錯(cuò)誤詳細(xì)描述 |
（2） JSON響應(yīng)示例:
成功：
{
"code":"0"
}//成功
失?。?/span>
{
"code":"403"，
"errmsg":"ip limit"
}//ip非法
包頭/包體 | 實(shí)例 | 備注 |
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 | 藍(lán)色字體為可變部分 |
Body | {"code":"0"} 或 {"code":"403"，"errmsg":"ip limit"} | 藍(lán)色字體為可變部分 |
