POST/api/public/access-request
Soumet 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.
Confirmez d'abord l'adresse e-mail via `POST /api/public/access-request/email/start-verification` et `POST /api/public/access-request/email/verify`. Envoyez ensuite `name`, la même `email`, la formule `package` (`starter`, `individual` ou `demo_access`) et le `verification_token` reçu. Vous pouvez également envoyer `company`, `phone`, `companyWebsite`, `paymentMethod` (`paypal`, `kreditkarte`, `rechnung`, `stripe_card` ou `stripe_sepa`), `wish` (`trial`, `subscription` ou `offer` ; toujours `trial` pour l'accès démo) et `message`. Sans confirmation valide, le serveur répond 400 `EMAIL_NOT_VERIFIED`. Des champs obligatoires manquants ou des valeurs invalides pour la formule, le mode de paiement ou le souhait entraînent 400 `VALIDATION_ERROR`. Chaque demande réussie est créée comme nouvelle demande et traitée par Zentor ; ne répétez donc 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/access-request. 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), package (body). Paramètres facultatifs : company (body), phone (body), companyWebsite (body), paymentMethod (body), wish (body), message (body). Cas d'erreur documentés : 400 VALIDATION_ERROR, 400 EMAIL_NOT_VERIFIED. 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 préalablement confirmée via `/email/verify`package(body, string, requis)— Formule : `starter`, `individual` ou `demo_access`company(body, string)— Entreprise, max. 160 caractères (facultatif)phone(body, string)— Numéro de téléphone, max. 40 caractères (facultatif)companyWebsite(body, string)— Site web de l'entreprise, max. 200 caractères (facultatif)paymentMethod(body, string)— Moyen de paiement : `paypal`, `kreditkarte`, `rechnung`, `stripe_card` ou `stripe_sepa` (facultatif)wish(body, string)— Souhait : `trial`, `subscription` ou `offer` ; toujours `trial` pour `demo_access` (facultatif)message(body, string)— Message, max. 3000 caractères (facultatif)Exemple de requête
{"name":"Jean Dupont","email":"max@example.com","package":"demo_access"}Exemple de réponse
{"ok":false,"error":"EMAIL_NOT_VERIFIED","message":"Bitte bestätigen Sie zuerst Ihre E-Mail-Adresse."}Codes d'erreur
400 VALIDATION_ERROR — Un champ obligatoire est manquant, ou la formule, le moyen de paiement ou le souhait sont invalides.400 EMAIL_NOT_VERIFIED — L'adresse e-mail n'a pas été confirmée préalablement via `/email/start-verification` et `/email/verify`, ou le `verification_token` est manquant ou invalide.Comportement vérifié
Un corps vide renvoie 400 `VALIDATION_ERROR` ; des données valides sans adresse e-mail confirmée renvoient 400 `EMAIL_NOT_VERIFIED`. Le cas de succès suit le déroulement documenté après la confirmation de l'e-mail.
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/consultationReçoit une demande de conseil provenant du formulaire du site web Zentor App.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.