模块化排查指南

1. 网络连接不稳定或中断

API请求需要稳定的网络连接，网络波动会导致请求失败。

  1. 检查你的Wi-Fi或移动数据是否正常开启
  2. 尝试访问其他网站确认网络通畅
  3. 重启路由器或切换网络环境
  4. 使用ping命令测试API服务器连通性
提示：优先使用有线网络连接，稳定性优于无线

2. API密钥过期或无效

错误的API密钥是导致失效的常见原因之一。

  1. 登录安哥拉纸飞机开发者平台检查API密钥状态
  2. 确认密钥未过期且权限设置正确
  3. 如有必要，重新生成并替换新密钥
  4. 在代码中更新最新API密钥
注意：密钥泄露可能导致安全问题，请妥善保管

3. 服务器维护或宕机

服务端问题也会导致API暂时不可用。

  1. 访问安哥拉纸飞机官方状态页面检查服务状态
  2. 查看官方社交媒体获取维护公告
  3. 等待官方修复完成
  4. 设置重试机制应对临时故障

4. 请求频率超出限制

API通常有调用频率限制，超限会被临时封禁。

  1. 查阅API文档确认调用频率限制
  2. 检查代码是否存在循环频繁调用
  3. 实现请求间隔控制
  4. 考虑使用缓存减少不必要请求

常见错误代码专项

错误：401 Unauthorized

身份验证失败，通常由无效API密钥引起。

  1. 确认API密钥输入正确
  2. 检查密钥是否已过期
  3. 验证请求头中的认证信息

错误：403 Forbidden

权限不足，可能IP被限制或功能未授权。

  1. 检查账户权限设置
  2. 确认IP地址未被封禁
  3. 联系管理员获取必要权限

错误：500 Internal Server Error

服务器内部错误，通常需要等待修复。

  1. 确认是否为普遍性问题
  2. 检查请求参数是否合规
  3. 稍后重试或联系技术支持