短信下行状态报告
1 协议说明
参数 | 说明 |
协议 | HTTP + JSON |
编码 | UTF-8 |
名称 | 类型 | 描述 | 示例值 | 是否必须 |
phone_number | String | 手机号码 | 13900000001 | 必须 |
send_time | String | 发送时间 | 2017-01-01 00:00:00 | 必须 |
report_time | String | 状态报告时间 | 2017-01-01 00:00:00 | 必须 |
success | Boolean | 是否接收成功 | true\false | 必须 |
err_code | String | 状态报告编码 | DELIVERED | 必须 |
err_msg | String | 状态报告说明 | 用户接收成功 | 必须 |
sms_size | String | 短信长度 | 1 | 必须 |
biz_id | String | 发送序列号 | 12345 | 必须 |
out_id | String | 用户序列号 | 67890 | 必须 |
名称 | 类型 | 描述 | 示例值 | 是否必须 |
code | Number | 应答编码 | 0 | 必须 |
msg | String | 描述信息 | 接收成功 | 可选 |
版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。
您提到的是关于短信下行状态报告的接口说明,这通常涉及到使用云通信服务(如阿里云的短信服务)来发送短信后,获取短信发送状态的反馈机制。下面我将基于您提供的信息,结合阿里云短信服务的上下文,帮助您理解这一过程:
短信下行状态报告是运营商返回给短信服务平台的一种确认机制,用于告知发送方短信是否成功送达至目标手机。这对于监控短信发送质量、统计发送成功率以及进行后续业务逻辑处理非常重要。
phone_number
: 目标手机号码。send_time
: 短信发送的时间。report_time
: 状态报告生成的时间。success
: 表示短信是否成功送达,布尔值。err_code
: 状态报告编码,如DELIVERED
表示成功送达。err_msg
: 对应状态的详细描述,如“用户接收成功”。sms_size
: 短信内容长度。biz_id
: 发送序列号,由发送时平台生成的唯一标识。out_id
: 用户自定义序列号,用于关联用户的内部记录。{
"code": 0,
"msg": "接收成功"
}
code
: 应答编码,0通常表示成功。msg
: 描述信息,表明状态报告接收情况,如“接收成功”。在阿里云场景中,如果您使用的是阿里云的短信服务(Short Message Service, SMS),可以通过调用其API来发送短信,并配置接收状态报告的功能。阿里云会根据运营商反馈,通过回调URL(用户预先设置的地址)向您的服务器发送上述格式的状态报告,以便您实时获取并处理短信发送状态。
确保您的服务器端能够正确解析这些JSON格式的报告,并根据success
、err_code
等字段做出相应的业务逻辑处理,比如更新数据库中的发送状态、触发重试机制或通知用户等。