导入 Postman / Swagger：用 OpenAPI 文档管理汉字多功能转换器接口
汉字多功能转换器汉字转拼音简繁转换全角半角地址分词 # 导入 Postman / Swagger：用 OpenAPI 文档管理汉字多功能转换器接口
> 接口/接入点：汉字多功能转换器（apiCode=99）· 集成方式：OpenAPI 3.0 文档（接口级，覆盖全部 6 接入点）· 适用：注重 API 治理的团队 · 阅读时间：约 6 分钟
## 核心要点
- 官方提供标准 OpenAPI 3.0 文档，覆盖本接口全部 6 个接入点，可下载 YAML 或在线查看 JSON。
- 文档地址：`https://www.showapi.com/openapi/market/99.yaml`。
- 可导入 **Postman / Swagger UI / Swagger Editor** 生成请求模板与 Mock，便于团队协作与接口治理。
## Why：为什么用 OpenAPI 管理接口
当团队多人协作、需要统一请求示例、做 Mock 联调或纳入 API 网关治理时，把接口定义成一份 OpenAPI 文档比口口相传更可靠。本接口官方已生成好 OpenAPI 3.0，省去你手写 Schema 的成本。
## What：OpenAPI 文档速览
| 项 | 说明 |
|----|------|
| 规范 | OpenAPI 3.0 |
| 覆盖范围 | 本接口全部 6 个接入点 |
| YAML 地址 | `https://www.showapi.com/openapi/market/99.yaml` |
| 在线 JSON | 同文档页「查看 JSON」 |
| 适用工具 | Postman / Swagger UI / Swagger Editor |
## How：导入与生成请求模板
**方式一：Swagger UI / Swagger Editor**
1. 打开 Swagger Editor（或任意 Swagger UI 实例）。
2. 选择「File → Import URL」，填入 `https://www.showapi.com/openapi/market/99.yaml`。
3. 文档加载后，每个接入点（99-38 / 99-113 … 99-117）都可展开直接「Try it out」，自动生成带 `appKey` 参数的请求。
**方式二：Postman**
1. 下载 YAML 到本地。
2. Postman 中选择「Import → File」，选择该 YAML，Postman 会解析为带各接入点的请求集合。
3. 在请求的 `appKey` 参数处填入你的真实 AppKey 即可发起调用。
> 说明：OpenAPI 文档由 ShowAPI 官方生成（生成时间见文件头 `generated-at`），覆盖全部接入点的路径、参数与响应 Schema，是比手写示例更权威的单一事实来源。
## 返回示例与解析
导入后，`/99-38`（汉字转拼音）的响应 Schema 会明确：
```json
{ "showapi_res_code": 0, "showapi_res_body": { "data": "ni hao", "simpleData": "n h", "flag": "true" } }
```
而 `/99-117`（地址分词）则描述为 `ret_code`/`msg`/`result`，差异在文档中一目了然，避免解析时张冠李戴。
## 进阶/边界
- 注意地址分词接入点在文档中参数名为 `addr`（query），与其它接入点的 `content` 不同；导入后请按 Schema 填参。
- 免费接口有档次限制，Mock/联调时请控制频率，正式接入前确认档位是否满足。
- 文档是治理入口，建议纳入团队 API 目录统一版本管理。
## FAQ
**Q1：OpenAPI 文档包含全部 6 个接入点吗？**
包含，且每个接入点的路径、参数、响应 Schema 都有定义。
**Q2：为什么用 Postman / Swagger，而不是其它工具？**
官方文档为标准 OpenAPI 3.0，Postman / Swagger UI / Swagger Editor 都能直接消费；任选其一即可。
**Q3：文档里的参数和我实际调用对不上？**
以官方 OpenAPI 文档为准（生成于 2026-08-26），若发现差异以接口实际返回为最终判断。
**Q4：地址分词在文档里也叫 addr 吗？**
是，文档中地址分词使用 `addr`（query 参数），与其它接入点的 `content` 不同。
## 相关能力 / 下一步阅读
- [通过 MCP 在 AI 客户端直接调用汉字多功能转换器](https://www.showapi.com/guides/hanzi-converter-mcp-99)
- [汉字多功能转换器返回字段全解：data / simpleData / flag 与系统级 showapi_res_code](https://www.showapi.com/guides/hanzi-converter-response-fields-99)
- [汉字多功能转换器：地址分词实战（物流/地图场景的地址智能切分）](https://www.showapi.com/guides/hanzi-address-segment-99)
- **本系列共 12 篇**：查看[汉字多功能转换器指南总目录](https://www.showapi.com/guides/hanzi-converter-guides-99)
