用途
API Integration Specialist 是一个专家助手技能，用于指导第三方 API 的设计、集成与维护，目标是帮助开发者构建可靠、安全、高效的 API 对接方案。它围绕 API 集成的完整生命周期提供系统化的工作流与最佳实践。
主要能力
该技能覆盖以下核心主题：
- 集成工作流：从发现与规划（阅读官方文档、识别端点与认证方式、梳理数据流与转换需求、检查速率限制与配额、规划错误处理策略、记录依赖）开始，逐步推进到认证、请求、响应处理。
- 认证设置：涵盖 OAuth 2.0（授权码流程、PKCE 流程、客户端凭证）、API Key、Bearer Token（JWT）三类方式，并给出令牌刷新、安全存储、密钥轮换等建议。
- 请求构造：包括请求头（Content-Type、Authorization、Accept、User-Agent、X-Request-ID）、查询参数（URL 编码、命名一致、发送前校验）和请求体（结构校验、Schema 校验、嵌套对象处理、载荷大小限制）。
- 响应处理：系统化处理 2xx、4xx、5xx 状态码，并提供响应结构校验的代码示例。
- 错误处理模式：指数退避重试策略、熔断器模式（Circuit Breaker）、结构化错误响应格式。
- 限流与节流：令牌桶算法限流器、处理 429 响应与 Retry-After 头。
- 安全最佳实践：密钥管理（禁止硬编码、使用环境变量）、输入校验与清洗、强制 HTTPS 与 SSL 证书验证。
- 数据转换：请求转换与响应转换的示例函数。
- 分页模式：基于偏移量（offset）和基于游标（cursor）的分页抓取。
- Webhook 集成：使用 HMAC 验证 Webhook 签名，确保来源可信。
- 测试策略：单元测试（mock 响应）与集成测试（沙箱环境）。
- 监控与日志：请求日志记录与关键指标追踪（成功率、响应时间、错误率、限流命中频率、熔断状态变化、重试次数、超时次数）。
- 常见集成模式：幂等性（Idempotency-Key）、批量操作、缓存（带 TTL 的缓存客户端）。
使用方式
该技能以指导文档和代码示例的形式提供，内容按主题组织，包含 Python 代码片段（如重试、熔断、限流、签名验证、分页、缓存等）。使用者可参照对应章节的流程与示例，将其应用到自己的 API 集成实现中。技能还引用了若干参考文件（如 ERROR_CODES.md、AUTHENTICATION_PATTERNS.md、RATE_LIMITING.md）以获取更详细的指导。
适用场景
适用于需要对接第三方 API 的开发与集成工作，包括但不限于：需要实现认证与令牌管理的服务对接、需要处理限流与重试的稳定集成、需要验证 Webhook 来源的支付或事件回调、需要分页抓取大量数据的同步任务，以及需要监控 API 调用质量的运维场景。
限制
资料未提供该技能的具体安装命令、运行环境要求、支持的编程语言范围（示例以 Python 为主）、收费或价格信息、平台支持情况，以及实际使用效果数据。上述内容暂未提供。