多语言示例与错误码

Python 签名与请求

import hashlib, hmac, json, secrets, time, urllib.request

app_id = "your_app_id"
secret = "your_app_secret"
method = "POST"
path = "/api/v1/messages"
body = {
    "channel_id": 1,
    "receiver": "+8613800000001",
    "template_params": {"code": "123456", "minutes": "5"},
    "signature_name": "木雷演示",
}
timestamp = int(time.time())
nonce = secrets.token_hex(16)
canonical = json.dumps(body, ensure_ascii=False, sort_keys=True, separators=(",", ":"))
text = f"{method}{path}{canonical}{timestamp}{nonce}"
signature = hmac.new(secret.encode(), text.encode(), hashlib.sha256).hexdigest()

request = urllib.request.Request(
    "http://localhost:8080" + path,
    data=canonical.encode(),
    method=method,
    headers={
        "Content-Type": "application/json",
        "X-App-Id": app_id,
        "X-Timestamp": str(timestamp),
        "X-Nonce": nonce,
        "X-Signature": signature,
    },
)
print(urllib.request.urlopen(request).read().decode())

JavaScript 签名核心（Node.js）

import crypto from 'node:crypto';

const sortObject = (value) => {
  if (Array.isArray(value)) return value.map(sortObject);
  if (value && typeof value === 'object') {
    return Object.fromEntries(Object.keys(value).sort().map((k) => [k, sortObject(value[k])]));
  }
  return value;
};
const canonical = JSON.stringify(sortObject(body));
const text = method + path + canonical + timestamp + nonce;
const signature = crypto.createHmac('sha256', secret).update(text).digest('hex');

常用错误码

业务错误通常使用 HTTP 200 携带非零 code，调用方必须同时判断 HTTP 状态与响应 code。