Início rápido

O Ikiform é o backend para todo formulário. Você mantém seu próprio markup, framework e estilos. Aponte o formulário para um endpoint do Ikiform e o Ikiform valida cada envio, filtra spam, armazena no seu workspace, avisa você por e-mail e entrega aos seus sistemas por webhook assinado.

Escolha como enviar

Todo formulário ganha um endpoint público, https://ikiform.com/f/<formId>. Qualquer coisa que consiga enviar um HTTP POST pode usá-lo.

Início rápido

1. Crie um formulário

   Entre no painel, crie um workspace e adicione um formulário. A visão geral dele mostra a URL do endpoint e snippets prontos para HTML, JavaScript e React.

2. Aponte seu formulário para o endpoint

   Defina o action do formulário como o endpoint e o method como post. Todo input com um name vira um campo do envio.

   <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>

   O input oculto _gotcha é um honeypot. As pessoas nunca o veem; bots que o preenchem são armazenados como spam. Veja Proteção contra spam.

3. Envie

   Abra a página e envie o formulário. O navegador vai para a página de agradecimento do Ikiform, ou para a sua própria página se você definir um redirecionamento. Você também pode enviar JSON pelo terminal:

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

   Uma requisição JSON recebe uma resposta JSON com status 201:

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

4. Veja o envio chegar

   O envio aparece no painel na hora. A partir daí, adicione um webhook para mandar cada envio ao seu app, ou leia os envios com a API REST.

Experimente

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."}'

Próximos passos

• Como funciona mostra cada verificação pela qual um envio passa.
• Defina campos para o Ikiform rejeitar dados ruins com erros de campo claros.
• Ative uma verificação humana e restrinja o formulário aos seus domínios.
• Verifique as assinaturas de webhook no seu backend.