POST/api/public/contact
Pranon një kërkesë nga formulari i kontaktit në faqen e internetit të Zentor App dhe ia përcjell ekipit të Zentor.
Fushat e detyrueshme janë `name` (2–120 shkronja), `email` (adresë e-maili e vlefshme), `message` (10–3000 shkronja) dhe `consentGiven`, që duhet të jetë vendosur në `true`. Opsionale mund të dërgohen `company`, `phone` dhe `topic`. Në rast suksesi, serveri përgjigjet me `{"ok":true}` dhe një mesazh konfirmimi. Nëse një fushë e detyrueshme mungon, është e pavlefshme ose mungon pëlqimi, endpoint-i përgjigjet me 400 `VALIDATION_ERROR`; fusha `details` liston gabimet individuale, që të mund të shënoni fushat përkatëse të hyrjes. Çdo dërgim i suksesshëm krijon një kërkesë të re. Për këtë arsye, blokoni butonin e dërgimit deri në marrjen e përgjigjes dhe mos e përsërisni automatikisht thirrjen. 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.
Përmbledhje
Thirrja: POST /api/public/contact. 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: name (body), email (body), message (body), consentGiven (body). Parametrat opsionalë: company (body), phone (body), topic (body). Rastet e dokumentuara të gabimeve: 400 VALIDATION_ERROR. Përgjigjja shembull më poshtë tregon strukturën e një përgjigjeje të suksesshme në formatin JSON.
Autentifikimi dhe siguria
Nuk kërkohet autentifikim
Idempotent: Jo
Parametrat
name(body, string, i detyrueshëm)— Emri, 2–120 shkronjaemail(body, string, i detyrueshëm)— Adresë e-maili e vlefshmemessage(body, string, i detyrueshëm)— Mesazhi, 10–3000 shkronjacompany(body, string)— Kompania (opsionale)phone(body, string)— Numri i telefonit (opsionale)topic(body, string)— Tema e kërkesës (opsionale)consentGiven(body, boolean, i detyrueshëm)— Pëlqimi i privatësisë, duhet të jetë `true`Shembull request-i
{"name":"Max Mustermann","email":"max@example.com","message":"Mesazhi juaj (paktën 10 shenja).","consentGiven":true}Shembull response-i
{"ok":true,"message":"Kërkesa juaj u dërgua."}Kodet e gabimeve
400 VALIDATION_ERROR — Një fushë e detyrueshme mungon ose është e pavlefshme, ose mungon pëlqimi i privatësisë. `details` përmban mesazhet individuale të gabimit.Sjellja e verifikuar
Të dhënat e plota kthejnë 200; fushat e detyrueshme që mungojnë ose pëlqimi që mungon kthejnë 400 `VALIDATION_ERROR`.
Formularët publikë
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/start-verificationDë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.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.