用途:帮助理解并管理 Guidewire Cloud API 的速率限制,实现限流、退避与调用优化,减少 429 错误。
主要能力:监控速率限制响应头(X-RateLimit-Limit、X-RateLimit-Remaining、X-RateLimit-Reset),剩余量低于限额 10% 时告警;对 429 响应实现带抖动的指数退避,起始 1 秒、最大 60 秒、10% 抖动,并遵循 Retry-After;用队列(如 p-queue)将请求限制在每秒限额的 80%,批量处理并加延迟;优化调用模式,如用 ?include= 一次获取关联实体、用服务端 ?filter= 替代客户端过滤、用 pageSize=100 分页批量获取;实现熔断器,连续 5 次 429 后打开,等待 60 秒半开探测,3 次成功后关闭。
默认限制(Guidewire Cloud):每秒 50 请求(每租户)、每分钟 1,000(每租户)、每小时 30,000(每租户)、并发 25(每应用)、负载 10 MB(每请求)、查询结果上限 1,000(每请求)。
使用方式:需了解 HTTP 限流概念、可访问 Guidewire Cloud Console 监控配额、熟悉指数退避模式。详细实现代码(TypeScript 与 Gosu)见参考指南:Read(${CLAUDE_SKILL_DIR}/references/implementation-guide.md)。
错误处理:429 表示超限,需退避并检查响应头;503 为临时过载,退避重试;熔断打开需等待重置;队列超时属背压,可增大队列容量。
限制:具体实现细节与完整代码需查阅参考文件;安全实现参见 guidewire-security-basics。