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ères
email(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.

Articles associés

← Formulaires publics