POST/api/public/contact

Sprejme povpraševanje iz kontaktnega obrazca spletnega mesta Zentor App in ga posreduje ekipi Zentor.

Obvezna polja so `name` (2–120 znakov), `email` (veljaven e-poštni naslov), `message` (10–3000 znakov) in `consentGiven`, ki mora biti nastavljeno na `true`. Neobvezno lahko pošljete `company`, `phone` in `topic`. Ob uspehu strežnik odgovori s `{"ok":true}` in sporočilom o potrditvi. Če obvezno polje manjka, je neveljavno ali manjka privolitev, končna točka odgovori s 400 `VALIDATION_ERROR`; polje `details` navede posamezne napake, da lahko označite prizadeta vnosna polja. Vsaka uspešna oddaja ustvari novo povpraševanje. Zato blokirajte gumb za pošiljanje do prejema odgovora in klica ne ponavljajte samodejno. 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/contact. 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), message (body), consentGiven (body). Neobvezni parametri: company (body), phone (body), topic (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
message(body, string, obvezno)— Sporočilo, 10–3000 znakov
company(body, string)— Podjetje (neobvezno)
phone(body, string)— Telefonska številka (neobvezno)
topic(body, string)— Tema povpraševanja (neobvezno)
consentGiven(body, boolean, obvezno)— Privolitev za varstvo podatkov, mora biti `true`

Primer zahteve

{"name":"Max Mustermann","email":"max@example.com","message":"Vaše sporočilo (najmanj 10 znakov).","consentGiven":true}

Primer odgovora

{"ok":true,"message":"Vaše povpraševanje je bilo poslano."}

Kode napak

400 VALIDATION_ERROR — Obvezno polje manjka ali je neveljavno, ali manjka privolitev za varstvo podatkov. `details` vsebuje posamezna sporočila o napakah.

Preverjeno vedenje

Popolni podatki vrnejo 200; manjkajoča obvezna polja ali manjkajoča privolitev vrnejo 400 `VALIDATION_ERROR`.

Javni obrazci

POST /api/public/consultationSprejme povpraševanje za posvetovanje iz obrazca spletnega mesta Zentor App.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