# Démarrage rapide

> Branchez n'importe quel formulaire HTML sur Ikiform et recevez votre première soumission en deux minutes.

Ikiform est le backend de tous vos formulaires. Vous gardez votre markup, votre framework et vos styles. Faites pointer le formulaire vers un endpoint Ikiform : Ikiform valide chaque envoi, filtre le spam, le stocke dans votre espace de travail, vous l'envoie par e-mail et le livre à vos systèmes par webhook signé.

Les exemples de code de cette doc utilisent l'id de formulaire d'exemple `frm_xxxxxxxxxxxxxxxx`. Remplacez-le par l'id de votre formulaire, visible dans sa vue d'ensemble du tableau de bord.

## Choisissez comment envoyer

Chaque formulaire dispose d'un endpoint public, `https://ikiform.com/f/<formId>`. Tout ce qui peut envoyer un POST HTTP peut l'utiliser.

| Vous envoyez depuis | Utilisation | Guide |
| --- | --- | --- |
| Une simple page HTML ou un créateur de sites | `<form action>` | [Formulaires HTML](https://ikiform.com/fr/docs/html.md) |
| React, Next.js, Vue, Svelte, Astro | `fetch` ou `submit` du SDK | [Guides](https://ikiform.com/fr/docs/guides/nextjs.md) |
| Un backend, un script ou une intégration | Du JSON en HTTPS avec une clé secrète | [Depuis un serveur](https://ikiform.com/fr/docs/guides/server.md) |
| Un projet shadcn/ui | Le composant du registry | [Composant shadcn/ui](https://ikiform.com/fr/docs/shadcn.md) |

## Démarrage rapide

### Étape 1 : Créez un formulaire

Connectez-vous au [tableau de bord](https://ikiform.com/dashboard), créez un espace de travail et ajoutez un formulaire. Sa vue d'ensemble affiche l'URL de l'endpoint et des snippets prêts à l'emploi pour HTML, JavaScript et React.

### Étape 2 : Faites pointer votre formulaire vers l'endpoint

Réglez l'`action` du formulaire sur l'endpoint et `method` sur `post`. Chaque input doté d'un `name` devient un champ de la soumission.

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

L'input masqué `_gotcha` est un honeypot. Les humains ne le voient jamais ; les bots qui le remplissent sont stockés comme spam. Voir [Protection anti-spam](https://ikiform.com/fr/docs/spam.md#honeypot).

### Étape 3 : Envoyez-le

Ouvrez la page et envoyez le formulaire. Le navigateur arrive sur la page de remerciement d'Ikiform, ou sur votre propre page si vous avez défini une redirection. Vous pouvez aussi envoyer du JSON depuis un terminal :

`Terminal`:

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

Une requête JSON reçoit une réponse JSON avec le statut `201` :

`201 Created`:

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

### Étape 4 : Regardez-la arriver

La soumission apparaît tout de suite dans le tableau de bord. Ensuite, ajoutez un [webhook](https://ikiform.com/fr/docs/webhooks.md) pour envoyer chacune à votre application, ou lisez-les avec l'[API REST](https://ikiform.com/fr/docs/api.md).

## Essayez

Le constructeur de requête interactif de cette page compose une soumission à partir de lignes de champs et affiche le code curl, fetch et SDK correspondant. Avec l'id d'exemple, il affiche seulement le code ; avec l'id de votre formulaire, il peut envoyer un vrai POST à `https://ikiform.com/f/<formId>` et afficher le statut et la réponse JSON. La requête construite ressemble à ceci :

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

## Étapes suivantes

- [Comment ça marche](https://ikiform.com/fr/docs/how-it-works.md) détaille chaque contrôle que traverse un envoi.
- [Définissez des champs](https://ikiform.com/fr/docs/fields.md) pour qu'Ikiform refuse les données invalides avec des erreurs de champ claires.
- [Activez une vérification humaine](https://ikiform.com/fr/docs/spam.md#human-check) et limitez le formulaire à vos domaines.
- [Vérifiez les signatures de webhook](https://ikiform.com/fr/docs/webhooks.md#verify) dans votre backend.