❓ 常见问题 FAQ

使用 ipapi.co-skills 时的常见疑问。

🎨 一图抵千言

按问题类型快速定位你要的答案。

📊 FAQ 主题分布

共收录 20 个高频问题，按主题占比一览——客户端并发与鉴权是问得最多的两类。

📦 配额与认证

• 免费额度是多少？
• 必须用 API Key 吗？
• JSONP 怎么带 Key？
• 密钥如何管理？

🌐 IP 与格式

• 支持 IPv6 吗？
• 查 192.168 报错？
• 用哪种格式？
• hostname 为什么空？

⚙️ 客户端与并发

• 能复用 Client 吗？
• 并发安全吗？
• 超时怎么设？
• 重试几次？
• 跳转限制？
• 能改基地址吗？

🔄 批量与限流

• 有批量端点吗？
• 触发 429 怎么办？

🛡 错误处理

• 自定义错误处理后还能 errors.Is 吗？
• ErrXxx 和 APIError 关系？

🗂 字段

• postal 字段类型？
• LatLong 和 Latitude 区别？

🧪 测试

• 测试覆盖如何？
• 怎么写测试？

🚀 下一步

🧭 没找到答案？

若以上 FAQ 都没覆盖你的问题，可以：

• 📖 翻 指南 系统学习概念
• 🍳 看 Cookbook 找场景化示例
• 🐛 在 GitHub Issues 提问

📋 全部 FAQ 速查清单

按分类汇总，方便 Ctrl+F 检索：

📦 配额与认证：免费额度 · 必须用 Key · JSONP 带 Key · 密钥管理

🌐 IP 与格式：IPv6 支持 · 私有 IP 报错 · 格式选择 · hostname 为空

⚙️ 客户端与并发：复用 Client · 并发安全 · 超时设置 · 重试次数 · 跳转限制 · 改基地址

🔄 批量与限流：批量端点 · 429 处理

🛡 错误处理：自定义错误处理器 · ErrXxx 与 APIError

🗂 字段：postal 类型 · LatLong 与 Latitude

🧪 测试：测试覆盖 · 怎么写测试

• 📖 看 指南
• 🍳 看 [Cookbook](../cookbook/