---
uuid: "2e9e2105-eab6-4f4c-a1ba-dffc83290585"
type: "concept"
title: "数据API功能"
sidebar_position: 1
description: "草料提供 Webhook、官方数据库、自有数据库等 5 种数据对接方式，可将码、表单、状态等数据自动推送到外部系统，用于数据分析、可视化报表和业务系统集成。目前只支持单向推送，暂不支持将外部数据写入草料。"
keywords:
  - 草料数据API
  - 草料二维码数据对接
  - Webhook 数据推送
  - 官方数据库
  - 可视化报表集成
cl_old_blog_id: "56845"
cl_old_blog_url: "https://cli.im/help/56845"
last_update:
  date: "2025-09-04"
---
草料提供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)
<!-- 图片说明：该图片是用户界面的操作示意图，包含手机界面的“隐患上报”表单填写页，以及PC界面的企业微信、钉钉、飞书群聊中显示的隐患上报新记录推送内容。 -->

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

可将草料的数据实时同步到腾讯文档的智能表格中，开通后将表单历史数据同步推送，后续提交的记录实时同步到腾讯文档，也可搭建数据看板，实现即时共享数据。[了解详情](/help/forms/form-design/other-settings/data-api/form-data "了解详情")
![表单数据同步腾讯文档](https://blogcdnimg.clewm.net/2024/11/image-1732011450859_17320114467609.png)
<!-- 图片说明：PC界面操作示意图，左侧为腾讯文档智能表格中的访客登记表单数据列表，右侧为访客数据看板，含累计、本月、今日访客人数及分类占比、趋势图表。 -->

### 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)
<!-- 图片说明：说明示意图，展示通过BI数据分析工具制作的实时数据报表，包含计划完成率仪表盘、设备状态环形图及各检查项完成情况的环形图和柱状图。 -->

## 数据推送方式

可任选推送方式免费开通，行业专属版不限数据推送条数，旗舰版限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)
<!-- 图片说明：用户界面操作示意图（PC界面），展示草料二维码数据管理中数据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)
<!-- 图片说明：PC界面操作示意图，展示草料后台数据管理中“数据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)
<!-- 图片说明：PC界面操作示意图：草料后台数据管理中“自有数据库”配置弹窗，含主机、端口等输入框及保存按钮，用于设置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 "前往草料社区") 与数据报表大牛互助交流，草料官方顾问和技术也会定期查看并回复