# フォームとデータ収集

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

> Markdown version of https://kanorio.com/ja/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**

フォームは、お問い合わせ、申し込み、予約の関心表明、アンケートなど、訪問者から情報を収集するために使用します。送信された内容はデータであり、注文ではありません。

## コアオブジェクト

- **フォーム:** 質問、同意設定、受付期間、確認メールなどを管理画面で作成します。
- **送信データ:** 訪問者の回答やファイル。Kanorioが作成または更新する連絡先に紐付けられます。

## APIの活用方法

- `<kanorio-form>`を使用してフォームを表示するか、Content Delivery APIのフォームエンドポイントを使用して独自のマークアップを構築します。このエンドポイントは、ボット対策とファイルアップロードを処理します。
- ボット対策には、デフォルトで組み込みのProof-of-Workチェックが使用されます。サイト所有者は、**サイト設定 › ボット対策**から、独自のCloudflare Turnstile、Google reCAPTCHA、またはhCaptchaキーに切り替えることができます。`GET /site`は選択内容を`botProtection`として返し、`<kanorio-form>`は適切なウィジェットを自動的にレンダリングします。
- 管理画面APIを使用して送信データを読み取ります。
- `customers.form.submitted` Webhookは、各送信データをシステムにプッシュします。

[フォーム](https://kanorio.com/ja/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/ja/developers/guides/forms): Kanorioフォームを独自のフロントエンドに配置しましょう。ボット保護、ファイルアップロード、同意確認、連絡先収集を自動的に処理します。

## For site owners

Dashboard help: https://kanorio.com/ja/help/online-forms