API
API
简体中文

状态推送

Moy Mobile 国际云通讯平台主动向客户推送短信状态回执，客户需在平台控制台中设置 状态报告 接收地址。
平台会在短信状态变更（如送达）时，向该地址发送一条 HTTP POST 请求。

接收地址设置

客户需在控制台配置接收地址，格式如：

https://your.domain.com/webhook/sms-status

⚠️ 配置后地址将被平台缓存 5 分钟，变更最多可能延迟 5 分钟生效。

请求方式

  • 方法：POST

  • 内容类型：application/json

  • 触发时机：平台检测到消息状态变化（如：已送达）

推送数据格式

平台将以 JSON 格式向客户服务端推送如下数据：

{
  "messageId": "1933051433696038912",
  "accountId": "1910159943521189888",
  "to": "+14155550000",
  "statusCode": "2",
  "statusDescription": "Delivered",
  "receivedAt": "2025-06-12T08:39:14",
  "reference": "reference"
}

字段说明

字段名 类型 描述
messageId string 消息唯一 ID
accountId string 客户账号 ID
to string 接收方号码（E.164 格式）
statusCode string 状态码（详见状态码说明）
statusDescription string 状态描述（如 Delivered）
receivedAt string 平台接收到状态回执的时间（UTC ISO 8601 格式）
reference string 客户发送请求时自定义的 reference 字段

响应要求

客户服务端应返回 HTTP 200 以表示接收成功。
平台当前不支持自动重试机制，请确保接收服务稳定可靠。

示例

平台推送请求示例

POST /webhook/sms-status HTTP/1.1
Host: your.domain.com
Content-Type: application/json

{
  "messageId": "1933051433696038912",
  "accountId": "1910159943521189888",
  "to": "+14155550000",
  "statusCode": "2",
  "statusDescription": "Delivered",
  "receivedAt": "2025-06-12T08:39:14",
  "reference": "reference"
}

客户应返回

HTTP/1.1 200 OK

如需测试 Webhook 地址是否配置成功，请使用平台提供的测试工具或联系技术支持。
技术支持邮箱：[email protected]

大纲