用途:协调 Linear 的用户、应用、端点与复杂度配额,使重试不会成倍放大压力,适用于多 worker 协作或从 RATELIMITED 恢复的场景。
主要能力:清点共享同一配额的所有生产者与认证主体(含同一用户的多个密钥);读取请求、端点与复杂度响应头,并将重置值从 UTC 毫秒时间戳转换;为各工作负载分配低于所有适用上限的预算并集中队列/准入控制;发送前拒绝超过单查询上限的查询,减少字段、嵌套与分页大小;遇 RATELIMITED 时停止新增压力,依据重置/窗口证据并带有抖动地限制重试次数;用合成负载测试突发、持续、端点特定、复杂度与重试风暴行为。
当前契约:API key 每用户每小时 2,500 请求与 3,000,000 复杂度点;OAuth 每用户或应用用户每小时 5,000 请求与 2,000,000 点;未认证流量每 IP 每小时 600 请求与 100,000 点,单查询上限 10,000 点;端点特定限制可能更低并暴露自己的 limit、remaining、reset 与端点名响应头;GraphQL 限流返回 HTTP 400 且 extensions.code 为 RATELIMITED,采用漏桶补充模型。
认证:个人 API key 仅用于所有者控制的脚本,Authorization: <API_KEY>;OAuth 使用 PKCE 用于用户委托应用,Authorization: Bearer <ACCESS_TOKEN>;凭据存于服务端批准的密钥管理器。
限制与边界:不得创建、泄露、轮换或撤销凭据,不得授权 OAuth 应用、更改范围或团队访问、变更工作区数据、配置 webhook、导入导出数据、更改角色/SCIM/审计流、传输诊断或更改付费权益,除非获得责任所有者明确批准;未要求实现时保持只读诊断。响应头缺失时使用保守熔断并暴露未知容量;同一用户的多个密钥视为一个 API key 配额,不得绕过限制分片;动态工作区限制以观测到的响应头为准而非缓存权益。输出需包含工作区与团队范围、认证模式(不含凭据值)、检查的文件与契约、确切操作名、证据、验证结果、已脱敏字段、剩余风险、责任所有者、批准状态与回滚或下一步。