故障排除

原因

• JSON 格式无效
• 缺少必填字段
• 端点 URL 不匹配

解决方案

• 验证 JSON 格式
• 在 API 文档中检查必填字段
• 验证端点 URL

原因

• 缺少或为空的 Authorization 请求头
• API 密钥格式无效（应为 tm_test_xxx... 或 tm_live_xxx...）
• 此端点的 API 密钥不正确
• API 密钥已被端点所有者停用

解决方案

• 包含 Authorization 请求头（例如 Bearer tm_test_xxx...）
• 沙盒使用 tm_test_xxx...，生产使用 tm_live_xxx...
• 必要时重新生成密钥
• 联系端点所有者重新激活您的 API 密钥

原因

• 端点已停用
• 订阅已过期或月度配额已用完
• 生产环境未部署（使用了 tm_live_ 密钥）

解决方案

• 验证端点是否已激活
• 检查订阅状态
• 如使用 tm_live_ 密钥，请先部署到生产环境

原因

• 缺少或错误的 Content-Type 请求头
• Content-Type 必须为 application/json

解决方案

• 添加请求头：Content-Type: application/json

原因

• 月度请求限额已用完

解决方案

• 升级套餐或等待月度重置
• 在仪表盘中监控用量

包括 500（内部服务器错误）、502（网关错误）、503（服务不可用）等。

原因

• 临时服务器问题
• 上游服务（数据库）暂时不可用
• 服务暂时过载或正在维护

解决方案

• 实现指数退避重试（例如 1秒 → 2秒 → 4秒，最多3次）
• 如错误持续，检查服务状态
• 如问题持续，联系支持：contact@3minapi.com
• 注意：5xx 表示请求未被接收。一旦收到 202 Accepted，数据处理由系统保证。

• 验证 Webhook URL 是否正确
• 使用 HTTP 或 HTTPS URL
• 端点必须可公开访问
• 在日志中检查 Webhook 状态

• 返回 2xx 状态码表示成功
• 在30秒内响应
• 系统自动重试最多3次
• Webhook 重试可能延迟数据处理（最多约3秒）