POST/api/public/access-request

Dërgon një kërkesë aksesi për një paketë (Starter, Individuale ose demo 14-ditore). Parakusht është një adresë e-maili e konfirmuar paraprakisht.

Konfirmoni fillimisht adresën e e-mailit përmes `POST /api/public/access-request/email/start-verification` dhe `POST /api/public/access-request/email/verify`. Pastaj dërgoni `name`, të njëjtën `email`, paketën `package` (`starter`, `individual` ose `demo_access`) dhe `verification_token`-in e marrë. Opsionale janë `company`, `phone`, `companyWebsite`, `paymentMethod` (`paypal`, `kreditkarte`, `rechnung`, `stripe_card` ose `stripe_sepa`), `wish` (`trial`, `subscription` ose `offer`; te qasja demo gjithmonë `trial`) dhe `message`. Pa konfirmim të vlefshëm, serveri përgjigjet me 400 `EMAIL_NOT_VERIFIED`. Fushat e detyrueshme që mungojnë ose vlerat e pavlefshme për paketën, mënyrën e pagesës ose dëshirën çojnë në 400 `VALIDATION_ERROR`. Çdo kërkesë e suksesshme krijohet rishtazi dhe përpunohet nga Zentor; prandaj 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/access-request. 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), package (body). Parametrat opsionalë: company (body), phone (body), companyWebsite (body), paymentMethod (body), wish (body), message (body). Rastet e dokumentuara të gabimeve: 400 VALIDATION_ERROR, 400 EMAIL_NOT_VERIFIED. 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)— Adresa e e-mailit, e konfirmuar paraprakisht përmes `/email/verify`
package(body, string, i detyrueshëm)— Paketa: `starter`, `individual` ose `demo_access`
company(body, string)— Kompania, maksimumi 160 shkronja (opsionale)
phone(body, string)— Numri i telefonit, maksimumi 40 shkronja (opsionale)
companyWebsite(body, string)— Faqja e internetit e kompanisë, maksimumi 200 shkronja (opsionale)
paymentMethod(body, string)— Mënyra e pagesës: `paypal`, `kreditkarte`, `rechnung`, `stripe_card` ose `stripe_sepa` (opsionale)
wish(body, string)— Dëshira: `trial`, `subscription` ose `offer`; te `demo_access` gjithmonë `trial` (opsionale)
message(body, string)— Mesazhi, maksimumi 3000 shkronja (opsionale)

Shembull request-i

{"name":"Arben Hoxha","email":"max@example.com","package":"demo_access"}

Shembull response-i

{"ok":false,"error":"EMAIL_NOT_VERIFIED","message":"Ju lutem, konfirmoni së pari adresën tuaj të email-it."}

Kodet e gabimeve

400 VALIDATION_ERROR — Mungon një fushë e detyrueshme, ose paketa, mënyra e pagesës ose dëshira janë të pavlefshme.
400 EMAIL_NOT_VERIFIED — Adresa e e-mailit nuk është konfirmuar paraprakisht përmes `/email/start-verification` dhe `/email/verify`, ose `verification_token` mungon ose është i pavlefshëm.

Sjellja e verifikuar

Një trup bosh kthen 400 `VALIDATION_ERROR`; të dhëna të vlefshme pa adresë e-maili të konfirmuar kthejnë 400 `EMAIL_NOT_VERIFIED`. Rasti i suksesit ndjek procesin e dokumentuar pas konfirmimit të e-mailit.

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-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ë