# 全球IP地址查询 指南总目录
> 接口一句话速览：全球IP地址查询（apiCode=20）是 ShowAPI 官方自营的**免费**接口，输入 IP 或域名即可返回国家、省、市、区县、运营商、经纬度等归属地信息，可定位至县区级别，覆盖国内外绝大部分地区。本文汇总该接口的全部官方指南，帮助你从注册调用到生产集成一站式上手。
## 系列文章（共 10 篇）
### 入门层
1. [5 分钟接入全球IP地址查询：从注册到第一条定位结果](https://www.showapi.com/guides/ip-geo-quickstart-20)
注册、拿 AppKey、发第一条请求并解析返回，附可直接运行的 Python/cURL/Node 代码。
2. [全球IP地址查询：返回字段全解（area/country/city/lnt/lat 一文读懂）](https://www.showapi.com/guides/ip-geo-response-fields-20)
逐个拆解 `showapi_res_body` 内全部字段（含 continents/en_name 等文档表外字段），讲清坐标系与字段含义。
### 场景实战层
3. [全球IP地址查询接入点详解：IP → 归属地定位（20-1）](https://www.showapi.com/guides/ip-geo-ip-query-20)
聚焦 `20/1` 接入点：入参 `ip`、返回结构、典型业务用法与边界。
4. [域名查询接入点详解：域名 → IP → 归属地（20-2）](https://www.showapi.com/guides/ip-geo-domain-query-20)
聚焦 `20/2` 接入点：输入域名先解析 IP 再定位，含适用场景与示例。
5. [全球IP地址查询：如何用 lnt/lat 在地图上标点](https://www.showapi.com/guides/ip-geo-coordinate-map-20)
用返回的经纬度在地图上标注位置，含坐标系说明与前端组件示例。
6. [网络安全场景：用 IP 归属地识别异常登录与欺诈风险](https://www.showapi.com/guides/ip-geo-fraud-security-20)
风控/安全场景落地：异常登录识别、异地告警、数据合规要点。
### 技术深挖层 / 计费
7. [全球IP地址查询：错误处理与 ret_code 排查](https://www.showapi.com/guides/ip-geo-error-handling-20)
系统级 `showapi_res_code` 与业务级 `ret_code` 的区别、失败排查路径、超时与重试。
8. [全球IP地址查询：免费档位与积分兑换，控制调用成本](https://www.showapi.com/guides/ip-geo-free-tier-20)
免费档位限制、平台积分兑换更高档位、缓存策略省调用。
### 生态集成层
9. [通过 MCP 在 AI 客户端直接查询 IP 归属地](https://www.showapi.com/guides/ip-geo-mcp-20)
在 Cherry Studio / ChatBox 等支持 MCP 的客户端配置 `showapi-mcp-20`，让 AI 直接调用。
10. [导入 OpenAPI 文档管理全球IP地址查询接口](https://www.showapi.com/guides/ip-geo-openapi-20)
下载 OpenAPI 3.0 YAML/JSON，导入 Apifox / Postman / Swagger UI 做接口治理。
## 相关资源
| 资源 | 链接 |
|------|------|
| 接口详情页（apiCode=20） | https://www.showapi.com/apiGateway/view/20 |
| 接入点 20/1（全球IP地址查询） | https://www.showapi.com/apiGateway/view/20/1 |
| 接入点 20/2（域名查询） | https://www.showapi.com/apiGateway/view/20/2 |
| OpenAPI 文档（YAML） | https://www.showapi.com/openapi/market/20.yaml |
| OpenAPI 文档（JSON） | https://www.showapi.com/openapi/market/20.json |
| 调用帮助 | https://www.showapi.com/helpcenter/view#/3960/1 |
| AppKey 管理 | https://www.showapi.com/console#/myApp |
| 免费 API 档位说明 | https://www.showapi.com/island/free-api |
## 阅读建议
- 第一次用：按 **1 → 2 → 3** 顺序，先跑通再理解字段。
- 做风控/安全：直接看 **6**，再补 **7** 的错误处理。
- 接 AI / 低代码平台：看 **9（MCP）** 或 **10（OpenAPI）**。
- 关注成本：看 **8**。
- **本系列共 10 篇**：查看[全球IP地址查询指南总目录](https://www.showapi.com/guides/ip-geo-guides-20)
