SmsUp

您可以通过HTTP批量推送方式拉取上行短信消息(SmsUp)。

协议说明

参数

说明

请求协议

HTTP

请求格式

application/json

编码

UTF-8

请求说明

请求内容为JSON Array格式,单次请求可能会包含多个上行短信内容。

  • 请求样例

    [
      {
        "phone_number" : "1381111****",
        "content" : "内容",
        "send_time" : "2017-09-01 00:00:00",
        "dest_code" : "1234",
        "sequence_id" : "1234567890"
      }
    ]
  • 字段说明

    名称

    类型

    是否必选

    示例值

    描述

    phone_number

    String

    1381111****

    手机号码。

    content

    String

    内容

    发送内容。

    send_time

    String

    2017-09-01 00:00:00

    运营商推送上行时间。

    dest_code

    String

    1234

    上行短信扩展号码,系统后台自动生成,不支持自定义传入。

    sequence_id

    String

    1234567890

    序列号。

响应说明

  • 响应样例

    {
      "code" : 0,
      "msg" : "接收成功"
    }
  • 字段说明

    名称

    类型

    是否必选

    示例值

    描述

    code

    Number

    0

    应答编码。

    msg

    String

    接收成功

    描述信息。

说明
  • 系统仅校验返回值的code是否为数字,不校验内容。若HTTP状态码为200,请求成功。HTTP状态码非200或响应超时情况下,系统会进行重试推送。

  • 若出现系统异常、消费失败等情况,建议HTTP响应码返回50X。

重新推送

第一次推送失败后,间隔1分钟、5分钟、10分钟后会进行重推,直至推送成功为止。如果推送3次后仍失败,不再重试。

上行短信消息接收示例

@PostMapping("/resMsg")
public JSONObject resMsg(@RequestBody JSONArray array) {
   // TODO 上行短信消息内容处理,此示例只打印回执信息
   System.out.println(array.toJSONString());
   JSONObject json = new JSONObject();
   json.put("code", 0);
   json.put("msg", "接收成功");
   return json;
}