Guide · 6 min de lecture
Comment intégrer un formulaire sur votre site web
Il existe plusieurs façons de placer un formulaire sur votre site, du snippet d'une seule ligne à une intégration API entièrement personnalisée. Ce guide parcourt les intégrations en ligne, les popups modales, le composant web et le JS SDK ainsi que l'API REST publique, afin que vous puissiez choisir l'approche adaptée à votre projet.
Intégration en ligne
Une intégration en ligne place le formulaire directement dans le flux de votre page, de sorte qu'il s'insère entre vos autres contenus comme n'importe quelle section. Vous collez un petit snippet à l'endroit où vous voulez que le formulaire apparaisse, et il s'affiche sur place — sans redirection ni page d'atterrissage distincte.
La version la plus simple est un composant web : ajoutez la balise <yeetform-embed> avec le slug de votre formulaire et le formulaire se charge en ligne. Si vous préférez, le même effet est possible via un seul appel du JS SDK qui s'affiche dans un élément cible de votre choix.
Popup ou modale
Parfois, vous ne voulez pas du tout du formulaire sur la page tant que personne ne le demande. Une popup ou modale garde votre mise en page nette et ouvre le formulaire en superposition lorsqu'un visiteur clique sur un bouton — idéal pour les boutons de contact, les widgets de retour ou un appel à l'action dans un coin de l'écran.
Avec le JS SDK, vous reliez un bouton à YeetForm.open(slug) et le formulaire apparaît dans une modale centrée par-dessus votre page. Le visiteur le remplit sans jamais partir, et la superposition se ferme à l'envoi, de sorte que le formulaire ne dispute jamais d'espace à votre contenu principal.
Composant web et JS SDK
Pour la plupart des sites, le composant web et le JS SDK couvrent tout. La balise <yeetform-embed> est l'option sans build — elle fonctionne en HTML brut, dans un bloc CMS ou dans tout framework qui autorise les éléments personnalisés. Le JS SDK vous donne un contrôle programmatique quand vous en avez besoin.
Le SDK (public/sdk.js) expose un petit ensemble de méthodes :
- YeetForm.render(slug, target, options) — intègre le formulaire en ligne dans un élément de votre choix.
- YeetForm.open(slug, options) — ouvre le formulaire dans une popup modale.
- YeetForm.load(slug, lang) — récupère le schéma du formulaire sans interface, par exemple pour compter ou inspecter les champs.
- YeetForm.submit(slug, answers) — soumet une réponse de façon programmatique depuis votre propre code.
API pour les intégrations personnalisées
Lorsque vous avez besoin d'un contrôle total — un front-end sur mesure, une application mobile ou un flux côté serveur — utilisez l'API REST publique. Elle est compatible CORS, vous pouvez donc l'appeler directement depuis du code navigateur, et sans authentification pour les formulaires publics, de sorte qu'aucune clé d'API n'est nécessaire pour charger un schéma ou envoyer une réponse.
Une intégration typique récupère le schéma du formulaire avec une requête GET, affiche les champs comme vous le souhaitez dans votre propre interface, puis renvoie les réponses collectées par une requête POST. Comme le schéma n'est que du JSON, vous pouvez créer des mises en page entièrement personnalisées pendant que YeetForm gère le stockage, les notifications et l'analyse en coulisses.