POST/api/public/contact
Prijíma dotaz z kontaktného formulára na webe Zentor App a odovzdáva ho tímu Zentor.
Povinné polia sú `name` (2–120 znakov), `email` (platná e-mailová adresa), `message` (10–3000 znakov) a `consentGiven`, ktoré musí byť nastavené na `true`. Voliteľne možno poslať `company`, `phone` a `topic`. Pri úspechu server odpovie `{"ok":true}` a potvrdzujúcou správou. Chýba-li povinné pole, je neplatné alebo chýba súhlas, endpoint odpovie 400 `VALIDATION_ERROR`; pole `details` uvádza jednotlivé chyby, takže môžete označiť príslušné polia. Každé úspešné odoslanie vytvorí novú požiadavku. Zablokujte preto tlačidlo odoslania až do odpovede a 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/contact. 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), message (body), consentGiven (body). Voliteľné parametre: company (body), phone (body), topic (body). Zdokumentované chybové prípady: 400 VALIDATION_ERROR. 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é)— Platná e-mailová adresamessage(body, string, povinné)— Správa, 10–3000 znakovcompany(body, string)— Firma (nepovinné)phone(body, string)— Telefónne číslo (nepovinné)topic(body, string)— Predmet dotazu (nepovinné)consentGiven(body, boolean, povinné)— Súhlas s ochranou údajov, musí byť `true`Príklad požiadavky
{"name":"Max Mustermann","email":"max@example.com","message":"Vaša správa (min. 10 znakov).","consentGiven":true}Príklad odpovede
{"ok":true,"message":"Vaša požiadavka bola odoslaná."}Chybové kódy
400 VALIDATION_ERROR — Chýba povinné pole alebo je neplatné, prípadne chýba súhlas s ochranou údajov. `details` obsahuje jednotlivé chybové správy.Overené správanie
Úplné údaje vrátia 200; chýbajúce povinné polia alebo chýbajúci súhlas vrátia 400 `VALIDATION_ERROR`.
Verejné formuláre
POST /api/public/consultationPrijíma žiadosť o poradenstvo z formulára na webe Zentor App.POST /api/public/access-requestOdoš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.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.