API 参考

概述

CodeGate SDK API 提供项目信息、激活码查询、核销、重新激活、统计等接口。所有接口均需使用 API Key + HMAC-SHA256 签名 认证。推荐优先使用 Python SDK 或 JavaScript SDK，无需手写签名逻辑。

每个请求需在 HTTP Header 中携带：

签名字符串格式：

{METHOD}\n{PATH}\n{QUERY_STRING}\n{BODY_SHA256_HEX}\n{TIMESTAMP}

无 body 时使用空串的 SHA256：e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
时间戳需在 ±5 分钟内，防止重放攻击

方法	路径	用途
GET	`/api/v1/projects/{project_id}`	项目信息
GET	`/api/v1/projects/{project_id}/codes`	分页查激活码
GET	`/api/v1/projects/{project_id}/codes/{code_id}`	按 ID 查单个
GET	`/api/v1/projects/{project_id}/codes/by-code/{code}`	按内容查单个
POST	`/api/v1/projects/{project_id}/codes/verify`	核销
POST	`/api/v1/projects/{project_id}/codes/reactivate`	重新激活
GET	`/api/v1/projects/{project_id}/statistics`	统计信息

响应中 success=false 时，error_code 可能为：