POST/api/public/access-request/email/start-verification
Dërgon një kod konfirmimi me gjashtë shifra, të vlefshëm për 10 minuta, në adresën e dhënë të e-mailit – hapi i parë i një kërkese aksesi.
Dërgoni adresën që duhet konfirmuar në fushën `email`. Përgjigja përmban `verification_id`, `expires_in_minutes` (10) dhe `resend_cooldown_seconds` (60). Përdorni `verification_id` bashkë me të njëjtën adresë e-maili dhe kodin e marrë te `POST /api/public/access-request/email/verify`. Ridërgimi është i mundur vetëm pas skadimit të kohës së pritjes; shfaqni kohën e mbetur në ndërfaqen tuaj. Nëse kufiri tejkalohet, endpoint-i përgjigjet me 429 `RATE_LIMIT_EXCEEDED`. Nëse e-maili nuk mund të dërgohet, përgjigjet me 502 `MAIL_NOT_SENT`; kontrolloni atëherë adresën dhe provoni përsëri më vonë.
Përmbledhje
Thirrja: POST /api/public/access-request/email/start-verification. Ky endpoint i përket grupit “Formularët publikë” të API-së së Zentor App. Është i aksesueshëm publikisht dhe nuk kërkon autentifikim. Thirrja nuk është idempotente: çdo thirrje e suksesshme e shkakton veprimin përsëri. Parametrat e detyrueshëm: email (body). Rastet e dokumentuara të gabimeve: 429 RATE_LIMIT_EXCEEDED, 502 MAIL_NOT_SENT. Përgjigjja shembull më poshtë tregon strukturën e një përgjigjeje të suksesshme në formatin JSON.
Autentifikimi dhe siguria
Nuk kërkohet autentifikim
Maksimumi 10 kërkesa për 15 minuta për IP. Zbatohen gjithashtu rregullat e qasjes së Zentor (rregullat për IP, vende dhe domenin e e-mailit); thirrjet e refuzuara marrin 403.
Kufiri i kërkesave (rate limit): 10 Anfragen pro 15 Minuten (IP-basiert)
Idempotent: Jo
Parametrat
email(body, string, i detyrueshëm)— Adresa e e-mailit që duhet konfirmuarShembull request-i
{"email":"max@example.com"}Shembull response-i
{"ok":true,"verification_id":"<UUID>","expires_in_minutes":10,"resend_cooldown_seconds":60}Kodet e gabimeve
429 RATE_LIMIT_EXCEEDED — Shumë kërkesa nga kjo adresë IP. Prisni para se të kërkoni një kod të ri.502 MAIL_NOT_SENT — Kodi i konfirmimit nuk mund të dërgohej me e-mail.Sjellja e verifikuar
Thirrja kthen 200 me `verification_id`, dhe kodi dërgohet me e-mail; thirrjet e përsëritura kthejnë 429 `RATE_LIMIT_EXCEEDED`.
Formularët publikë
POST /api/public/contactPranon një kërkesë nga formulari i kontaktit në faqen e internetit të Zentor App dhe ia përcjell ekipit të Zentor.POST /api/public/consultationPranon një kërkesë për konsulencë nga formulari i faqes së internetit të Zentor App.POST /api/public/access-requestDërgon një kërkesë aksesi për një paketë (Starter, Individuale ose demo 14-ditore). Parakusht është një adresë e-maili e konfirmuar paraprakisht.POST /api/public/access-request/email/verifyKontrollon kodin e dërguar me e-mail dhe lëshon një token konfirmimi për kërkesën e aksesit që pason.GET /api/public/access-request/payment-statusTregon cilat mënyra pagese (PayPal, Stripe) janë aktualisht në dispozicion për kërkesën e aksesit.GET /api/public/access-request/paypal/configKthen konfigurimin publik të PayPal-it (aktiv, mënyra, monedha) për hapin e pagesës.POST /api/public/access-request/paypal/create-orderKrijon një porosi PayPal për paketën e zgjedhur.POST /api/public/access-request/paypal/capture-orderPërfundon (capture) një porosi të krijuar më parë, që blerësi e ka miratuar në checkout-in e PayPal. Shumën e përcakton vetëm serveri.POST /api/public/access-request/stripe/create-checkoutKrijon një sesion checkout-i të Stripe-it për paketën e zgjedhur.POST /api/public/activate-accountAktivizon një llogari përdoruesi të krijuar rishtazi dhe vendos fjalëkalimin e parë – nisur përmes lidhjes në e-mailin e ftesës.