SmsReport - 短信服务

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

协议说明


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

短信回执消息SmsReport消息体格式

POST数据的内容为JSON Array格式，即回执会对结果消息合并，单次推送可能会包含多个状态报告结果。


名称	类型	示例	描述
To	String	8521234****	短信接收号码。
Status	String	1	发送状态。 1：成功 2：失败 6：失效
MessageId	String	123456789****	发送回执ID。
TaskId	String	123456	批次ID，调用发送接口时传的taskId。
SendDate	String	Thu, 25 Nov 2021 10:27:00 +0800	提交给运营商的时间。
ReceiveDate	String	Thu, 25 Nov 2021 10:27:33 +0800	收到运营商回执的时间。
ErrorCode	String	success	错误码。
ErrorDescription	String	success	错误信息。

示例

[{
    "To" : "8521111****",
    "SendDate" : "Thu, 25 Nov 2021 10:25:00 +0800",
    "ReceiveDate" : "Thu, 25 Nov 2021 10:25:33 +0800",
    "Status" : "1",
    "ErrorCode" : "success",
    "ErrorDescription" : "success",
    "TaskId" : "67890",
    "MessageId" : "123450000****"
  },
  {
    "To" : "8521234****",
    "SendDate" : "Thu, 25 Nov 2021 10:27:00 +0800",
    "ReceiveDate" : "Thu, 25 Nov 2021 10:27:33 +0800",
    "Status" : "1",
    "ErrorCode" : "success",
    "ErrorDescription" : "success",
    "TaskId" : "67890",
    "MessageId" : "123456789****"
  }]

响应说明

接收到回执后，响应的HTTP状态码必须为200，且响应体格式需如下所示，否则会推送失败，触发重新推送。

响应样例


{
  "code" : 0,
  "msg" : "接收成功"
}

字段说明


名称	类型	是否必选	示例值	描述
code	Number	是	0	应答编码。
msg	String	否	接收成功	描述信息。

重新推送

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