# 빠른 시작

> 어떤 HTML 폼이든 Ikiform으로 연결하고 2분 만에 첫 제출을 받아 보세요.

Ikiform은 모든 폼을 위한 백엔드입니다. 마크업, 프레임워크, 스타일은 그대로 유지합니다. 폼을 Ikiform 엔드포인트로 보내면 Ikiform이 각 POST를 검증하고, 스팸을 거르고, 워크스페이스에 저장하고, 이메일로 알리고, 서명된 웹훅으로 여러분의 시스템에 전달합니다.

이 문서의 코드 예제는 샘플 폼 ID `frm_xxxxxxxxxxxxxxxx`를 사용합니다. 대시보드의 폼 개요에서 찾을 수 있는 여러분의 폼 ID로 바꾸세요.

## 보내는 방식 고르기

모든 폼에는 공개 엔드포인트 `https://ikiform.com/f/<formId>`가 하나씩 있습니다. HTTP POST를 보낼 수 있다면 무엇이든 사용할 수 있습니다.

| 보내는 곳 | 사용할 것 | 가이드 |
| --- | --- | --- |
| 일반 HTML 페이지 또는 사이트 빌더 | `<form action>` | [HTML 폼](https://ikiform.com/ko/docs/html.md) |
| React, Next.js, Vue, Svelte, Astro | SDK의 `fetch` 또는 `submit` | [가이드](https://ikiform.com/ko/docs/guides/nextjs.md) |
| 백엔드, 스크립트, 연동 | 시크릿 키를 사용한 HTTPS JSON 요청 | [서버에서 보내기](https://ikiform.com/ko/docs/guides/server.md) |
| shadcn/ui 프로젝트 | 레지스트리 컴포넌트 | [shadcn/ui 컴포넌트](https://ikiform.com/ko/docs/shadcn.md) |

## 빠른 시작

### 1단계: 폼 만들기

[대시보드](https://ikiform.com/dashboard)에 로그인해 워크스페이스를 만들고 폼을 추가하세요. 폼 개요에 엔드포인트 URL과 HTML, JavaScript, React용 스니펫이 준비되어 있습니다.

### 2단계: 폼을 엔드포인트로 연결하기

폼의 `action`을 엔드포인트로, `method`를 `post`로 설정하세요. `name`이 있는 모든 입력은 제출의 필드가 됩니다.

`contact.html`:

```html
<form action="https://ikiform.com/f/frm_xxxxxxxxxxxxxxxx" method="post">
  <input name="name" required />
  <input name="email" type="email" required />
  <textarea name="message"></textarea>
  <input name="_gotcha" type="text" tabindex="-1" autocomplete="off" hidden />
  <button>Send</button>
</form>
```

숨겨진 `_gotcha` 입력은 허니팟입니다. 사람에게는 보이지 않고, 이 칸을 채우는 봇은 스팸으로 저장됩니다. [스팸 방지](https://ikiform.com/ko/docs/spam.md#honeypot)를 참고하세요.

### 3단계: 제출하기

페이지를 열고 폼을 보내세요. 브라우저는 Ikiform의 감사 페이지로 이동하며, 리디렉션을 설정했다면 여러분의 페이지로 이동합니다. 터미널에서 JSON을 POST할 수도 있습니다.

`Terminal`:

```bash
curl https://ikiform.com/f/frm_xxxxxxxxxxxxxxxx \
  -H "Content-Type: application/json" \
  -d '{"name":"Ada","email":"ada@example.com","message":"Hello"}'
```

JSON 요청에는 상태 `201`과 함께 JSON으로 응답합니다.

`201 Created`:

```json
{ "ok": true, "id": "sub_01k7v2c9t3e8m5q4x6z0a1b2c3" }
```

### 4단계: 도착 확인하기

제출은 바로 대시보드에 나타납니다. 이제 [웹훅](https://ikiform.com/ko/docs/webhooks.md)을 추가해 각 제출을 앱으로 보내거나, [REST API](https://ikiform.com/ko/docs/api.md)로 읽어 오세요.

## 직접 해 보기

이 페이지의 인터랙티브 요청 빌더는 필드 행으로 제출을 구성하고, 그에 맞는 curl, fetch, SDK 코드를 보여 줍니다. 샘플 폼 ID로는 코드만 보여 주고, 여러분의 폼 ID를 넣으면 `https://ikiform.com/f/<formId>`로 실제 POST를 한 번 보내 상태와 JSON 응답을 출력합니다. 빌더가 만드는 요청은 다음과 같습니다.

```bash
curl https://ikiform.com/f/frm_xxxxxxxxxxxxxxxx \
  -H "Content-Type: application/json" \
  -d '{"name":"Ada","email":"ada@example.com","message":"Hello"}'
```

## 다음 단계

- [작동 방식](https://ikiform.com/ko/docs/how-it-works.md)에서 POST가 거치는 모든 검사를 살펴보세요.
- [필드를 정의](https://ikiform.com/ko/docs/fields.md)하면 Ikiform이 잘못된 데이터를 명확한 필드 오류와 함께 거부합니다.
- [사람 확인을 켜고](https://ikiform.com/ko/docs/spam.md#human-check) 폼을 여러분의 도메인으로 제한하세요.
- 백엔드에서 [웹훅 서명을 검증](https://ikiform.com/ko/docs/webhooks.md#verify)하세요.