Skip to main content

速率限制

需要密钥的接口按套餐限流,包含每分钟与(Enterprise 以下)每月两个配额窗口。配额由账号下所有 API 密钥共享,多建密钥不会增加吞吐量。每个响应都携带配额响应头,超限返回 429 并附 Retry-After

各套餐限制

Developer60 次/分钟 · 10,000 次/月
Pro600 次/分钟 · 200,000 次/月
Enterprise3,000 次/分钟 · 每月不限

限额按账号(订阅)合并计算,而非按密钥:账号下每个有效密钥都从同一份配额中扣减,多建密钥不会成倍增加吞吐量。多余的密钥请用于隔离与轮换(例如每个环境一个),而非扩容。每个订阅最多 5 个有效密钥;创建第 6 个会返回 400,需先吊销一个。分钟窗口用于平滑突发流量;月度窗口限制总量(Enterprise 无月度上限)。

配额响应头

每个需要密钥的响应都包含分钟窗口的响应头,你可以主动限速而不是等到 429。有月度上限的套餐(Developer、Pro)还包含 -Month 系列响应头;Enterprise 无月度上限,因此不返回它们:

X-RateLimit-Limit当前分钟窗口允许的请求数。
X-RateLimit-Remaining当前分钟窗口剩余的请求数。
X-RateLimit-Reset距分钟窗口重置的 Unix 秒数。
X-RateLimit-Limit-Month当前自然月允许的请求数。Enterprise 不返回(无月度上限)。
X-RateLimit-Remaining-Month本月剩余请求数。Enterprise 不返回。
X-RateLimit-Reset-Month距月度窗口重置的 Unix 秒数。Enterprise 不返回。

处理 429

超过任一窗口时,API 返回 429 Too Many Requests 并附 Retry-After 头(需等待的秒数)。请等待该时长后重试,突发流量下最好配合指数退避加抖动。能缓存就缓存:NBBO 与价格数据流的设计是按稳定节奏轮询,而不是高频轰炸。

市场健康状态

市场健康状态是唯一无需密钥的接口,按 IP 独立限流(约 60 次 / 60 秒),不返回按密钥的配额响应头。其余接口都需要密钥;获取方式见身份认证

使用与许可

API 及其数据的使用受我们的服务条款(英文)约束:不得转售或再分发数据,不得用于构建竞争性服务, 不得超出套餐的速率限制;在条款允许展示数据的场景下须注明数据来源为 SkinPricer。滥用行为可能被限流或封禁。