接口说明

根地址：https://api.channel.suiinn.com
这里只列接入方后台要调用的接口。SDK 自己请求小鹅的接口不在这份文档里。

功能描述

左侧按分类列出每个接口。点进一个接口后，可以看到功能、参数和示例。

鉴权

接入方后台 HMAC

请求头为 X-Channel-Key、X-Channel-Timestamp（Unix 秒）、X-Channel-Nonce、X-Channel-Signature。签名原文是下面几行用换行符连接，再用 SecretKey 做 HMAC-SHA256，输出十六进制。path 含查询串、不含域名。时间允许偏差 ±5 分钟，每次请求使用新的 nonce。

HMAC Canonical 字符串

timestamp
nonce
METHOD
path[?query]
hex(sha256(body))

Webhook 签名

物流推送由小鹅 POST 到接入配置里的 Webhook URL。签名密钥是 Webhook 签名密钥，对原始 JSON 请求体做 HMAC-SHA256，十六进制放在 X-Channel-Webhook-Signature。没有时间戳，也没有 nonce。请用收到的原始字节验签，不要重新序列化 JSON。密钥留空时不带这个头。