您可以指定HTTP URL来接收由短信服务推送的短信发送状态报告,然后SmsReport使用HTTP服务接收消息传递报告。

协议说明

参数 说明
协议 HTTP + JSON
编码 UTF-8

请求说明

请求内容为JSON Array格式,回执消息不区分群发或单发,单次请求可能会包含多个状态报告结果。
  • 请求样例
    [
      {
        "phone_number" : "1381111****",
        "send_time" : "2017-01-01 00:00:00",
        "report_time" : "2017-01-01 00:00:00",
        "success" : true,
        "err_code" : "DELIVERED",
        "err_msg" : "用户接收成功",
        "sms_size" : "1",
        "biz_id" : "12345",
        "out_id" : "67890"
      }
    ]
  • 字段说明
    名称 类型 是否必选 示例值 描述
    phone_number String 1381111**** 手机号码
    send_time String 2017-01-01 00:00:00 发送时间。
    report_time String 2017-01-01 00:00:00 状态报告时间。
    success Boolean true 是否接收成功。取值:
    • true:接收成功
    • false:接收失败
    err_code String DELIVERED 状态报告编码。
    err_msg String 用户接收成功 状态报告说明。
    sms_size String 1 短信长度。短信内容长度计算规则,请参见短信发送规则
    biz_id String 12345 发送回执ID,即发送流水号。
    调用发送接口SendSmsSendBatchSms发送短信时,返回值中的BizId字段。若批量发送短信时会有同一个BizId字段,可以查看批量发送记录。同一个阿里云账号下不同请求批次的BizId不同。
    out_id String 67890 用户序列号。

响应说明

  • 响应样例
    {
      "code" : 0,
      "msg" : "接收成功"
    }
  • 字段说明
    名称 类型 是否必选 示例值 描述
    code Number 0 应答编码。
    msg String 接收成功 描述信息。
说明
  • 系统仅校验返回值的code是否为数字,不校验内容。若HTTP状态码为200,请求成功。HTTP状态码非200或响应超时情况下,系统会进行重试推送。
  • 若出现系统异常、消费失败等情况,建议HTTP响应码返回50X。

重新推送

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