# 数据API功能

草料提供3种数据对接方式，可以将草料平台的数据自动推送给你，实现数据分析、制作可视化报表、对接其他系统等。目前暂不支持将外部系统的数据写入草料。

- Webhook：将表单数据以JSON格式推送到你指定的URL；推送内容：新提交表单数据、修改表单数据、表单审核结果通知、标记处理进度。*暂不支持其他数据推送
- 官方数据库：每个用户账号都有独立的云数据库，开通后数据库会同步草料账号后台的数据；提供了码的基本信息、表单数据、批量子码、码的状态、计划完成情况等数据表
- 自有数据库：将数据实时推送至你的企业数据库内（仅支持Mysql 5.7版）；同官方数据库，提供了码的基本信息、表单数据、批量子码、码的状态、计划完成情况等数据表
- 推送到企微、钉钉、飞书群聊：表单数据填写并提交后，这些信息可以立即通过企业微信、钉钉或飞书自动推送到相应的群聊中；新提交表单数据、修改表单数据、表单审核结果通知、标记处理进度。
- 对接腾讯文档：表单数据可实时同步到腾讯文档的智能表格；新提交表单数据、修改表单数据、表单审核结果通知、标记处理进度

## 应用场景

### 1. 表单数据直接推送到企业微信、钉钉、飞书群聊

在草料制作的表单中，填表人扫码填写并提交数据后，这些信息可以立即通过企业微信、钉钉或飞书自动推送到相应的群聊中，实现即时共享和沟通，提升团队协作效率。[了解详情](/help/forms/form-design/other-settings/data-api/form-data-we-com-tutorial "了解详情")

![表单数据推送企业微信](https://blogcdnimg.clewm.net/2024/11/image-1732011308466_17320113044640.png)
图片说明：该图展示群机器人自动将隐患上报数据分发至企业微信、钉钉、飞书等不同平台群聊的自动化流程，含操作入口与多端消息示例。

### 2. 表单数据对接腾讯文档

可将草料的数据实时同步到腾讯文档的智能表格中，开通后将表单历史数据同步推送，后续提交的记录实时同步到腾讯文档，也可搭建数据看板，实现即时共享数据。[了解详情](/help/forms/form-design/other-settings/data-api/form-data "了解详情")
![表单数据同步腾讯文档](https://blogcdnimg.clewm.net/2024/11/image-1732011450859_17320114467609.png)
图片说明：该图展示高科制造公司访客数据看板与访客登记表，含总访问人次、分类分布及趋势曲线，支持自动同步至文档智能表，便于管理统计分析。

### 3. 连接wps、飞书等多维表格，自由应用数据

开启【官方数据库】功能，用wps、飞书等多维表格连接草料官方数据库，可自由应用数据，搭建自己想要的看板内容。
- wps限时免费。[查看wps示例](/help/integration-and-connection/data-api/data-reports/wps-connection "了解详情")
- 飞书免费版有限制，同步上限1000行，不超过3张数据表，超出需付费。[查看飞书示例](/help/integration-and-connection/data-api/data-reports/connection "查看飞书示例")
![file](https://blogcdnimg.clewm.net/2025/04/image-1745232936226_17452329366089.png)
图片说明：设备巡检数据仪表盘，展示灭火器总数、巡检次数、异常记录及月度统计趋势。

### 4. 连接bi数据分析工具，制作实时数据报表

开启【官方数据库】功能，用数据分析工具连接官草料官方数据库，进行数据分析或报表制作。[查看效果与制作教程](/help/integration-and-connection/data-api/data-reports/api-sugar-bi-data-api)
![file](https://blogcdnimg.clewm.net/2025/04/image-1745232620275_17452326207349.png)
图片说明：设备巡检与任务完成情况仪表盘，含实时天气、各类型点检/巡检进度环形图及未完成任务明细条形图。

## 数据推送方式

可任选推送方式免费开通，行业专属版不限数据推送条数，旗舰版限20000条/月，免费版和其他付费版限1000条/月。

### 1. Webhook方式

草料将表单数据以JSON格式推送到你指定的URL，这个地址需要允许公网访问。后续你可以编写程序，用接收到的数据对接其他系统或流程。[查看Webhook说明](/help/integration-and-connection/data-api/webhook-webhook-guide "查看Webhook说明")

#### 推送内容：
新提交表单数据、修改表单数据、表单审核结果通知、标记处理进度。

目前暂不支持其他数据推送。

#### 使用方法：
草料后台找到【高级功能】-【数据API】，选择【Webhook】进行开通，填入接收数据的URL地址，选择需要推送的表单并保存。开通后，新产生的数据会进行推送。

![Webhook数据推送设置界面](https://blogcdnimg.clewm.net/2024/04/image-1714358243570_17143582444156.png)
图片说明：数据管理页中“数据API”功能的开通选项，提供Webhook、官方数据库、自有数据库三种接入方式供用户选择。

### 2. 官方数据库

草料给每个用户提供了独立的云数据库，开通后同步你后台的数据。后续可以用数据分析软件连接这个云数据库，制作数据报表。

#### 推送内容：

提供了码的基本信息、表单数据、批量子码、码的状态、计划完成情况等数据表，[查看数据库字段说明](/help/integration-and-connection/data-api/official-database-guide)

#### 使用方法：

草料后台导航栏【数据管理】>【数据API】，选择【官方数据库】。填写申请信息后，会自动开通该功能，并推送数据。首次推送需要1~3小时，具体看你后台已有的数据量。
![草料后台数据管理界面](https://blogcdnimg.clewm.net/2024/05/image-1714888248608_17148882422787.png)
图片说明：数据管理后台的“数据API”配置页，展示官方数据库连接信息及添加/关闭配置的入口。

### 3. 自有数据库

草料实时将数据推送至你提供的企业数据库（仅支持Mysql 5.7版），无需建表、需开放公网访问权限。后续你可以自由读取数据，实现企业数据信息整合。

#### 推送内容：

同样提供了码的基本信息、表单数据、批量子码、码的状态、计划完成情况等数据表，[查看数据库字段说明](/help/integration-and-connection/data-api/private-database-guide)

#### 使用方法：
草料后台导航栏【数据管理】>【数据API】，选择【自有数据库】，填入你的数据库主机、端口、账号等信息。

![草料后台数据管理界面](https://blogcdnimg.clewm.net/2024/05/image-1714888414386_17148884080284.png)
图片说明：弹窗界面用于配置自有数据库连接信息，支持MySQL 5.7版本，含主机、端口、数据库、用户名、密码等必填字段及保存操作。

### 4. 群机器人

表单数据填写并提交后，这些信息可以立即通过企业微信、钉钉或飞书自动推送到相应的群聊中，实现即时共享和沟通，提升团队协作效率。[查看设置教程](/help/forms/form-design/other-settings/data-api/form-data-we-com-tutorial "查看设置教程")

### 5. 同步到腾讯文档

表单数据可实时同步到腾讯文档的智能表格中。开通后，会自动在绑定的腾讯文档账号下创建一个智能表格，且将表单历史数据同步推送，后续提交的记录实时同步到腾讯文档，实现即时共享数据。[查看设置教程](/help/forms/form-design/other-settings/data-api/form-data "查看设置教程")

## 数据推送条数的版本区别

不同的版本每月推送账号下的动态数据条数不同：

- 免费版、基础版、高级版：每月推送前1000条动态数据
- 旗舰版：每月推送前20,000条动态数据
- 行业专属版：每月推送条数不限

[了解数据API推送条数规则](/help/purchase-guide/paid-features/api-data-api "了解数据API推送条数规则")

## 学习交流

更多数据报表、数据API等问题，可以 [前往草料社区](https://cli.im/community/minihome/question/104 "前往草料社区") 与数据报表大牛互助交流，草料官方顾问和技术也会定期查看并回复