发送短信接口：设计规范

示例不是生产凭证

下列代码用于说明推荐字段和调用流程，不代表已经上线的实际接口地址。

建议请求

POST /v1/messages
Authorization: Bearer YOUR_API_KEY
Idempotency-Key: order_20260819_001
Content-Type: application/json

{
  "to": "+14155550123",
  "sender_id": "PANDAWM",
  "message": "Your order has shipped.",
  "purpose": "transactional",
  "callback_url": "https://example.com/sms/dlr"
}

客户端必须处理

HTTP成功只表示平台接收，不表示手机已经收到。
保存平台消息ID与业务订单ID的映射。
对超时使用同一幂等键重试。
对无效号码、退订和禁止内容停止重试。
最终结果以状态回执或查询接口为准。