POST/api/public/consultation

Prijíma žiadosť o poradenstvo z formulára na webe Zentor App.

Povinné polia sú `name` (2–120 znakov), `email` (platná adresa) a `consentGiven`, ktoré musí byť `true`. Voliteľne možno poslať `company`, `phone` a `message`. Pri úspechu server odpoví `{"ok":true}` a potvrdzujúcou správou; následne sa ozve tím Zentor. Chýba-li povinné pole, je neplatné alebo chýba súhlas, endpoint odpovie 400 `VALIDATION_ERROR`. Každé úspešné volanie vytvorí novú požiadavku; volanie teda nie je idempotentné. 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/consultation. 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), consentGiven (body). Voliteľné parametre: company (body), message (body), phone (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 znakov
email(body, string, povinné)— Platná e-mailová adresa
company(body, string)— Firma (nepovinné)
message(body, string)— Správa (nepovinné)
phone(body, string)— Telefónne číslo (nepovinné)
consentGiven(body, boolean, povinné)— Súhlas s ochranou údajov, musí byť `true`

Príklad požiadavky

{"name":"Max Mustermann","email":"max@example.com","company":"Musterfirma","message":"Požiadavka","consentGiven":true}

Príklad odpovede

{"ok":true,"message":"Vaša požiadavka na konzultáciu bola odoslaná. Čoskoro sa vám ozveme."}

Chybové kódy

400 VALIDATION_ERROR — Chýba povinné pole alebo je neplatné, prípadne chýba súhlas.

Overené správanie

Úplné údaje vrátia 200; chýbajúce alebo neplatné údaje vrátia 400 `VALIDATION_ERROR`.

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

Súvisiace články

← Verejné formuláre