POST/api/public/contact
Reçoit une demande provenant du formulaire de contact du site web Zentor App et la transmet à l'équipe Zentor.
Les champs obligatoires sont `name` (2–120 caractères), `email` (adresse e-mail valide), `message` (10–3000 caractères) et `consentGiven`, qui doit être défini sur `true`. Vous pouvez également envoyer `company`, `phone` et `topic`. En cas de succès, le serveur répond avec `{"ok":true}` et un message de confirmation. Si un champ obligatoire est manquant, invalide, ou si le consentement est manquant, le point de terminaison répond 400 `VALIDATION_ERROR` ; le champ `details` liste les erreurs individuelles, afin que vous puissiez signaler les champs concernés. Chaque envoi réussi crée une nouvelle demande. Désactivez donc le bouton d'envoi jusqu'à la réponse et ne répétez pas l'appel automatiquement. 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/contact. 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), message (body), consentGiven (body). Paramètres facultatifs : company (body), phone (body), topic (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èresemail(body, string, requis)— Adresse e-mail validemessage(body, string, requis)— Message, 10–3000 caractèrescompany(body, string)— Entreprise (facultatif)phone(body, string)— Numéro de téléphone (facultatif)topic(body, string)— Sujet de la demande (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","message":"Votre message (10 caractères min.).","consentGiven":true}Exemple de réponse
{"ok":true,"message":"Ihre Anfrage wurde übermittelt."}Codes d'erreur
400 VALIDATION_ERROR — Un champ obligatoire est manquant ou invalide, ou le consentement à la protection des données est manquant. `details` contient les messages d'erreur individuels.Comportement vérifié
Des données complètes renvoient 200 ; des champs obligatoires manquants ou un consentement manquant renvoient 400 `VALIDATION_ERROR`.
Formulaires publics
POST /api/public/consultationReçoit une demande de conseil provenant du formulaire du site web Zentor App.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.