POST/api/public/access-request/email/start-verification

Envoie un code de confirmation à six chiffres, valable 10 minutes, à l'adresse e-mail indiquée – première étape d'une demande d'accès.

Envoyez l'adresse à confirmer dans le champ `email`. La réponse contient `verification_id`, `expires_in_minutes` (10) et `resend_cooldown_seconds` (60). Utilisez `verification_id` avec la même adresse e-mail et le code reçu dans `POST /api/public/access-request/email/verify`. Un nouvel envoi n'est possible qu'après l'expiration du délai d'attente ; affichez le temps restant dans votre interface. En cas de dépassement de la limite, le point de terminaison répond 429 `RATE_LIMIT_EXCEEDED`. Si l'e-mail ne peut pas être délivré, il répond 502 `MAIL_NOT_SENT` ; vérifiez alors l'adresse et réessayez plus tard.

Vue d'ensemble

Appel : POST /api/public/access-request/email/start-verification. 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 : email (body). Cas d'erreur documentés : 429 RATE_LIMIT_EXCEEDED, 502 MAIL_NOT_SENT. 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

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.

Limite de débit: 10 Anfragen pro 15 Minuten (IP-basiert)

Idempotent: Non

Paramètres

email(body, string, requis)— Adresse e-mail à confirmer

Exemple de requête

{"email":"max@example.com"}

Exemple de réponse

{"ok":true,"verification_id":"<UUID>","expires_in_minutes":10,"resend_cooldown_seconds":60}

Codes d'erreur

429 RATE_LIMIT_EXCEEDED — Trop de requêtes depuis cette adresse IP. Attendez avant de demander un nouveau code.
502 MAIL_NOT_SENT — Le code de confirmation n'a pas pu être envoyé par e-mail.

Comportement vérifié

L'appel renvoie 200 avec un `verification_id`, et le code est envoyé par e-mail ; les appels répétés renvoient 429 `RATE_LIMIT_EXCEEDED`.

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-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/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