POST/api/public/access-request
Odošle žiadosť o prístup k balíku (Starter, Individuálny alebo 14-dňové Demo). Vyžaduje sa predtým potvrdená e-mailová adresa.
Najprv potvrďte e-mailovú adresu cez `POST /api/public/access-request/email/start-verification` a `POST /api/public/access-request/email/verify`. Potom odošlite `name`, rovnaký `email`, balík `package` (`starter`, `individual` alebo `demo_access`) a získaný `verification_token`. Voliteľne možno poslať `company`, `phone`, `companyWebsite`, `paymentMethod` (`paypal`, `kreditkarte`, `rechnung`, `stripe_card` alebo `stripe_sepa`), `wish` (`trial`, `subscription` alebo `offer`; pri demo prístupe vždy `trial`) a `message`. Bez platného potvrdenia server odpovie 400 `EMAIL_NOT_VERIFIED`. Chýbajúce povinné polia alebo neplatné hodnoty balíka, spôsobu platby či želania vedú k 400 `VALIDATION_ERROR`. Každá úspešná žiadosť sa vytvorí ako nová a spracuje ju Zentor; preto volanie automaticky neopakujte. Najviac 10 požiadaviek za 15 minút na jednu IP adresu. Navyše platia prístupové pravidlá Zentor (pravidlá IP, krajiny a e-mailovej domény); odmietnuté požiadavky dostanú 403.
Prehľad
Volanie: POST /api/public/access-request. Tento endpoint patrí do skupiny „Verejné formuláre“ API aplikácie Zentor App. Je verejne dostupný a nevyžaduje žiadnu autentifikáciu. Volanie nie je idempotentné: Každé úspešné volanie akciu spustí znova. Povinné parametre: name (body), email (body), package (body). Voliteľné parametre: company (body), phone (body), companyWebsite (body), paymentMethod (body), wish (body), message (body). Zdokumentované chybové prípady: 400 VALIDATION_ERROR, 400 EMAIL_NOT_VERIFIED. Ukážková odpoveď nižšie zobrazuje štruktúru úspešnej odpovede vo formáte JSON.
Autentifikácia a zabezpečenie
Nevyžaduje sa žiadna autentifikácia
Idempotentné: Nie
Parametre
name(body, string, povinné)— Meno, 2–120 znakovemail(body, string, povinné)— E-mailová adresa predtým potvrdená cez `/email/verify`package(body, string, povinné)— Balík: `starter`, `individual` alebo `demo_access`company(body, string)— Firma, max. 160 znakov (nepovinné)phone(body, string)— Telefónne číslo, max. 40 znakov (nepovinné)companyWebsite(body, string)— Web firmy, max. 200 znakov (nepovinné)paymentMethod(body, string)— Spôsob platby: `paypal`, `kreditkarte`, `rechnung`, `stripe_card` alebo `stripe_sepa` (nepovinné)wish(body, string)— Želanie: `trial`, `subscription` alebo `offer`; pri `demo_access` vždy `trial` (nepovinné)message(body, string)— Správa, max. 3000 znakov (nepovinné)Príklad požiadavky
{"name":"Ján Novák","email":"max@example.com","package":"demo_access"}Príklad odpovede
{"ok":false,"error":"EMAIL_NOT_VERIFIED","message":"Prosím najprv potvrďte svoju e-mailovú adresu."}Chybové kódy
400 VALIDATION_ERROR — Chýba povinné pole, alebo balík, spôsob platby či želanie sú neplatné.400 EMAIL_NOT_VERIFIED — E-mailová adresa nebola predtým potvrdená cez `/email/start-verification` a `/email/verify`, alebo `verification_token` chýba či je neplatný.Overené správanie
Prázdne telo vráti 400 `VALIDATION_ERROR`; platné dáta bez potvrdenej e-mailovej adresy vrátia 400 `EMAIL_NOT_VERIFIED`. Prípad úspechu zodpovedá zdokumentovanému postupu po potvrdení e-mailu.
Verejné formuláre
POST /api/public/contactPrijíma dotaz z kontaktného formulára na webe Zentor App a odovzdáva ho tímu Zentor.POST /api/public/consultationPrijíma žiadosť o poradenstvo z formulára na webe Zentor App.POST /api/public/access-request/email/start-verificationOdošle šesťmiestny potvrdzovací kód platný 10 minút na uvedenú e-mailovú adresu – prvý krok žiadosti o prístup.POST /api/public/access-request/email/verifySkontroluje kód doručený e-mailom a vydá potvrdzovací token pre následnú žiadosť o prístup.GET /api/public/access-request/payment-statusUdáva, ktoré platobné metódy (PayPal, Stripe) sú aktuálne dostupné pre žiadosť o prístup.GET /api/public/access-request/paypal/configVracia verejnú konfiguráciu PayPal (aktívne, režim, mena) pre platobný krok.POST /api/public/access-request/paypal/create-orderVytvorí objednávku PayPal pre vybraný balík.POST /api/public/access-request/paypal/capture-orderDokončí (capture) predtým vytvorenú objednávku schválenú kupujúcim v checkoute PayPal. Sumu určuje výhradne server.POST /api/public/access-request/stripe/create-checkoutVytvorí platobnú relaciu Stripe Checkout pre vybraný balík.POST /api/public/activate-accountAktivuje novo vytvorený používateľský účet a nastaví prvé heslo – spustené cez odkaz v pozývacom e-maile.