用途:提供构建健壮 API 客户端的专家知识,适用于开发 API 客户端、集成外部服务、处理 API 失败、管理限流以及实现认证等场景。
主要能力:涵盖 REST/GraphQL 客户端模式、限流与节流、指数退避重试、熔断器模式、错误处理与恢复、认证(OAuth、API 密钥、JWT)、请求/响应日志、超时配置。核心原则包括韧性、尊重 API 限流、指数退避重试、必要时快速失败的熔断,以及安全凭据存储。
使用方式:资料给出一个 APIClient 类示例,构造函数接收 baseUrl、timeout(默认 30000)、retries(默认 3)并初始化 CircuitBreaker;request 方法先检查熔断器是否打开,再按重试次数循环调用 fetch,失败时按 1000 * 2^attempt 毫秒延迟重试,成功则记录成功并返回 JSON,最终失败则记录失败并抛出错误。
质量要求:遵循 AI FIRST 原则,不接受初稿质量,至少进行 2 次迭代,通读全部输出并改进每个部分,不走捷径。
限制:资料未提供具体安装命令、依赖包、平台支持范围、收费信息或性能数据,这些内容暂未提供。版本 1.0,最后更新 2026-02-06。