# 二维码生成和识别：产品溯源与线上点餐场景集成
> 接口/接入点：二维码生成和识别（apiCode=887，生成 887-1 / 识别 887-2~4）· 是否免费：是 · 返回格式：JSON · 适用人群：零售、餐饮、供应链从业者 · 阅读时间：约 5 分钟
## 核心要点
- 溯源码/点餐码 = 把商品或桌台标识编入 `content` 生成，贴到实物或桌面。
- 用户扫码后由你的系统按 `content` 展示溯源信息或点餐页；识别接入点可做"扫码核验"。
- 生成图 12h 清理，批量贴标需落盘（见[批量生成](https://www.showapi.com/guides/qrcode-batch-generate-887)与[保存策略](https://www.showapi.com/guides/qrcode-save-strategy-887)）。
## Why：溯源与点餐为什么用二维码
一物一码、一桌一码是低成本数字化入口：消费者扫码看产地/ Ingredients，食客扫码直接点餐。本接口免费即时出码，适合中小商户快速试点。
## What：两类集成
| 场景 | content 编码 | 识别用途 |
|------|-------------|---------|
| 产品溯源 | 商品唯一 ID / 溯源页链接 | 消费者扫码看信息 |
| 线上点餐 | 桌台号 / 点餐页链接 | 食客扫码点餐、店员核验 |
## How：批量出溯源码
```python
import requests
def make_trace_qr(sku_id):
url = f"https://shop.example.com/trace?sku={sku_id}"
resp = requests.post("https://route.showapi.com/887-1",
params={"appKey": "YOUR_APPKEY"},
data={"content": url, "size": "8", "imgExtName": "png"},
timeout=10)
body = resp.json()["showapi_res_body"]
if body.get("ret_code") != "0":
raise RuntimeError(body.get("msg"))
return body["imgUrl"] # 立即下载落盘！12h 清理
# 一批 SKU
for sku in ["SKU001", "SKU002", "SKU003"]:
print(sku, make_trace_qr(sku))
```
### 店员扫码核验（识别）
```python
import requests
# 用户桌码图片，用 887-3 传图链识别
resp = requests.post("https://route.showapi.com/887-3",
params={"appKey": "YOUR_APPKEY"},
data={"imgUrl": "https://cdn.example.com/qr/table12.png"}, timeout=10)
body = resp.json()["showapi_res_body"]
if body.get("ret_code") == "0":
print("桌台内容:", body["retText"]) # 即 content 原文
```
```bash
curl -X POST "https://route.showapi.com/887-1?appKey=YOUR_APPKEY" \
-H "content-type: application/x-www-form-urlencoded" \
-d "content=https%3A%2F%2Fshop.example.com%2Ftrace%3Fsku%3DSKU001&size=8&imgExtName=png"
```
## 进阶 / 边界
- **一物一码需落库**：content 与实物绑定关系存你自己的系统，二维码只是入口。
- **批量贴标**：大批量生成务必落盘并控并发（见[批量生成](https://www.showapi.com/guides/qrcode-batch-generate-887)）。
- **识别清晰度**：印刷/屏幕码需清晰，模糊会降低识别率（见[三种识别对比](https://www.showapi.com/guides/qrcode-recognition-compare-887)）。
## FAQ
**Q1：溯源信息存在哪？**
A：存在你的业务系统；二维码只编码一个跳转到溯源页的链接或商品 ID。
**Q2：一桌一码会冲突吗？**
A：不会，content 用唯一桌台号即可；识别返回原文供你系统区分。
**Q3：贴标前图片要自己存吗？**
A：要，ShowAPI 生成图 12h 清理，批量务必下载到自有存储。
**Q4：扫码点餐免费档位够吗？**
A：看门店量与调用频次，高峰前评估档位（见[档位说明](https://www.showapi.com/free-api)）。
## 相关能力 / 下一步阅读
- [二维码生成和识别：三种识别方式怎么选（上传 / 图片地址 / Base64）](https://www.showapi.com/guides/qrcode-recognition-compare-887)
- [二维码生成和识别：批量生成二维码的全链路设计](https://www.showapi.com/guides/qrcode-batch-generate-887)
- [二维码生成和识别：扫码支付与营销推广场景集成](https://www.showapi.com/guides/qrcode-payment-scene-887)
- **本系列共 12 篇**：查看[二维码生成和识别指南总目录](https://www.showapi.com/guides/qrcode-guides-887)
