全部产品
Search
文档中心

短信服务:SMS webhook

更新时间:Jul 01, 2024

您可以通过MNS消息队列接收短信发送状态报告(SMS webhook)。

前提条件

  • 您已经注册阿里云账号并生成访问密钥(AccessKey),详情请参见创建AccessKey

  • 确保运行MNS消息消费程序的网络环境可以访问到以下两个地址:dybaseapi.ap-southeast-1.aliyuncs.com或1493622401794734.mns.ap-southeast-1.aliyuncs.com。

重要

回执消息无法保证幂等性,因此需要您自行处理幂等性的问题。我们建议您在接收到回执消息后,采取适当的措施来确保数据的正确性和一致性。

短信回执消息SMS webhook消息体格式

名称

类型

示例

描述

To

String

8521234****

短信接收号码。

Status

String

1

发送状态。

  • 1:成功

  • 2:失败

  • 6:失效

MessageId

String

123456789****

发送回执ID。

SmsSize

String

1

短信条数。

长短信将会被拆分为多条发送。

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" : "8521234****",
    "SendDate" : "Thu, 25 Nov 2021 10:27:00 +0800",
    "ReceiveDate" : "Thu, 25 Nov 2021 10:27:33 +0800",
    "Status" : "1",
    "SmsSize":"1",
    "ErrorCode" : "success",
    "ErrorDescription" : "success",
    "MessageId" : "123456789****"
  }