POST/api/public/consultation

Reçoit une demande de conseil provenant du formulaire du site web Zentor App.

Les champs obligatoires sont `name` (2–120 caractères), `email` (adresse e-mail valide) et `consentGiven`, qui doit être défini sur `true`. Vous pouvez également envoyer `company`, `phone` et `message`. En cas de succès, le serveur répond avec `{"ok":true}` et un message de confirmation ; l'équipe Zentor vous contacte ensuite. Si un champ obligatoire est manquant, invalide, ou si le consentement est manquant, le point de terminaison répond 400 `VALIDATION_ERROR`. Chaque appel réussi crée une nouvelle demande ; l'appel n'est donc pas idempotent. Au maximum 10 requêtes par 15 minutes et par adresse IP. Les règles d'accès de Zentor (règles d'IP, de pays et de domaine e-mail) s'appliquent également ; les appels rejetés reçoivent 403.

Vue d'ensemble

Appel : POST /api/public/consultation. Ce point de terminaison appartient au groupe « Formulaires publics » de l'API de Zentor App. Il est accessible publiquement et ne nécessite aucune authentification. L'appel n'est pas idempotent : chaque appel réussi déclenche à nouveau l'action. Paramètres obligatoires : name (body), email (body), consentGiven (body). Paramètres facultatifs : company (body), message (body), phone (body). Cas d'erreur documentés : 400 VALIDATION_ERROR. L'exemple de réponse ci-dessous montre la structure d'une réponse réussie au format JSON.

Authentification et sécurité

Aucune authentification requise

Idempotent: Non

Paramètres

name(body, string, requis)— Nom, 2–120 caractères
email(body, string, requis)— Adresse e-mail valide
company(body, string)— Entreprise (facultatif)
message(body, string)— Message (facultatif)
phone(body, string)— Numéro de téléphone (facultatif)
consentGiven(body, boolean, requis)— Consentement à la protection des données, doit être `true`

Exemple de requête

{"name":"Jean Dupont","email":"max@example.com","company":"Société Exemple","message":"Demande","consentGiven":true}

Exemple de réponse

{"ok":true,"message":"Ihre Beratungsanfrage wurde übermittelt. Wir melden uns in Kürze bei Ihnen."}

Codes d'erreur

400 VALIDATION_ERROR — Un champ obligatoire est manquant ou invalide, ou le consentement est manquant.

Comportement vérifié

Des données complètes renvoient 200 ; des données manquantes ou invalides renvoient 400 `VALIDATION_ERROR`.

Formulaires publics

POST /api/public/contactReçoit une demande provenant du formulaire de contact du site web Zentor App et la transmet à l'équipe Zentor.POST /api/public/access-requestSoumet une demande d'accès pour une formule (Starter, Sur mesure ou démo de 14 jours). Une adresse e-mail préalablement confirmée est requise.POST /api/public/access-request/email/start-verificationEnvoie un code de confirmation à six chiffres, valable 10 minutes, à l'adresse e-mail indiquée – première étape d'une demande d'accès.POST /api/public/access-request/email/verifyVérifie le code envoyé par e-mail et délivre un jeton de confirmation pour la demande d'accès suivante.GET /api/public/access-request/payment-statusIndique quels moyens de paiement (PayPal, Stripe) sont actuellement disponibles pour la demande d'accès.GET /api/public/access-request/paypal/configFournit la configuration PayPal publique (actif, mode, devise) pour l'étape de paiement.POST /api/public/access-request/paypal/create-orderCrée une commande PayPal pour la formule choisie.POST /api/public/access-request/paypal/capture-orderFinalise (capture) une commande précédemment créée et approuvée par l'acheteur dans le checkout PayPal. Le montant est fixé exclusivement par le serveur.POST /api/public/access-request/stripe/create-checkoutCrée une session de paiement Stripe pour la formule choisie.POST /api/public/activate-accountActive un compte utilisateur nouvellement créé et définit le premier mot de passe – déclenché via le lien de l'e-mail d'invitation.

Articles associés

← Formulaires publics