# 一物一码标签制作API ## 功能介绍 草料提供批量生码、标签制作的能力，你可以将草料二维码与企业的内部系统集成，作为整个企业信息化体系的组件。对接草料标签API后，可在自有系统或网页中，批量生成二维码标签，替代了将数据导出再导入草料平台批量生码的模式，更加高效便捷。 例如可对接产品、资产、溯源等自有管理系统，当有新增数据时，可根据规则自动拼接标签url，在系统里批量生成对应产品或资产标签，用于下载打印。 ![批量生成二维码标签](https://blogcdnimg.clewm.net/2023/11/image-1698821337352_16988213383853.png) 图片说明：展示某溯源管理系统中“茶叶·9月第20批”商品生成标签的完整流程：从点击“生成标签”触发API调用，到系统内直接显示带二维码的标签结果。 ## API调用方式 ### 调用私有样式 适用于调用账号下已保存的标签样式，例如基于草料提供的公共样式，设置过企业logo、标签背景色、字段数等。 在后台-「标签样式」目录下选择之前保存的我的标签样式，进入标签样式详情页，点击「API对接」，开启调用。调用时再根据需求传入不同的参数内容， 即可批量生成不同的标签图片。 ![调用私有样式示例](https://blogcdnimg.clewm.net/2023/08/image-1692783856092_16927838567829.png) 图片说明：这是“标签样式”管理页面，展示多种已创建的二维码/标签模板缩略图及基本信息，用于快速选择或新建标签样式。 [私有样式API接口文档](/help/integration-and-connection/label-api/api "**私有样式api接口文档**") ### 调用公共样式 适用于直接调用草料标签样式库中的公共样式。可在[标签样式库](https://cli.im/label "前往样式库")中，选择一个标签，直接获取标签编号，或者进入样式详情页，点击开通标签制作API。调用时再根据需求传入不同的参数内容， 即可批量生成不同的标签图片 ![调用公共样式示例](https://blogcdnimg.clewm.net/2023/11/image-1700631336604_17006313376686.png) 图片说明：人员卡模板详情页，展示医院护士工牌样式及批量制作、API调用等制作方式选项。 [公共样式API接口文档](/help/integration-and-connection/label-api/api2 "**公共样式api接口文档**") ## 调用流程及说明 ### 调用流程 ![调用流程图](https://blogcdnimg.clewm.net/2023/10/image-1698368753434_16983687539373.png) 图片说明：该图展示草料后台开通API后，通过私有/公共样式的两种调用路径对接系统并生成标签的流程示意。 ### 调用说明 1. Beta期间 开通API 的用户可长期免费调用； 2. API调用根据IP秒级并发30次，如需更高并发次数，可 [前往社区反馈](https://cli.im/community/minihome/mixflow/90 "社区反馈") 3. 如果标签API调用流程、速度等方面问题，可以 [前往社区反馈](https://cli.im/community/minihome/mixflow/90 "社区反馈") ，草料官方顾问和技术会定期查看并回复 ## 客户案例 ### 1. 第三方开发者，开发插件集成飞书多维表格 可利用草料标签API接口，开发相应插件，集成在自己的软件或者系统中，提供批量生成二维码标签的能力。 例如第三方开发者Ryan Cui基于标签API开发的「草料二维码」插件，已经在飞书多维表格提供。通过插件，用户在飞书多维表格中可直接选择标签样式，匹配字段，将会自动调用草料的标签API，批量生成二维码标签。[了解详情](/help/integration-and-connection/third-party-integration/feishu-plugin "飞书插件") 效果演示： ![二维码生成效果演示](https://blogcdnimg.clewm.net/2023/09/111_16952671050634.gif?x-oss-process=) 图片说明：飞书审批产品需求导出界面，展示“卡点需求”表格及右侧插件配置面板，支持生成二维码并设置存储与返回字段。 ### 2. 某车友社区，将API内嵌网页，实时生成标签 可在现有系统或网页中接入草料标签API，标签图将会自动生成插入。新增数据时，可自动调用草料标签API，将指定的内容生成二维码标签展示。 例如某车友社区平台，调用草料标签API，将微信群地址生成二维码标签，插入社区网页中，无需另外生成标签后再上传，更加高效便捷。 ![车友社区标签生成](https://blogcdnimg.clewm.net/2023/10/image-1698218056751_16982180578545.png) 图片说明：展示标签API内嵌网页与用户访问网页时实时生成标签的两种场景，说明内容自动标签插入与扫码入群标签生成的联动机制。