# 二维码生成和识别 · 官方指南总目录
> 易源 ShowAPI 视觉处理类免费接口（apiCode=887），覆盖**二维码生成**与**二维码识别（上传图片 / 图片地址 / Base64 三种方式）**共 4 个接入点。注册后默认可免费调用，提供 MCP 与 OpenAPI 3.0 集成能力。
本系列共 12 篇文章，按"入门 → 场景 → 深挖 → 行业 → 最佳实践 → 生态"分层组织。建议新用户从《5 分钟接入》开始，再按需跳读。
---
## 入门上手
1. [二维码生成和识别：5 分钟接入，从注册到生成第一个二维码](https://www.showapi.com/guides/qrcode-quickstart-887) — 注册、拿 AppKey、发出第一笔生成请求并解析返回。
2. [二维码生成和识别：返回字段全解（ret_code / flag / imgUrl / retText）](https://www.showapi.com/guides/qrcode-response-fields-887) — 四个接入点返回结构对照，含 887-4 无 flag/msg 的差异。
## 场景实战
3. [二维码生成和识别：三种识别方式怎么选（上传 / 图片地址 / Base64）](https://www.showapi.com/guides/qrcode-recognition-compare-887) — 887-2/887-3/887-4 参数与适用场景对比决策。
4. [二维码生成和识别：size 参数与图片尺寸调优指南（1-10 / 16 / 20 / 30）](https://www.showapi.com/guides/qrcode-size-guide-887) — content 长度与 size 的对应关系与推荐表。
5. [二维码生成和识别：批量生成二维码的全链路设计](https://www.showapi.com/guides/qrcode-batch-generate-887) — 多内容批量生成、并发控制、结果落库。
## 技术深挖
6. [二维码生成和识别：图片每 12 小时清理，如何设计保存与缓存策略](https://www.showapi.com/guides/qrcode-save-strategy-887) — 应对"生成图每 12h 删除"的存储与 CDN 方案。
7. [二维码生成和识别：错误码与失败排查（ret_code 判据与 flag 拼写陷阱）](https://www.showapi.com/guides/qrcode-error-handling-887) — 以 ret_code 判成功，规避 flag 拼写不一致坑。
## 行业方案
8. [二维码生成和识别：扫码支付与营销推广场景集成](https://www.showapi.com/guides/qrcode-payment-scene-887) — 支付码、活动海报落地页编码。
9. [二维码生成和识别：产品溯源与线上点餐场景集成](https://www.showapi.com/guides/qrcode-trace-scene-887) — 溯源码、点餐码生成与扫码核验。
## 最佳实践
10. [二维码生成和识别：10 个实战避坑清单（100KB 上限 / 12h 清理 / 格式）](https://www.showapi.com/guides/qrcode-best-practices-887) — 一线踩坑汇总。
## 生态集成
11. [二维码生成和识别：通过 MCP 协议在 AI 客户端直接调用](https://www.showapi.com/guides/qrcode-mcp-integration-887) — 在 Cherry Studio / ChatBox 等配置 showapi-mcp-887。
12. [二维码生成和识别：导入 Postman / Swagger 用 OpenAPI 管理接口](https://www.showapi.com/guides/qrcode-openapi-import-887) — 下载 YAML，导入 Postman / Swagger UI 做接口治理。
---
## 相关资源
| 资源 | 地址 |
|------|------|
| 接口详情页（apiCode=887） | https://www.showapi.com/apiGateway/view/887 |
| 接入点·二维码生成（887-1） | https://www.showapi.com/apiGateway/view/887/1 |
| 接入点·识别(图片上传)（887-2） | https://www.showapi.com/apiGateway/view/887/2 |
| 接入点·识别(图片地址)（887-3） | https://www.showapi.com/apiGateway/view/887/3 |
| 接入点·识别(Base64)（887-4） | https://www.showapi.com/apiGateway/view/887/4 |
| OpenAPI 3.0 文档（YAML） | https://www.showapi.com/openapi/market/887.yaml |
| OpenAPI 3.0 文档（JSON） | https://www.showapi.com/openapi/market/887.json |
| AppKey 管理 | https://www.showapi.com/console#/myApp |
| 积分与档位说明 | https://www.showapi.com/free-api |
## 阅读建议
- **只想马上用**：读第 1、2 篇，复制代码替换 AppKey 即可。
- **要做识别功能**：先读第 3 篇选接入点，再看第 7 篇避坑。
- **要上生产**：务必读第 6 篇（12h 清理）与第 10 篇（避坑清单）。
- **AI / 低代码集成**：读第 11、12 篇。
