# 폼 및 데이터 수집

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

> Markdown version of https://kanorio.com/ko/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>`은 적절한 위젯을 자동으로 렌더링합니다.
- Management API를 사용하여 제출 데이터를 읽어옵니다.
- `customers.form.submitted` Webhook은 각 제출 데이터를 귀하의 시스템으로 푸시합니다.

[폼](https://kanorio.com/ko/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/ko/developers/guides/forms): Kanorio 폼을 자체 프론트엔드에 추가하세요. 봇 보호, 파일 업로드, 동의 확인, 연락처 수집 기능을 자동으로 처리합니다.

## For site owners

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