Genesis API 文档
接入所需的一切:认证、限额、接口和响应结构。
文档套餐与限额
套餐与限额
限额由你的套餐决定。当前状态可随时在 /account/usage 以及每个响应的请求头中查看。
| Trial | Start | Pro | Max | |
|---|---|---|---|---|
| 每月调用次数 | 500K | 2M | 5M | 10M |
| 每秒请求数 | 1 | 2 | 5 | 15 |
| 数据新鲜度 | 60 秒 | 30 秒 | 10 秒 | 5 秒 |
超出套餐范围的接口会返回 403 及 plan_restricted 代码。超出限额的请求不会计费。
只有 200 响应才计为一次调用。304(未修改)响应以及 4xx/5xx 错误不占用你的额度,但仍计入每秒请求数限制。
下载量限制为每个密钥每 10 秒 60 MB 压缩数据。按您套餐的新鲜度轮询所有数据集完全够用;小于 64 KB 的响应不计入。超出限制时返回 429 download_limited,直到窗口结束。可通过 If-None-Match、筛选参数和 coin 参数节省流量。
限流请求头
| 请求头 | 说明 | |
|---|---|---|
X-RateLimit-Limit | 你的套餐每秒请求数上限 | |
X-RateLimit-Remaining | 当前窗口内剩余的请求数 | |
X-RateLimit-Reset | 窗口重置的 Unix 时间 | |
X-Quota-Limit | 当前 30 天周期的调用额度 | |
X-Quota-Remaining | 本周期剩余调用次数 | |
X-Quota-Reset | 额度重置的 Unix 时间 | |
Retry-After | 重试前需等待的秒数(用于 429 和 503) |