开发者文档开始使用
速率限制与上限
请求速率、任务规模、并发和数据保留。
以下为默认值。GET /v1/limits 返回适用于您组织的值。
| 上限项 | 值 |
|---|---|
| 每分钟 / 小时 / 天的请求数 | 60 / 1,000 / 5,000 |
每个任务的物品件数（quantity 之和） | 2,000 |
| 每个任务的车辆数（含自动添加的车辆） | 20 |
| 每个任务的计算时间预算 | 90 s |
| 同时计算的任务数 | 1 |
| 排队中 + 运行中的任务数 | 20 |
| 车辆类型 | truck, trailer, container, pallet |
| 请求体 | 10 MB |
?wait | 60 s |
| 请求体、结果和 PDF 链接的保留期 | 14 天 |
速率限制
按分钟、小时和天计数，分别针对每个密钥和整个组织，以最严格者为准。
| HTTP 头 | 含义 |
|---|---|
X-RateLimit-Limit | 最严格窗口的上限 |
X-RateLimit-Remaining | 该窗口内剩余的请求数 |
X-RateLimit-Reset | 该窗口重置的 Unix 时间 |
Retry-After | 返回 429 时：需等待的秒数 |
超出限制时返回 429 rate_limited。同一 IP 每分钟认证失败超过 60 次，也会返回 429。
任务
超出并发上限的任务以 queued 状态等待。排队中 + 运行中的任务超过 20 个时，POST /v1/pack 返回 429 too_many_jobs。
数据保留
请求体、结果体和 PDF 链接会在 14 天后删除（每个任务都带有 expires_at）。状态、计数和费用会一直保留。