用途:该技能面向第三方 API 集成场景,帮助在接入 REST、GraphQL 等接口时建立清晰的认证、错误处理与限流安全机制。
主要能力:覆盖认证(API Key 与 OAuth 对比、密钥存入环境变量、安全轮换)、错误处理(状态码映射为类型化错误、保留响应体)、重试策略(对 429/5xx 使用指数退避、遵守 Retry-After)、Webhook(签名校验、幂等、可重放安全处理)、分页(cursor/offset、避免无界循环)、超时设置,以及将供应商数据在边界处转换为内部模型。
必要用法:先阅读供应商的认证与限流文档;设计带重试与类型化错误的瘦客户端;在边界转换数据;补充测试,覆盖正常路径、认证失败、限流与服务端错误。示例代码展示将请求封装为 request 函数并按响应状态抛出 ApiError。
限制与注意:切勿记录密钥;供应商特定逻辑应保留在边界层;当需求不明确时,应询问目标 SLA 与预期调用量。该技能资料未提供具体收费、平台或价格信息。