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

Skickar en sexsiffrig bekräftelsekod, giltig i 10 minuter, till den angivna e-postadressen – det första steget i en åtkomstbegäran.

Skicka adressen som ska bekräftas i fältet `email`. Svaret innehåller `verification_id`, `expires_in_minutes` (10) och `resend_cooldown_seconds` (60). Använd `verification_id` tillsammans med samma e-postadress och den mottagna koden i `POST /api/public/access-request/email/verify`. En ny kod kan först skickas när väntetiden löpt ut; visa återstående tid i ditt gränssnitt. Överskrids gränsen svarar slutpunkten med 429 `RATE_LIMIT_EXCEEDED`. Om e-postmeddelandet inte kan levereras svarar den med 502 `MAIL_NOT_SENT`; kontrollera då adressen och försök igen senare.

Översikt

Anrop: POST /api/public/access-request/email/start-verification. Endpointen tillhör gruppen ”Offentliga formulär” i Zentor Apps API. Den är offentligt tillgänglig och kräver ingen autentisering. Anropet är inte idempotent: Varje lyckat anrop utlöser åtgärden på nytt. Obligatoriska parametrar: email (body). Dokumenterade felfall: 429 RATE_LIMIT_EXCEEDED, 502 MAIL_NOT_SENT. Exempelsvaret nedan visar strukturen för ett lyckat svar i JSON-format.

Autentisering & säkerhet

Ingen autentisering krävs

Högst 10 förfrågningar per 15 minuter per IP-adress. Dessutom gäller Zentors åtkomstregler (IP-, lands- och e-postdomänregler); avvisade anrop får 403.

Hastighetsbegränsning: 10 Anfragen pro 15 Minuten (IP-basiert)

Idempotent: Nej

Parametrar

email(body, string, obligatorisk)— E-postadress som ska bekräftas

Exempel på request

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

Exempel på response

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

Felkoder

429 RATE_LIMIT_EXCEEDED — För många förfrågningar från denna IP-adress. Vänta innan du begär en ny kod.
502 MAIL_NOT_SENT — Bekräftelsekoden kunde inte levereras via e-post.

Verifierat beteende

Anropet returnerar 200 med `verification_id`, och koden levereras via e-post; upprepade anrop returnerar 429 `RATE_LIMIT_EXCEEDED`.

Offentliga formulär

POST /api/public/contactTar emot en förfrågan från kontaktformuläret på Zentor App-webbplatsen och vidarebefordrar den till Zentor-teamet.POST /api/public/consultationTar emot en rådgivningsförfrågan från formuläret på Zentor App-webbplatsen.POST /api/public/access-requestSkickar in en åtkomstbegäran för ett paket (Starter, Individuell eller 14-dagars demo). Det krävs en tidigare bekräftad e-postadress.POST /api/public/access-request/email/verifyKontrollerar koden som skickas via e-post och utfärdar en bekräftelsetoken för den efterföljande åtkomstbegäran.GET /api/public/access-request/payment-statusAnger vilka betalningsmetoder (PayPal, Stripe) som för tillfället är tillgängliga för åtkomstbegäran.GET /api/public/access-request/paypal/configReturnerar den offentliga PayPal-konfigurationen (aktiverad, läge, valuta) för betalningssteget.POST /api/public/access-request/paypal/create-orderSkapar en PayPal-order för det valda paketet.POST /api/public/access-request/paypal/capture-orderSlutför (capture) en tidigare skapad order som köparen har godkänt i PayPal-checkouten. Beloppet fastställs uteslutande av servern.POST /api/public/access-request/stripe/create-checkoutSkapar en Stripe-checkoutsession för det valda paketet.POST /api/public/activate-accountAktiverar ett nyskapat användarkonto och ställer in det första lösenordet – utlöst via länken i inbjudningsmejlet.

Relaterade artiklar

← Offentliga formulär