Premiers pas

Formerie reçoit les soumissions de formulaires, valide les valeurs soumises, enregistre la soumission et effectue la livraison selon une configuration gérée côté serveur.

Les clients navigateur soumettent seulement les valeurs des champs, les jetons de vérification humaine lorsqu’ils sont requis et des métadonnées sûres provenant de votre site, comme l’URL de la page ou une clé d’idempotence. Ils ne soumettent jamais de destinataires, d’identifiants de fournisseurs, de noms de fournisseurs, de gabarits de courriel, de règles de livraison ni de règles de validation côté serveur.

Installer le client

Utilisez le paquet client si vous voulez des fonctions utilitaires pour les URL de l’environnement d’exécution, le chargement du schéma public, la validation, l’état de la soumission et l’amélioration progressive.

npm install @formerie/client

pnpm add @formerie/client

yarn add @formerie/client

bun add @formerie/client

Soumettre un formulaire

import { FormerieRuntimeClient } from "@formerie/client";

const forms = new FormerieRuntimeClient();

const result = await forms.submit("example.com", "contact", {
  fields: {
    name: "Jane Example",
    email: "jane@example.com",
    message: "Hello"
  },
  verificationToken: captchaToken,
  metadata: {
    pageUrl: window.location.href
  }
});

if (result.ok) {
  console.log(result.submissionId);
}

Le point de terminaison par défaut de l’environnement d’exécution est https://forms.formerie.com. Il utilise des routes épurées comme /example/contact/submit.

Noms d’hôte de l’environnement d’exécution

Les noms d’hôte liés à un espace de travail gardent l’identifiant du formulaire dans le chemin :

const forms = new FormerieRuntimeClient({
  endpoint: "https://forms.example.com"
});

await forms.submitWorkspace("contact", {
  fields,
  verificationToken: captchaToken
});

Les noms d’hôte liés à un formulaire ciblent directement ce formulaire :

const contact = new FormerieRuntimeClient({
  endpoint: "https://contact.example.com"
});

await contact.submitForm({
  fields,
  verificationToken: captchaToken
});

Pages hébergées et intégrations

Les formulaires hébergés, les intégrations, les routes brutes de l’environnement d’exécution et les fonctions utilitaires du SDK reposent tous sur le même contrat de schéma public, de validation, de soumission et d’erreurs. La livraison reste configurée côté serveur; le code client n’envoie jamais de destinataires, de gabarits, d’identifiants de fournisseurs ni de règles d’acheminement non publiques.