# API 典型场景

本页按业务目标整理 API 的常见接入链路。若你已经知道要调用哪个接口，可直接返回 [API 概述](https://cli.im/open-api/openapi/v2/overview.md) 查看接口分类索引。

## 场景目录

### 读取类场景

- [查询二维码关联表单和记录](https://cli.im/open-api/openapi/v2/scenarios/query-qrcode-records.md)：从二维码出发，依次拿到 `code_id`、`tpl_id`，再读取表单结构和记录列表

### 写入类场景

- [向指定二维码下的表单提交记录](https://cli.im/open-api/openapi/v2/scenarios/add-record-by-qrcode.md)：先定位目标二维码和表单，再按结构化字段 ID 组装 `fields[]`
- [Excel 批量新增记录](https://cli.im/open-api/openapi/v2/scenarios/bulk-import-records.md)：本地解析 Excel 后，逐行调用 `addRecord` 实现批量导入

### 管理类场景

下面三个场景需要[个人 API Key](https://cli.im/open-api/openapi/v2/auth.md#create-key)，组织 Key 不能调用。

- [按模板批量生成二维码](https://cli.im/open-api/openapi/v2/scenarios/batch-create-qrcodes.md)：取模板字段，上传图片附件，预校验后提交任务，再逐项取回码 ID 和链接
- [修改和删除码、表单](https://cli.im/open-api/openapi/v2/scenarios/edit-and-delete.md)：修改前读取版本，删除前预览并凭确认令牌执行
- [导出可打印的标签](https://cli.im/open-api/openapi/v2/scenarios/export-labels.md)：按码当前的标签样式预览并导出 PDF 或图片包

## 阅读建议

- 不确定鉴权方式：先看 [鉴权](https://cli.im/open-api/openapi/v2/auth.md)
- 需要接口字段、Schema 或完整示例：从场景页跳转到对应接口页继续查看
- 想看全部接口和各自需要的权限：看[接口清单](https://cli.im/open-api/openapi/v2/api-index.md)
- 需要代码生成或导入调试工具：直接使用 `https://open.cli.im/openapi.json`
