用途:为 Flexport 集成建立基于证据的配额控制,避免假设存在未公开的全局速率限制或限流响应头。
主要能力:按 OAuth 令牌获取、REST 读取、变更写入、Webhook 处理与 MCP 工具调用分别核算预算;通过共享缓存与单次刷新复用 24 小时 OAuth JWT,避免业务并发消耗每日最多 10 次令牌请求的固定预算;按端点文档化限制与提供方重试信号执行;读取侧使用文档化分页大小与游标,避免索引调用中的昂贵展开;变更侧按业务键排队、限制重试次数并在重试前核对结果;仅依据实测延迟与错误证据调整并发。
使用方式:REST 调用使用缓存 OAuth 2.0 客户端凭据 Bearer 令牌,audience 为 https://api.flexport.com,或使用明确接受的宽泛 API key;不同工作负载使用不同凭据,禁止记录凭据或令牌。MCP 调用使用已认证连接 https://mcp.flexport.com/mcp,并受各工具文档化账户权限约束。输出为范围明确的决策或实现产物、脱敏操作与验证回执、失败回滚与后续责任记录。
适用场景:进口商分页读取 /invoices、缓存令牌、按实测行为限制并发读取等。
限制:资料未提供具体端点速率数值、价格或平台支持范围;不得声称文档未发布的全局配额。遇到无重试元数据的 429 应暂停该表面并使用带抖动的有界退避;令牌请求接近每日 10 次时应停止获取并修复缓存共享;并发提升后队列增长应回滚并检查端点延迟与错误证据;变更被限流应先核对已有业务引用再重新提交。