开发者文档

快速开始

1）在控制台创建应用，获取 AccessKey 与 SecretKey；2）申请签名与模板；3）调用发送接口。所有接口 base URL 为 https://api.sucher.cloud/v1。

身份认证

使用 HMAC-SHA256 对请求签名，在 Header 中携带：

Authorization: HMAC-SHA256
  appKey="AK_xxxx",
  nonce="随机串",
  timestamp="1700000000",
  signature="hex"

服务端将按相同规则校验，防止重放与伪造。

发送短信

POST /v1/sms/send
Content-Type: application/json

{
  "mobile": "13800000000",
  "sign": "【数洽】",
  "template": "SMS_001",
  "params": { "code": "123456" }
}
// 返回 {"code":0,"msg":"success","msgId":"..."}

• 支持单发与批量（mobile 传数组，上限 1000/次）
• 变量模板需在控制台预先审核

状态回调

在控制台配置回调 URL，消息状态变更（送达 / 失败 / 退订）将以 POST JSON 推送：

{
  "msgId": "...",
  "status": "DELIVERED",
  "timestamp": 1700000123
}

错误码

# 常见错误码
0    成功
1001 签名不存在或未审核
1002 模板不存在或未审核
1003 手机号格式错误
1004 余额不足
1005 触发频率限制
2001 无权限（牌照/时段）

更多 SDK（Java / Python / Node / PHP / Go）与示例代码，请在控制台下载。