金店参考价格：导入 Postman / Swagger 用 OpenAPI 文档管理接口
# 金店参考价格：导入 Postman / Swagger 用 OpenAPI 文档管理接口
> 接口 2145（金店参考价格）· 免费 · OpenAPI 3.0 · 适用人群：API 治理团队 · 阅读时间约 3 分钟
## 核心要点
- 官方提供接口级 OpenAPI 3.0 文档，覆盖全部接入点。
- 下载 YAML 后可导入 Postman / Swagger UI（或 Swagger Editor）管理与调试。
- 文档地址：https://www.showapi.com/openapi/market/2145.yaml
## Why：这跟我有什么关系
做 API 治理或团队协作时，一份标准的 OpenAPI 文档比口口相传更高效。金店参考价格提供官方 OpenAPI 3.0，可直接导入主流工具。
## What：前置条件与接口速览
**文档信息**
| 项 | 值 |
|---|---|
| 规范 | OpenAPI 3.0 |
| 覆盖范围 | 全部接入点（2145-1、2145-2） |
| YAML 地址 | `https://www.showapi.com/openapi/market/2145.yaml` |
| JSON 地址 | 同路径 `.json`（页面「查看 JSON」） |
> 注：本文使用 **Postman / Swagger UI / Swagger Editor** 表述接口导入与调试。
## How：接入步骤
**导入步骤（以 Postman 为例）**
1. 打开 Postman → 选择「Import」。
2. 粘贴 YAML 地址 `https://www.showapi.com/openapi/market/2145.yaml` 或上传下载的文件。
3. 导入后自动生成两个接入点的请求模板，填入 AppKey 即可调试。
4. 也可在 Swagger UI / Swagger Editor 中打开同一份 YAML 做可视化调试与 Mock。
**校验 AppKey**
```
请求任意接入点时，query 参数 appKey 填你的真实 AppKey（在 AppKey 管理中获取）。
```
## 返回示例与解析
**文档能帮你做什么**
- 自动生成请求模板，省去手写参数。
- 在 Swagger UI 中直接 try-it-out 调试。
- 作为团队接口契约，纳入代码仓库版本管理。
返回字段与状态码以[返回字段全解](https://www.showapi.com/guides/gold-price-response-codes-2145) 为准。
## 进阶 / 边界
- OpenAPI 文档覆盖全部接入点，无需分别导入。
- 用 Postman / Swagger UI / Swagger Editor 管理即可。
- 文档由官方维护，接口更新后建议重新拉取最新 YAML。
## FAQ
**Q：OpenAPI 文档包含两个接入点吗？**
包含。官方 OpenAPI 3.0 文档覆盖本接口全部接入点（支持金店 + 最新价格）。
**Q：没有 Swagger 环境能调试吗？**
能。Postman 导入同一份 YAML 即可生成请求模板并调试，二选一即可。
**Q：文档会过期吗？**
接口调整时官方会更新 YAML，建议定期重新拉取以对齐最新字段。
## 相关能力 / 下一步阅读
- [金店参考价格：通过 MCP 在 AI 客户端直接查金价](https://www.showapi.com/guides/gold-price-mcp-2145)
- [金店参考价格：多语言调用示例](https://www.showapi.com/guides/gold-price-code-examples-2145)
- [金店参考价格：返回字段与状态码全解](https://www.showapi.com/guides/gold-price-response-codes-2145)
- **本系列共 12 篇**：查看[金店参考价格 · 官方指南总目录](https://www.showapi.com/guides/gold-price-guides-2145)
