获取外网IP：导入 Postman / Swagger 用 OpenAPI 文档管理接口
获取外网IPOpenAPIPostmanSwaggerAPI治理 # 获取外网IP：导入 Postman / Swagger 用 OpenAPI 文档管理接口
> 接口：获取外网IP（apiCode 632，接入点 1） · 免费 · 提供 OpenAPI 3.0 文档 · 适用：API 治理团队 · 阅读约 5 分钟
## 核心要点
- 获取外网IP 提供标准 OpenAPI 3.0 文档（YAML/JSON），可导入 Postman / Swagger UI 管理。
- 导入后可自动生成请求模板、参数说明与 Mock，便于团队统一调试与文档化。
- 文档地址固定：`https://www.showapi.com/openapi/market/632.yaml`（或 `.json`）。
## Why：把接口纳管进你的工具链
当团队接入多个 API，最怕"文档散落、示例各写各的"。把获取外网IP 的 OpenAPI 文档导入你们已有的 Postman / Swagger 体系，能一次性得到结构化请求模板、字段说明和可分享的调试环境，新成员照着就能调。
## What：OpenAPI 资源速览
| 项 | 值 |
|----|----|
| 文档标准 | OpenAPI 3.0 |
| 覆盖范围 | 接口 632 全部接入点 |
| YAML 在线 | https://www.showapi.com/openapi/market/632.yaml |
| JSON 在线 | https://www.showapi.com/openapi/market/632.json |
| 适用工具 | Postman、Swagger UI、Swagger Editor，以及支持 OpenAPI 的 AI Agent |
## How：导入 Postman / Swagger UI
### 方式一 · 导入 Postman
1. 打开 Postman，选择「Import」。
2. 粘贴链接 `https://www.showapi.com/openapi/market/632.yaml`，或先下载 YAML 再选择文件导入。
3. 导入后 Postman 自动生成 `632-1` 请求，填入你的 `appKey` 即可发送。
4. 在团队 Workspace 共享该 Collection，统一调试口径。
### 方式二 · 用 Swagger UI / Swagger Editor 查看
- Swagger Editor：打开 `https://www.showapi.com/openapi/market/632.yaml`，实时渲染接口结构与示例。
- Swagger UI：把 YAML 托管到你的 Swagger UI 实例，团队即可在浏览器里直接试调。
### 下载备用
```bash
curl -O https://www.showapi.com/openapi/market/632.yaml
curl -O https://www.showapi.com/openapi/market/632.json
```
## 返回示例与解析
OpenAPI 文档内已包含返回结构示意，与直接调用一致：
```json
{
"showapi_res_code": 0,
"showapi_res_body": {
"ip": "183.225.1.165",
"region": "云南",
"city": "昆明",
"isp": "移动",
"lnt": "102.712251",
"lat": "25.040609"
}
}
```
字段语义以[返回字段全解](https://www.showapi.com/guides/getip-fields-632)为准（注意 `en_name_short` 是国家短码、`lat`/`lnt` 是经纬度）。
## 进阶 / 边界
- **Mock 数据**：Swagger UI / Postman 可基于 OpenAPI 生成 Mock，适合前端联调；但 Mock 不等于真实返回，上线前务必用真实 AppKey 跑一次。
- **文档与实接口一致性**：OpenAPI 由易源维护；若发现字段与[返回字段全解](https://www.showapi.com/guides/getip-fields-632)不一致，以真实返回为准并向官方反馈。
- **AppKey 不入文档**：OpenAPI 文件不含你的 AppKey，调用时在请求里单独填入。
## FAQ
**Q：OpenAPI 文档能直接给 AI Agent 用吗？**
A：可以。OpenAPI 3.0 是机器可读契约，支持的工具（含部分 AI Agent 框架）可直接消费，自动生成调用参数。
**Q：导入后字段和官网示例对不上？**
A：以真实返回为准。已知官网对 `en_name_short`/`lat` 的描述有歧义，已在[返回字段全解](https://www.showapi.com/guides/getip-fields-632)修正。
**Q：YAML 和 JSON 用哪个？**
A：等价，看你的工具链偏好。Postman 两者都支持，Swagger Editor 常用 YAML。
**Q：文档会随接口更新吗？**
A：OpenAPI 由易源维护，一般随接口变更更新；重大调整以接口详情页公告为准。
## 相关能力 / 下一步阅读
- [获取外网IP：5 分钟从注册到拿到第一条公网 IP 与归属地](https://www.showapi.com/guides/getip-quickstart-632)
- [获取外网IP：通过 MCP 在 AI 客户端直接查询访问者 IP](https://www.showapi.com/guides/getip-mcp-632)
- **本系列共 8 篇**：查看[获取外网IP 指南总目录](https://www.showapi.com/guides/getip-guides-632)
