单条消息发送

接口

POST /api/v1/messages

请求体

{
  "channel_id": 1,
  "receiver": "+8613800000001",
  "template_params": {
    "code": "123456",
    "minutes": "5"
  },
  "signature_name": "木雷演示"
}

字段	必填	说明
channel_id	是	管理后台发送通道的数字 ID
receiver	是	与通道类型匹配的手机号、邮箱或用户标识
template_params	视模板	必须覆盖系统模板声明的全部变量
signature_name	短信通常必填	通道级签名别名；邮件复用为主题
scheduled_at	否	RFC 3339 时间；省略表示立即入队

成功响应

{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "10000000-0000-4000-8000-000000000001",
    "status": "pending",
    "created_at": "2026-07-23T10:00:00+08:00"
  }
}

pending 表示任务已经落库并入队，不代表终端已送达。调用方应保存 task_id 并查询状态或接收 Webhook。

注意事项

不要在请求体中传 App ID 覆盖认证身份；服务端以 X-App-Id 为准。发送前确保签名别名对所有可选短信账号都存在映射。

相关页面：请求认证与签名 · 任务状态查询