SmsUp
更新時間:
您可以通過HTTP批量推送方式拉取上行短信消息(SmsUp)。
協(xié)議說明
參數(shù) | 說明 |
請求協(xié)議 | HTTP |
請求格式 | application/json |
編碼 | UTF-8 |
請求說明
請求內(nèi)容為JSON Array格式,單次請求可能會包含多個上行短信內(nèi)容。
請求樣例
[ { "phone_number" : "1381111****", "content" : "內(nèi)容", "send_time" : "2017-09-01 00:00:00", "dest_code" : "1234", "sequence_id" : "1234567890" } ]
字段說明
名稱
類型
是否必選
示例值
描述
phone_number
String
是
1381111****
手機號碼。
content
String
是
內(nèi)容
發(fā)送內(nèi)容。
send_time
String
是
2017-09-01 00:00:00
運營商推送上行時間。
dest_code
String
是
1234
上行短信擴展號碼,系統(tǒng)后臺自動生成,不支持自定義傳入。
sequence_id
String
是
1234567890
序列號。
響應(yīng)說明
響應(yīng)樣例
{ "code" : 0, "msg" : "接收成功" }
字段說明
名稱
類型
是否必選
示例值
描述
code
Number
是
0
應(yīng)答編碼。
msg
String
否
接收成功
描述信息。
說明
系統(tǒng)僅校驗返回值的code是否為數(shù)字,不校驗內(nèi)容。若HTTP狀態(tài)碼為200,請求成功。HTTP狀態(tài)碼非200或響應(yīng)超時情況下,系統(tǒng)會進行重試推送。
若出現(xiàn)系統(tǒng)異常、消費失敗等情況,建議HTTP響應(yīng)碼返回50X。
重新推送
第一次推送失敗后,間隔1分鐘、5分鐘、10分鐘后會進行重推,直至推送成功為止。如果推送3次后仍失敗,不再重試。
上行短信消息接收示例
@PostMapping("/resMsg")
public JSONObject resMsg(@RequestBody JSONArray array) {
// TODO 上行短信消息內(nèi)容處理,此示例只打印回執(zhí)信息
System.out.println(array.toJSONString());
JSONObject json = new JSONObject();
json.put("code", 0);
json.put("msg", "接收成功");
return json;
}
文檔內(nèi)容是否對您有幫助?