POST/api/public/consultation

Sprejme povpraševanje za posvetovanje iz obrazca spletnega mesta Zentor App.

Obvezna polja so `name` (2–120 znakov), `email` (veljaven e-poštni naslov) in `consentGiven`, ki mora biti nastavljeno na `true`. Neobvezno lahko pošljete `company`, `phone` in `message`. Ob uspehu strežnik odgovori s `{"ok":true}` in sporočilom o potrditvi; nato se javi ekipa Zentor. Če obvezno polje manjka, je neveljavno ali manjka privolitev, končna točka odgovori s 400 `VALIDATION_ERROR`. Vsak uspešen klic ustvari novo povpraševanje; klic zato ni idempotenten. Največ 10 zahtev na 15 minut na IP-naslov. Dodatno veljajo dostopna pravila Zentor (pravila za IP, države in e-poštne domene); zavrnjeni klici prejmejo 403.

Pregled

Klic: POST /api/public/consultation. Ta endpoint spada v skupino »Javni obrazci« API-ja Zentor App. Je javno dostopen in ne zahteva overjanja. Klic ni idempotenten: vsak uspešen klic znova sproži dejanje. Obvezni parametri: name (body), email (body), consentGiven (body). Neobvezni parametri: company (body), message (body), phone (body). Dokumentirani primeri napak: 400 VALIDATION_ERROR. Spodnji primer odgovora prikazuje strukturo uspešnega odgovora v formatu JSON.

Avtentikacija in zaščita

Avtentikacija ni potrebna

Idempotentno: Ne

Parametri

name(body, string, obvezno)— Ime, 2–120 znakov
email(body, string, obvezno)— Veljaven e-poštni naslov
company(body, string)— Podjetje (neobvezno)
message(body, string)— Sporočilo (neobvezno)
phone(body, string)— Telefonska številka (neobvezno)
consentGiven(body, boolean, obvezno)— Privolitev za varstvo podatkov, mora biti `true`

Primer zahteve

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

Primer odgovora

{"ok":true,"message":"Vaše svetovalno povpraševanje je bilo poslano. Kmalu se vam bomo oglasili."}

Kode napak

400 VALIDATION_ERROR — Obvezno polje manjka ali je neveljavno, ali manjka privolitev.

Preverjeno vedenje

Popolni podatki vrnejo 200; manjkajoči ali neveljavni podatki vrnejo 400 `VALIDATION_ERROR`.

Javni obrazci

POST /api/public/contactSprejme povpraševanje iz kontaktnega obrazca spletnega mesta Zentor App in ga posreduje ekipi Zentor.POST /api/public/access-requestOddaja zahtevo za dostop do paketa (Starter, Individualno ali 14-dnevna demo verzija). Pogoj je predhodno potrjen e-poštni naslov.POST /api/public/access-request/email/start-verificationPošlje šestmestno potrditveno kodo, veljavno 10 minut, na navedeni e-poštni naslov – prvi korak zahteve za dostop.POST /api/public/access-request/email/verifyPreveri kodo, dostavljeno po e-pošti, in izda potrditveni žeton za naslednjo zahtevo za dostop.GET /api/public/access-request/payment-statusNavede, kateri plačilni načini (PayPal, Stripe) so trenutno na voljo za zahtevo za dostop.GET /api/public/access-request/paypal/configVrne javno konfiguracijo PayPal (aktivno, način, valuta) za korak plačila.POST /api/public/access-request/paypal/create-orderUstvari naročilo PayPal za izbrani paket.POST /api/public/access-request/paypal/capture-orderZaključi (capture) predhodno ustvarjeno naročilo, ki ga je kupec potrdil v PayPal checkoutu. Znesek določi izključno strežnik.POST /api/public/access-request/stripe/create-checkoutUstvari sejo Stripe checkout za izbrani paket.POST /api/public/activate-accountAktivira novo ustvarjen uporabniški račun in nastavi prvo geslo – sproži se prek povezave v e-pošti s povabilom.

Sorodni članki

← Javni obrazci