一、常见API调用异常排查指南

# 1. API密钥验证失败

几乎所有API调用异常的第一诊断点就是密钥有效性，密钥失效会导致所有请求被拒绝。

  1. 1. 登录纸飞机开发者后台检查API密钥状态
  2. 2. 确保密钥没有过期或被意外撤销
  3. 3. 如果需要，重新生成并替换新密钥
提示：建议使用住宅代理IP服务来更稳定地管理API连接

# 2. 网络连接与代理配置问题

由于地区网络限制，部分用户可能需要特殊网络配置才能正常调用API。

  1. 1. 测试基础网络连通性(ping api.paperairplane.com)
  2. 2. 检查本地防火墙/安全软件是否拦截请求
  3. 3. 如需代理，确保代理配置正确且处于活动状态

# 3. 请求频率超出限制

为防止滥用，API通常有严格的频率限制，超出会导致临时封禁。

  1. 1. 检查返回头中的X-RateLimit-*字段
  2. 2. 实现适当的请求间隔控制(建议≥500ms)
  3. 3. 如必须高频调用，考虑申请商业API权限

二、常见错误提示及针对性解决方案

错误：[401 Unauthorized]

身份验证失败，API密钥无效或缺失

  1. 1. 检查请求头中Authorization字段格式
  2. 2. 确认密钥是否包含必需的Bearer前缀

错误：[403 Forbidden]

权限不足或IP地址被限制

  1. 1. 使用专业IP代理服务更换出口IP
  2. 2. 检查API密钥关联的权限范围