免费地震信息：导入 Postman / Swagger UI 用 OpenAPI 管理接口
地震信息OpenAPIPostmanSwagger # 免费地震信息：导入 Postman / Swagger UI 用 OpenAPI 管理接口
- **接口/接入点**：免费地震信息 · 2274-1
- **是否免费**：是（注册即免费额度）
- **请求方式**：POST / GET（OpenAPI 3.0 描述）
- **返回格式**：JSON
- **适用人群**：注重 API 治理的团队、后端工程师
- **阅读时间**：约 6 分钟
## 核心要点
- 接口官方提供标准 OpenAPI 3.0 文档（YAML / JSON），可一键导入 API 工具做请求模板、Mock 与团队协作。
- 推荐导入 **Postman** 或 **Swagger UI / Swagger Editor** 管理接口（本文不使用 Apifox）。
- OpenAPI 覆盖本接口全部接入点，适合纳入你们的 API 资产目录统一治理。
## Why：把接口放进你的 API 资产库
当团队接的接口越来越多，散落的 curl 片段没人维护。把免费地震信息纳入 OpenAPI 体系，新人导入即可看到参数、示例与响应结构，还能生成 Mock 做前端联调——治理成本直接降下来。
## What：接口速览
| 项 | 值 |
|----|----|
| 接口地址 | `https://route.showapi.com/2274-1?appKey={your_appKey}` |
| OpenAPI 文档 | [YAML](https://www.showapi.com/openapi/market/2274.yaml) ｜ [JSON](https://www.showapi.com/openapi/market/2274.json) |
| 文档版本 | OpenAPI 3.0.3 |
| 计费 | 免费（档位限制见 [免费 API 说明](https://www.showapi.com/free-api)） |
## How：导入 Postman / Swagger UI
### 方式一：Postman
1. 打开 Postman，选择「Import」→「Link」或「File」。
2. 填入 OpenAPI 地址：`https://www.showapi.com/openapi/market/2274.yaml`（或下载 YAML 后选文件导入）。
3. 导入后自动生成 `POST /2274-1` 请求，参数 `date`、`area` 与 `appKey` 已就绪；填入你的 AppKey 即可发请求。
### 方式二：Swagger UI / Swagger Editor
1. 打开 Swagger Editor（或自托管 Swagger UI）。
2. 通过「File → Import URL」粘贴：`https://www.showapi.com/openapi/market/2274.yaml`。
3. 文档会渲染出 `POST /2274-1` 的交互式调试面板，可直接 Try it out 填参调用、生成 Mock。
> 说明：本文使用 Postman / Swagger UI 作为导入与调试工具；不使用 Apifox，也不以任何 Apifox 相关主题撰写文章。
## 返回示例与解析
OpenAPI 描述的关键片段（节选自官方 YAML）：
```yaml
paths:
/2274-1:
post:
parameters:
- name: date
in: query
description: 要查询的地震发生的日期（北京时间）格式为yyyyMMdd
required: false
schema: { type: string }
- name: area
in: query
description: 要查询的地震发生的地区，可填入省名，例如：云南
required: false
schema: { type: string }
```
注意参数 `required: false`（均为选填）；`area` 的「按省名筛选」能力以接口实际返回为准（实测见 [参数使用指南](https://www.showapi.com/guides/earthquake-info-params-guide-2274)）。
## 进阶 / 边界
- **用 OpenAPI 生成代码**：多数工具支持从 YAML 生成 Python/Java/TS 客户端 SDK，纳入你们代码库统一管理。
- **Mock 联调**：前端可基于 OpenAPI 的 `example` 生成 Mock 服务，不等后端就能开发列表/地图页面。
- **area 参数**：导入后别被文档「省名筛选」描述误导，生产逻辑仍以 `date` 为主、客户端按 `location` 过滤。
## FAQ
**Q1：OpenAPI 文档覆盖哪些接入点？**
覆盖本接口全部接入点（当前为 2274-1）。如后续新增接入点，以官方 YAML 最新版本为准。
**Q2：能用它自动生成请求代码吗？**
能。Postman / Swagger Codegen / openapi-generator 等都支持从这份 YAML 生成多语言客户端，适合纳入团队 API 资产。
**Q3：为什么不用 Apifox？**
本文按规范使用 Postman / Swagger UI 管理接口，不采用 Apifox 相关工具与主题。
**Q4：Mock 出来的数据能当真实数据用吗？**
不能。Mock 只是结构示例，用于前端联调；真实数据仍需调用接口（消耗免费额度，注意频率）。
## 相关能力 / 下一步阅读
- [免费地震信息：5 分钟从注册到调通第一条地震记录](https://www.showapi.com/guides/earthquake-info-quickstart-2274)
- [免费地震信息：返回字段全解（ret_code / mag / from 一文读懂）](https://www.showapi.com/guides/earthquake-info-response-fields-2274)
- [免费地震信息：通过 MCP 在 AI 客户端直接查询地震数据](https://www.showapi.com/guides/earthquake-info-mcp-integration-2274)
- **本系列共 14 篇**：查看[免费地震信息指南总目录](https://www.showapi.com/guides/earthquake-info-guides-2274)
