빠른 시작

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

보내는 방식 고르기

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

빠른 시작

1. 폼 만들기

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

2. 폼을 엔드포인트로 연결하기

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

   <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 입력은 허니팟입니다. 사람에게는 보이지 않고, 이 칸을 채우는 봇은 스팸으로 저장됩니다. 스팸 방지를 참고하세요.

3. 제출하기

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

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

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

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

4. 도착 확인하기

   제출은 바로 대시보드에 나타납니다. 이제 웹훅을 추가해 각 제출을 앱으로 보내거나, REST API로 읽어 오세요.

직접 해 보기

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

다음 단계

• 작동 방식에서 POST가 거치는 모든 검사를 살펴보세요.
• 필드를 정의하면 Ikiform이 잘못된 데이터를 명확한 필드 오류와 함께 거부합니다.
• 사람 확인을 켜고 폼을 여러분의 도메인으로 제한하세요.
• 백엔드에서 웹훅 서명을 검증하세요.