短信发送状态报告接口定义。
接口说明
您可以指定HTTP URL来接收由短信服务推送的短信发送状态报告,然后SmsReport使用HTTP服务接收消息传递报告。 您可以使用UpdateReportUrl更新您的接收服务URL。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
当前API暂无授权信息透出。
请求参数
名称 | 类型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
body | array | 否 | 请求参数的主体信息。 | |
object | 否 | |||
biz_id | string | 否 | 发送回执ID,即发送流水号。 | 12345 |
err_code | string | 否 | 状态报告编码。 | DELIVERED |
err_msg | string | 否 | 状态报告说明。 | 用户接收成功 |
message_id | string | 否 | 短信ID。调用发送接口SendMessage发送短信时,返回值中的ID字段。可使用短信ID在接口ListMessages查询具体的发送状态。 | 123 |
out_id | string | 否 | 外部拓展字段。 | 123 |
phone_number | string | 否 | 手机号码。 | 1390000**** |
report_time | string | 否 | 状态报告时间。 | 2017-09-01 00:00:00 |
request_id | string | 否 | 短信批处理ID。调用发送接口SendMessage发送短信时,返回值中的RequestId字段。可使用短信批处理ID在接口ListMessages查询具体的发送状态。 | 62a72a20-8a9b-4060-a510-0c30a9340cba |
send_time | string | 否 | 发送时间。 | 2017-09-01 00:00:00 |
sign_name | string | 否 | 签名。 | 签名 |
sms_size | string | 否 | 短信长度。短信长度不超过70个字,按照一条短信计费;超过70个字,即为长短信,按照67字/条拆分成多条计费。 | 1 |
success | boolean | 否 | 是否接收成功。
| true |
template_code | string | 否 | 模板号。 | SMS_123456 |
返回参数
错误码
访问错误中心查看更多错误码。
变更历史
变更时间 | 变更内容概要 | 操作 |
---|---|---|
2022-03-07 | 新增 OpenAPI |
第一次推送失败后,间隔1分钟、5分钟、10分钟、30分钟、60分钟、60分钟、60分钟、60分钟、60分钟后会进行重推,直至推送成功为止。如果推送10次后仍失败,不再重试。