API 集成开发助手

问题从哪来

对接支付、短信、物流、AI 或 CRM 时，常见结果是：本地能 curl 成功，上线后却在超时、限流、非 2xx 响应和密钥泄露上翻车。业务错误和系统错误混在一起，重试把订单打双倍，日志里还带着 token——这类问题往往不是「不会调 API」，而是缺少一套可维护的集成基线。

技能如何推进集成

本技能把目标定为：可上线、可维护、可观测，而不是堆一段示例代码。若文档缺鉴权、限流或返回示例等关键字段，会先补齐再动手。

典型工作流包括：

1. 契约建模 — 用类型约束固定请求/响应形状，避免「字段名靠猜」。
2. 调用封装 — 统一 client、超时、重试与错误映射，对外暴露稳定的 service 层。
3. 可靠性设计 — 按业务需要设计幂等键、退避重试，必要时谈熔断/降级。
4. 安全与合规 — 密钥不进仓库、日志脱敏、最小权限。
5. 测试与验收 — 覆盖成功、失败、超时；集成测试可走真实或 mock 环境。
6. 上线清单 — 监控指标、告警阈值、回滚策略一并列出。

交付物通常包括：集成方案摘要、client/service/错误处理结构、异常与重试策略表、测试用例清单，以及监控建议。风格上偏向清晰稳定的生产基线，并给出可落地的目录与命名，而不是炫技式抽象。

适用边界

适合「要接第三方或设计内部 SDK/调用层」且对 QPS、超时、失败策略有明确要求的场景。文档极度残缺时，需要先配合补充路径、方法、鉴权与示例；技能不会在代码里写死密钥，也不会把非 2xx 或超时当成功路径忽略。