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

Pošlje šestmestno potrditveno kodo, veljavno 10 minut, na navedeni e-poštni naslov – prvi korak zahteve za dostop.

Pošljite naslov, ki ga je treba potrditi, v polju `email`. Odgovor vsebuje `verification_id`, `expires_in_minutes` (10) in `resend_cooldown_seconds` (60). Uporabite `verification_id` skupaj z istim e-poštnim naslovom in prejeto kodo v `POST /api/public/access-request/email/verify`. Ponovno pošiljanje je mogoče šele po preteku čakalnega časa; prikažite preostali čas v svojem vmesniku. Če je omejitev presežena, končna točka odgovori s 429 `RATE_LIMIT_EXCEEDED`. Če e-pošte ni mogoče dostaviti, odgovori s 502 `MAIL_NOT_SENT`; v tem primeru preverite naslov in poskusite znova pozneje.

Pregled

Klic: POST /api/public/access-request/email/start-verification. Ta endpoint spada v skupino »Javni obrazci« API-ja Zentor App. Je javno dostopen in ne zahteva overjanja. Klic ni idempotenten: vsak uspešen klic znova sproži dejanje. Obvezni parametri: email (body). Dokumentirani primeri napak: 429 RATE_LIMIT_EXCEEDED, 502 MAIL_NOT_SENT. Spodnji primer odgovora prikazuje strukturo uspešnega odgovora v formatu JSON.

Avtentikacija in zaščita

Avtentikacija ni potrebna

Največ 10 zahtev na 15 minut na IP-naslov. Dodatno veljajo dostopna pravila Zentor (pravila za IP, države in e-poštne domene); zavrnjeni klici prejmejo 403.

Omejitev zahtev: 10 Anfragen pro 15 Minuten (IP-basiert)

Idempotentno: Ne

Parametri

email(body, string, obvezno)— E-poštni naslov, ki ga je treba potrditi

Primer zahteve

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

Primer odgovora

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

Kode napak

429 RATE_LIMIT_EXCEEDED — Preveč zahtev s tega IP-naslova. Počakajte, preden zahtevate novo kodo.
502 MAIL_NOT_SENT — Potrditvene kode ni bilo mogoče dostaviti po e-pošti.

Preverjeno vedenje

Klic vrne 200 z `verification_id`, koda pa se dostavi po e-pošti; ponovljeni klici vrnejo 429 `RATE_LIMIT_EXCEEDED`.

Javni obrazci

POST /api/public/contactSprejme povpraševanje iz kontaktnega obrazca spletnega mesta Zentor App in ga posreduje ekipi Zentor.POST /api/public/consultationSprejme povpraševanje za posvetovanje iz obrazca spletnega mesta Zentor App.POST /api/public/access-requestOddaja zahtevo za dostop do paketa (Starter, Individualno ali 14-dnevna demo verzija). Pogoj je predhodno potrjen e-poštni naslov.POST /api/public/access-request/email/verifyPreveri kodo, dostavljeno po e-pošti, in izda potrditveni žeton za naslednjo zahtevo za dostop.GET /api/public/access-request/payment-statusNavede, kateri plačilni načini (PayPal, Stripe) so trenutno na voljo za zahtevo za dostop.GET /api/public/access-request/paypal/configVrne javno konfiguracijo PayPal (aktivno, način, valuta) za korak plačila.POST /api/public/access-request/paypal/create-orderUstvari naročilo PayPal za izbrani paket.POST /api/public/access-request/paypal/capture-orderZaključi (capture) predhodno ustvarjeno naročilo, ki ga je kupec potrdil v PayPal checkoutu. Znesek določi izključno strežnik.POST /api/public/access-request/stripe/create-checkoutUstvari sejo Stripe checkout za izbrani paket.POST /api/public/activate-accountAktivira novo ustvarjen uporabniški račun in nastavi prvo geslo – sproži se prek povezave v e-pošti s povabilom.

Sorodni članki

← Javni obrazci