开发者社区 问答 正文

短信下行状态报告



短信下行状态报告



1 协议说明

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


2 请求说明


请求内容为JSONArray格式,单次请求可能会包含多个状态报告结果。


2.1 请求样例

<divre style='background: rgb(246, 246, 246); font: 12px/1.6 "YaHei Consolas Hybrid", Consolas, "Meiryo UI", "Malgun Gothic", "Segoe UI", "Trebuchet MS", Helvetica, monospace, monospace; margin: 0px 0px 16px; padding: 10px; outline: 0px; border-radius: 3px; border: 1px solid rgb(221, 221, 221); color: rgb(51, 51, 51); text-transform: none; text-indent: 0px; letter-spacing: normal; overflow: auto; word-spacing: 0px; white-space: pre-wrap; word-wrap: break-word; box-sizing: border-box; orphans: 2; widows: 2; font-size-adjust: none; font-stretch: normal; -webkit-text-stroke-width: 0px; text-decoration-style: initial; text-decoration-color: initial;' prettyprinted?="" linenums="">
  1. [
  2.   {
  3.     "phone_number" : "13900000001",
  4.     "send_time" : "2017-01-01 00:00:00",
  5.     "report_time" : "2017-01-01 00:00:00",
  6.     "success" : true,
  7.     "err_code" : "DELIVERED",
  8.     "err_msg" : "用户接收成功",
  9.     "sms_size" : "1",
  10.     "biz_id" : "12345",
  11.     "out_id" : "67890"
  12.   }
  13. ]


2.2 字段说明

名称类型描述示例值是否必须
phone_numberString手机号码13900000001必须
send_timeString发送时间2017-01-01 00:00:00必须
report_timeString状态报告时间2017-01-01 00:00:00必须
successBoolean是否接收成功true\false必须
err_codeString状态报告编码DELIVERED必须
err_msgString状态报告说明用户接收成功必须
sms_sizeString短信长度1必须
biz_idString发送序列号12345必须
out_idString用户序列号67890必须




3 应答说明



3.1 应答样例

<pre style='background: rgb(246, 246, 246); font: 12px/1.6 "YaHei Consolas Hybrid", Consolas, "Meiryo UI", "Malgun Gothic", "Segoe UI", "Trebuchet MS", Helvetica, monospace, monospace; margin: 0px 0px 16px; padding: 10px; outline: 0px; border-radius: 3px; border: 1px solid rgb(221, 221, 221); color: rgb(51, 51, 51); text-transform: none; text-indent: 0px; letter-spacing: normal; overflow: auto; word-spacing: 0px; white-space: pre-wrap; word-wrap: break-word; box-sizing: border-box; orphans: 2; widows: 2; font-size-adjust: none; font-stretch: normal; -webkit-text-stroke-width: 0px; text-decoration-style: initial; text-decoration-color: initial;' prettyprinted?="" linenums="">
  1. {
  2.   "code" : 0,
  3.   "msg" : "接收成功"
  4. }


3.2 字段说明

名称类型描述示例值是否必须
codeNumber应答编码0必须
msgString描述信息接收成功可选

展开
收起
nicenelly 2017-10-25 11:54:00 1765 分享 版权
阿里云 AI 助理回答

您提到的是关于短信下行状态报告的接口说明,这通常涉及到使用云通信服务(如阿里云的短信服务)来发送短信后,获取短信发送状态的反馈机制。下面我将基于您提供的信息,结合阿里云短信服务的上下文,帮助您理解这一过程:

短信下行状态报告的作用

短信下行状态报告是运营商返回给短信服务平台的一种确认机制,用于告知发送方短信是否成功送达至目标手机。这对于监控短信发送质量、统计发送成功率以及进行后续业务逻辑处理非常重要。

协议与编码

  • 协议: 使用HTTP协议传输数据。
  • JSON编码: 数据格式采用UTF-8编码的JSON,便于跨平台的数据交换。

请求说明

  • 内容格式: 请求体为一个JSONArray,可以包含多条短信的状态报告结果。
  • 字段详情:
    • 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格式的报告,并根据successerr_code等字段做出相应的业务逻辑处理,比如更新数据库中的发送状态、触发重试机制或通知用户等。

有帮助
无帮助
AI 助理回答生成答案可能存在不准确,仅供参考
0 条回答
写回答
取消 提交回答
问答分类:
问答地址: