用途:帮助 AI 代理把应用与外部 API 可靠集成,按场景选择 REST 客户端、Webhook 消费、轮询或 SDK 封装模式,并处理认证、错误、重试与限流。
主要能力:分析 API 文档、OpenAPI 规范或 SDK 参考,识别端点、认证要求、限流与响应格式,判断是否支持 Webhook;实现 API Key、OAuth 2.0、JWT、Basic Auth、HMAC 签名等认证,并处理 OAuth 令牌刷新;按状态码分类处理错误(4xx 不重试、429 退避重试、5xx 指数退避),加入抖动、最大重试次数与熔断器;用录制式 HTTP 夹具做集成测试,并监控延迟、错误率与限流余量。
使用方式:向代理提供目标 API 名称或文档 URL、所需操作与编程语言,并说明认证方式与约束(限流、数据量),代理会产出含错误处理、重试与示例的完整集成模块。支持 requests、httpx、axios、fetch、HttpClient、OkHttp 等客户端,tenacity、retry、Polly、resilience4j 等重试库,以及 responses、nock、VCR.py、WireMock 等测试工具和 gql、graphql-request、Apollo Client 等 GraphQL 客户端。
适用场景:需要对接支付、第三方服务、GraphQL 接口或事件驱动数据的集成开发。
限制与注意:资料未提供具体收费、价格或平台信息;凭据应使用环境变量或密钥管理,避免硬编码;应为请求设置显式超时;对支付类 POST 使用幂等键;注意 API 弃用、部分响应、时钟偏移、大载荷与 Webhook/轮询去重等边界情况。