导入 OpenAPI 文档：用 Apifox / Postman 管理坐标系转换接口
坐标系转换OpenAPIApifoxPostman接口治理 # 导入 OpenAPI 文档：用 Apifox / Postman 管理坐标系转换接口
> 接口：坐标系转换（apiCode=1252）· 免费 · 集成能力：OpenAPI 3.0 · 适用人群：API 治理团队、后端工程师 · 阅读时间：约 6 分钟
## TL;DR
- 坐标系转换提供标准 **OpenAPI 3.0** 文档（YAML + JSON），覆盖全部接入点。
- 下载后可直接导入 Apifox / Postman / Swagger UI，自动生成请求模板与 Mock。
- 适合做接口治理、团队协作、自动化测试。
## Why
当接口要交给团队多人使用、或纳入 CI 自动化测试时，一份机器可读的 OpenAPI 文档比口头说明可靠得多。本篇教你怎么把坐标系转换的 OpenAPI 文档接入常用工具，立刻拥有可调试、可 Mock、可文档化的接口资产。
## What
前置条件：准备 Apifox / Postman / Swagger UI 任一工具。
| 项 | 地址 |
|----|------|
| OpenAPI YAML（在线/下载） | `https://www.showapi.com/openapi/market/1252.yaml` |
| OpenAPI JSON | `https://www.showapi.com/openapi/market/1252.json` |
| 覆盖范围 | 本接口全部接入点 |
## How
**步骤 1：下载文档**：
```bash
curl -O "https://www.showapi.com/openapi/market/1252.yaml"
# 或 JSON
curl -O "https://www.showapi.com/openapi/market/1252.json"
```
**步骤 2：导入工具**：
- **Apifox**：项目内「导入」→ 选择 `1252.yaml` → 自动生成接口分组（含两个接入点）、请求参数与响应结构。
- **Postman**：Import → 选文件 → 生成 Collection，可直接填 AppKey 发请求。
- **Swagger UI**：`File → Import URL` 填入 YAML 地址，在线查看与调试。
**步骤 3：在工具里填 AppKey 并调试**。以 Apifox 为例，把 `appKey` 作为 query 参数填入你的真实 AppKey，对 `1252-1`（转换）或 `1252-2`（距离）发起请求即可。
Python 侧若要基于 OpenAPI 自动生成客户端，可用 openapi-generator：
```bash
openapi-generator-cli generate -i 1252.yaml -g python -o ./client
```
## 返回示例与解析
导入后，工具会按文档展示返回结构（节选）：
```json
{
"showapi_res_body": {
"from": "WGS84", "to": "GCJ02", "ret_code": 0,
"resultList": [
{ "input": [113.194329, 23.234704], "output": [113.19971018888167, 23.232115136208677] }
]
}
}
```
| 字段 | 说明 |
|------|------|
| `resultList[].output` | 转换后坐标（数组 [经度, 纬度]） |
| `ret_code` | 业务成功标识（示例 0） |
## 进阶 / 边界
- **覆盖全部接入点**：OpenAPI 文档同时包含接入点 1（转换）与接入点 2（距离）。
- **与 MCP 互补**：MCP 适合对话式调用，OpenAPI 适合工程化治理（见[通过 MCP 调用](https://www.showapi.com/guides/coord-convert-mcp-1252)）。
- **文档字段以官方 YAML 为准**：若发现参数表与示例类型不一致，以 OpenAPI 文档和返回示例为准。
## FAQ
**Q1：OpenAPI 文档包含哪些接入点？**
A：覆盖 apiCode=1252 全部接入点：坐标系转换与两点直线距离。
**Q2：支持哪些导入工具？**
A：Apifox、Postman、Swagger UI 等兼容 OpenAPI 3.0 的工具均可。
**Q3：下载地址是什么？**
A：YAML `https://www.showapi.com/openapi/market/1252.yaml`，JSON `https://www.showapi.com/openapi/market/1252.json`。
**Q4：能自动生成 SDK 吗？**
A：可以，使用 openapi-generator 等工具基于 YAML 生成 Python/Java 等客户端。
**Q5：AppKey 在哪里配？**
A：作为 query 参数 `appKey` 填入你的真实 AppKey（[AppKey 管理](https://www.showapi.com/console#/myApp)）。
## 相关能力 / 下一步阅读
- [通过 MCP 在 AI 客户端里直接调用坐标系转换](https://www.showapi.com/guides/coord-convert-mcp-1252)
- [坐标系转换：5 分钟接入，从第一条 WGS84→GCJ02 结果开始](https://www.showapi.com/guides/coord-convert-quickstart-1252)
- [坐标系转换：返回结构与 ret_code 全解（含批量 resultList 字段）](https://www.showapi.com/guides/coord-convert-response-1252)
- **本系列共 12 篇**：查看[坐标系转换指南总目录](https://www.showapi.com/guides/coord-convert-guides-1252)
