API 连接调试实战指南

认证方式选择

常见认证方式：API Key（最简单，放在 Header 中）、OAuth 2.0（需要授权流程，适合 SaaS 应用）、Basic Auth（用户名密码）。大多数自动化平台已封装好 OAuth 流程，你只需要点击授权按钮。自定义 API 通常用 API Key。

请求格式调试

API 返回错误时，90% 是请求格式问题。检查清单：1）Content-Type 是否正确（通常是 application/json）；2）必填字段是否遗漏；3）数据类型是否匹配（字符串 vs 数字）；4）日期格式是否符合要求。

处理速率限制

大多数 API 有调用频率限制（如 OpenAI 每分钟 60 次）。解决方案：1）在步骤间添加延迟（Sleep 模块）；2）使用队列缓冲请求；3）批量 API 代替单条调用；4）缓存重复请求的结果。

超时与重试策略

网络不稳定或 API 响应慢会导致超时。设置：1）超时时间适当放宽（AI API 建议 60 秒）；2）失败后自动重试 2-3 次；3）重试间隔递增（1秒、5秒、15秒）；4）最终失败走错误处理路径。

Webhook 调试技巧

Webhook 是事件触发的核心。调试工具推荐：webhook.site（查看收到的请求）、ngrok（本地调试）。常见问题：URL 拼写错误、HTTPS 证书问题、请求体解析失败。

日志和监控

生产环境必须有日志。记录：每次 API 调用的请求/响应、执行时间、错误信息。Make 和 n8n 都有内置执行历史，但建议额外记录到自己的日志系统，方便长期分析和排查。