开放 API

稳定、快速、可追溯的彩票开奖数据服务。API Key 由管理员创建并线下发放。

请求签名

请求头必须包含 X-API-Key、X-Timestamp、X-Nonce 和 X-Signature。

canonical = METHOD + "\n" + PATH + "\n" + RAW_QUERY + "\n" + RFC3339_TIMESTAMP + "\n" + NONCE
signature = hex(HMAC-SHA256(secret, canonical))

时间戳允许偏差 5 分钟；Nonce 10 分钟内不可重复使用。

QPS（Queries Per Second）是每秒稳定允许的请求数，默认 10；Burst 是短时突发允许透支的请求数，默认 20，且必须大于等于 QPS。

可以把配额理解为容量为 Burst 的令牌桶：每秒补充 QPS 个令牌，每请求消耗一个令牌，桶空即返回 HTTP 429 RATE_LIMITED。平台对每个 IP 和每个 API Key 分别限流，以更严格的配额为准；持续超限会持续拒绝请求。