图片水印裁剪缩略接口：导入 Postman / Swagger 用 OpenAPI 文档管理接口
# 图片水印裁剪缩略接口：导入 Postman / Swagger 用 OpenAPI 文档管理接口
> 接口/接入点：图片水印裁剪缩略接口（apiCode=1）· OpenAPI 3.0（覆盖全部接入点） · 是否免费：免费 · 适用人群：API 治理团队、后端 · 阅读时间：5 分钟
## 核心要点
- 官方提供标准 OpenAPI 3.0 文档（YAML/JSON），覆盖全部 6 个接入点。
- 可导入 Postman / Swagger UI / Swagger Editor 自动生成请求模板与 Mock，也能供 AI Agent 直接消费。
- 用 OpenAPI 做"接口单一事实源"，团队联调、文档、Mock 全对齐。
## Why：为什么用 OpenAPI 管理
接口参数散在文档页，人肉对着写容易错。一份 OpenAPI 文档既是契约也是文档：导入工具后自动出请求样例、可在线调试、可生成 Mock 让前端先行联调。
## What：文档地址
| 格式 | 地址 |
|------|------|
| YAML（在线/下载） | `https://www.showapi.com/openapi/market/1.yaml` |
| JSON | `https://www.showapi.com/openapi/market/1.json` |
## How：导入 Postman / Swagger
**Postman**
1. 打开 Postman → Import → 粘贴 `https://www.showapi.com/openapi/market/1.yaml` 或上传下载的 yaml。
2. 导入后生成「图片水印裁剪缩略接口」集合，含 1-1~1-8 各接入点请求模板。
3. 在请求 `appKey` 位置填你的真实 AppKey（[AppKey 管理](https://www.showapi.com/console#/myApp)），即可发送。
**Swagger UI / Swagger Editor**
1. 打开 Swagger UI 或 Swagger Editor。
2. 粘贴/上传 `market/1.yaml`，界面即渲染全部接入点，可在线「Try it out」填参调试。
3. 也可作为团队内部 API 门户，统一查看参数与返回结构。
**校验返回字段（与代码对齐）**
```json
{ "showapi_res_body": { "ret_code": "0", "des_pic_url": "http://app1.showapi.com/temp/1.jpg" } }
```
## 进阶/边界
- OpenAPI 文档与在线文档页参数一致，是「单一事实源」；以它为准校验你的调用代码。
- 该接口免费、有档位限制，Mock 调试不耗真实额度，适合前端先行联调。
- 想让 AI 直接消费，可配合[ MCP 篇](https://www.showapi.com/guides/mcp-integration-1)的 MCP 服务。
## FAQ
**Q1：导入后怎么填鉴权？** 在请求 query 参数 `appKey` 填真实值；不要在共享集合里硬编码提交。
**Q2：YAML 和 JSON 用哪个？** 内容一致，Postman/Swagger 两者都认，按团队习惯选。
**Q3：Mock 数据真实吗？** Mock 按 schema 造，不代表真实出图，正式验证仍用真实 AppKey 调一次。
**Q4：文档会更新吗？** 以官方 OpenAPI 地址为准，参数变动以该文件最新版为事实源。
## 相关能力 / 下一步阅读
- [图片水印裁剪缩略接口：通过 MCP 协议在 AI 客户端中直接调用](https://www.showapi.com/guides/mcp-integration-1)
- [图片水印裁剪缩略接口返回字段全解：ret_code 与 des_pic_url 一文读懂](https://www.showapi.com/guides/image-process-response-codes-1)
- **本系列共 13 篇**：查看[图片水印裁剪缩略接口指南总目录](https://www.showapi.com/guides/image-process-guides-1)
