核心概念

接口和 AI 工具里反复出现的就是下面五个对象。第一次接触草料，可以先看了解草料二维码。

组织
└─ 分区
   ├─ 码（单独创建的活码）
   └─ 批量模板
      └─ 子码（一物一码，内容各不相同）

表单可以关联到码上，每次填写产生一条记录

码

活码的内容存在草料，打印后还能修改，也能统计扫码、关联表单。静态码把文本或网址直接编码进图案，创建后不能修改，也没有扫码统计。

接口里用 coding 标识一张活码，大多数读取接口也接受完整的码链接。见活码列表、活码内容。

批量模板与子码

有一批结构相同、内容不同的东西（设备、资产、人员）时，先建一个批量模板，定义所有子码共有的固定内容和每个子码要填的字段，再按模板生成子码，实现一物一码。

批量模板本身也有一个 coding，模板相关接口的 template 参数传的就是它。见模板列表、子码内容。

表单与记录

表单定义要收集哪些字段，关联到码上后，扫码的人就能填写。每次提交产生一条记录。

字段	含义
tpl_id	表单模板 ID，用来读表单结构、筛选记录
code_id	码的数字 ID，提交记录时和 tpl_id 一起传
record_id	单条记录的 ID

调用顺序见查二维码关联的表单和记录。

分区

分区把码和记录按部门、项目或场地分开管理，也是统计分组和范围过滤的维度。接口里叫 project，见分区列表。

组织

组织是数据和权限的边界。OpenAPI Key 归属于组织，只能访问这个组织的数据；MCP 通过 OAuth 授权时选择组织，能看到和操作的范围仍受当前账号权限限制。见鉴权、开发者接入。