POST/api/public/consultation

Pranon një kërkesë për konsulencë nga formulari i faqes së internetit të Zentor App.

Fushat e detyrueshme janë `name` (2–120 shkronja), `email` (adresë e-maili e vlefshme) dhe `consentGiven`, që duhet të jetë vendosur në `true`. Opsionale mund të dërgohen `company`, `phone` dhe `message`. Në rast suksesi, serveri përgjigjet me `{"ok":true}` dhe një mesazh konfirmimi; ekipi i Zentor kontakton më pas. Nëse një fushë e detyrueshme mungon, është e pavlefshme ose mungon pëlqimi, endpoint-i përgjigjet me 400 `VALIDATION_ERROR`. Çdo thirrje e suksesshme krijon një kërkesë të re; thirrja prandaj nuk është idempotente. 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/consultation. 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), consentGiven (body). Parametrat opsionalë: company (body), message (body), phone (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 shkronja
email(body, string, i detyrueshëm)— Adresë e-maili e vlefshme
company(body, string)— Kompania (opsionale)
message(body, string)— Mesazhi (opsionale)
phone(body, string)— Numri i telefonit (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","company":"Musterfirma","message":"Kërkesë","consentGiven":true}

Shembull response-i

{"ok":true,"message":"Kërkesa juaj për konsulencë u dërgua. Do t'ju kontaktojmë së shpejti."}

Kodet e gabimeve

400 VALIDATION_ERROR — Një fushë e detyrueshme mungon ose është e pavlefshme, ose mungon pëlqimi.

Sjellja e verifikuar

Të dhënat e plota kthejnë 200; të dhënat që mungojnë ose janë të pavlefshme kthejnë 400 `VALIDATION_ERROR`.

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

Artikuj të lidhur

← Formularët publikë