# 表单与数据收集

> Form definitions, protected submissions with file uploads, and automatic contact capture.

> Markdown version of https://kanorio.com/zh-CN/developers/products/forms. Append `.md` to any developer docs URL for this format. Index: https://kanorio.com/llms.txt · MCP: https://app.kanorio.com/api/mcp
>
> Translated from the English original: https://kanorio.com/en/developers/products/forms.md

Status: **Available**

表单用于收集访客信息：联系请求、申请、预约意向及问卷调查。提交内容为数据，而非订单。

## 核心对象

- **表单 (Forms)。** 在后台建立的问题、同意设置、可用时段及确认邮件。
- **提交内容 (Submissions)。** 每一位访客的回答与文件，并链接至 Kanorio 建立或更新的联系人。

## API 如何运作

- 使用 `<kanorio-form>` 显示表单，或在 Content Delivery API 的表单端点上建立您自己的标记，这些端点可处理机器人防护与文件上传。
- 默认启用内置的 proof-of-work 检查作为机器人防护。网站拥有者可在「网站设置 › 机器人防护」下切换为自己的 Cloudflare Turnstile、Google reCAPTCHA 或 hCaptcha 密钥；`GET /site` 会返回 `botProtection` 的选择，而 `<kanorio-form>` 会自动渲染正确的组件。
- 使用 Management API 读取提交内容。
- `customers.form.submitted` Webhook 会将每笔提交内容推送到您的系统。

请参阅 [表单](https://kanorio.com/zh-CN/developers/guides/forms) 指南。

## What the APIs expose

| Capability | Status | API | Elements | Hosted site | Webhooks |
| --- | --- | --- | --- | --- | --- |
| Forms & lead capture | Available | Management API `forms.list/get`, `submissions.list/get`; Delivery `GET /forms/:id`, `GET /forms/:id/challenge`, `POST /forms/:id/upload-request`, `POST /forms/:id/submit`; SDK `forms.client({ siteUrl })` | `<KanorioForm />` (`<kanorio-form>`), `<KanorioBotProtection />`, `useKanorioBotProtection()` | `/marketing/forms`, `/data/form_submissions`; page `form` section | `customers.form.submitted` |

## API reference

- Management API: [Forms](https://kanorio.com/en/developers/management-api/forms) (2 operations)
- Management API: [Submissions](https://kanorio.com/en/developers/management-api/submissions) (3 operations)
- Content Delivery API: [Forms](https://kanorio.com/en/developers/delivery-api/forms) (4 operations)

## Webhook events

- `customers.form.submitted`: Fired when a visitor submits an online form (notifies team and webhooks).

Payloads: https://kanorio.com/en/developers/webhooks/events

## Elements

- `<kanorio-form>`: Interactive form with client validation, an anti-spam challenge, private file uploads and submission handling.

## Guides

- [表单](https://kanorio.com/zh-CN/developers/guides/forms): 将 Kanorio 表单放置在您自己的前端，并为您处理机器人防护、文件上传、同意与联系人收集。

## For site owners

Dashboard help: https://kanorio.com/zh-CN/help/online-forms