数据API功能
草料二维码提供多种数据对接方式，支持通过 Webhook、官方数据库、自有数据库等方式，将草料平台的业务数据自动同步到企业现有系统或数据库，用于数据分析、制作可视化报表，以及与其他业务系统对接。
如果需要从外部系统向草料写入数据，也可以使用 OpenAPI V2，通过接口向草料表单提交记录，实现系统间的数据交互。
除了 API 对接，还可以通过草料二维码 MCP，在 WorkBuddy、千问办公、豆包工作等 AI 中直接使用草料功能。不仅能通过对话查询和分析业务数据、生成报表，还支持创建二维码、搭建表单、配置周期任务等操作，让 AI 参与业务应用的搭建与管理。
| 推送方式 | 功能说明 | 推送内容 |
|---|---|---|
| Webhook | 将表单数据以JSON格式推送到你指定的URL | 新提交表单数据、修改表单数据、表单审核结果通知、标记处理进度。*暂不支持其他数据推送 |
| 官方数据库 | 每个用户账号都有独立的云数据库，开通后数据库会同步草料账号后台的数据 | 提供码的基本信息、表单数据、批量子码、码的状态、计划完成情况和待办当前数据等数据表 |
| 自有数据库 | 将数据实时推送至你的企业数据库内（仅支持 MySQL 5.7 版） | 同官方数据库，提供码的基本信息、表单数据、批量子码、码的状态、计划完成情况和待办当前数据等数据表 |
| 群机器人（企业微信、钉钉、飞书） | 表单数据填写并提交后，这些信息可以立即通过企业微信、钉钉或飞书自动推送到相应的群聊中 | 新提交表单数据、修改表单数据、表单审核结果通知、标记处理进度。 |
| 同步到腾讯文档 | 表单数据可实时同步到腾讯文档的智能表格 | 新提交表单数据、修改表单数据、表单审核结果通知、标记处理进度。 |
处理进度留痕与待办数据库同步
| 数据 | 同步说明 | 详细文档 |
|---|---|---|
| 处理进度备注和附件 | 启用官方数据库同步后，随本次进度动态写入 record_review_data，无需另开留痕同步开关；本次改进不自动补齐全部历史留痕 | 字段与附件格式 |
| 待办当前数据 | 官方数据库和自有数据库均支持，写入 base_todo；包含当前可见的待完成、已完成待办，同一待办覆盖更新 | 待办字段与同步规则 |
以上均以配置并启用数据库同步、数据属于已有同步范围为前提。待办数据库同步无需逐项勾选独立推送时机，与人员通知、群机器人通知是不同机制。这些规则不代表 Webhook 或群机器人也支持相同的数据结构。
如需在导出的报告中展示关联待办和完成记录，使用的是另一项能力：Word 自定义模板中的待办变量。数据库列与 Word 变量不能直接互换。
应用场景
1. 通过群机器人推送到企业微信、钉钉、飞书群聊
在草料制作的表单中，填表人扫码填写并提交数据后，这些信息可以立即通过企业微信、钉钉或飞书自动推送到相应的群聊中，实现即时共享和沟通，提升团队协作效率。了解详情
2. 表单数据同步到腾讯文档
可将草料的数据实时同步到腾讯文档的智能表格中，开通后将表单历史数据同步推送，后续提交的记录实时同步到腾讯文档，也可搭建数据看板，实现即时共享数据。了解详情
3. 连接 WPS、飞书等多维表格，自由应用数据
开启【官方数据库】功能，用 WPS、飞书等多维表格连接草料官方数据库，可自由应用数据，搭建自己想要的看板内容。
4. 连接 BI 数据分析工具，制作实时数据报表
开启【官方数据库】功能，用数据分析工具连接草料官方数据库，进行数据分析或报表制作。查看效果与制作教程
数据推送方式
可任选推送方式免费开通，行业专属版不限数据推送条数，旗舰版限20000条/月，免费版和其他付费版限1000条/月。
1. Webhook 方式
草料二维码将表单数据以 JSON 格式推送到你指定的 URL，这个地址需要允许公网访问。后续你可以编写程序，用接收到的数据对接其他系统或流程。查看Webhook说明
Webhook 推送内容
新提交表单数据、修改表单数据、表单审核结果通知、标记处理进度。
目前暂不支持其他数据推送。
Webhook 开通方法
草料后台找到【高级功能】-【数据API】，选择【Webhook】进行开通，填入接收数据的URL地址，选择需要推送的表单并保存。开通后，新产生的数据会进行推送。
2. 官方数据库
草料二维码给每个用户提供了独立的云数据库，开通后同步你后台的数据。后续可以用数据分析软件连接这个云数据库，制作数据报表。
官方数据库推送内容
提供码的基本信息、表单数据、批量子码、码的状态、计划完成情况和待办当前数据等数据表，查看数据库字段说明
官方数据库开通方法
草料后台导航栏【高级功能】-【数据API】，选择【官方数据库】。填写申请信息后，会自动开通该功能，并推送数据。首次同步需要处理已有数据，完成时间取决于数据量和同步进度。
3. 自有数据库
草料二维码实时将数据推送至你提供的企业数据库（仅支持 MySQL 5.7 版），无需建表、需开放公网访问权限。后续你可以自由读取数据，实现企业数据信息整合。
自有数据库推送内容
同样提供码的基本信息、表单数据、批量子码、码的状态、计划完成情况和待办当前数据等数据表，查看数据库字段说明
自有数据库开通方法
草料后台导航栏【高级功能】-【数据API】，选择【自有数据库】，填入你的数据库主机、端口、账号等信息。
4. 群机器人
表单数据填写并提交后，这些信息可以立即通过企业微信、钉钉或飞书自动推送到相应的群聊中，实现即时共享和沟通，提升团队协作效率。查看设置教程
5. 同步到腾讯文档
表单数据可实时同步到腾讯文档的智能表格中。开通后，会自动在绑定的腾讯文档账号下创建一个智能表格，且将表单历史数据同步推送，后续提交的记录实时同步到腾讯文档，实现即时共享数据。查看设置教程
数据推送条数的版本区别
不同的版本每月推送账号下的动态数据条数不同：
- 免费版、基础版、高级版：每月推送前1000条动态数据
- 旗舰版：每月推送前20,000条动态数据
- 行业专属版：每月推送条数不限
待办当前态同步事件不计入数据 API 推送条数配额；其他数据同步和服务费用不因此免除。
学习交流
更多数据报表、数据API等问题，可以 前往草料社区 与数据报表大牛互助交流，草料官方顾问和技术也会定期查看并回复