POST/api/public/access-request

Oddaja zahtevo za dostop do paketa (Starter, Individualno ali 14-dnevna demo verzija). Pogoj je predhodno potrjen e-poštni naslov.

Najprej potrdite e-poštni naslov prek `POST /api/public/access-request/email/start-verification` in `POST /api/public/access-request/email/verify`. Nato pošljite `name`, isti `email`, paket `package` (`starter`, `individual` ali `demo_access`) in prejeti `verification_token`. Neobvezni so `company`, `phone`, `companyWebsite`, `paymentMethod` (`paypal`, `kreditkarte`, `rechnung`, `stripe_card` ali `stripe_sepa`), `wish` (`trial`, `subscription` ali `offer`; pri demo dostopu vedno `trial`) in `message`. Brez veljavne potrditve strežnik odgovori s 400 `EMAIL_NOT_VERIFIED`. Manjkajoča obvezna polja ali neveljavne vrednosti za paket, način plačila ali željo povzročijo 400 `VALIDATION_ERROR`. Vsaka uspešna zahteva se ustvari na novo in jo obdela Zentor; zato 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/access-request. 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), package (body). Neobvezni parametri: company (body), phone (body), companyWebsite (body), paymentMethod (body), wish (body), message (body). Dokumentirani primeri napak: 400 VALIDATION_ERROR, 400 EMAIL_NOT_VERIFIED. 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)— E-poštni naslov, predhodno potrjen prek `/email/verify`
package(body, string, obvezno)— Paket: `starter`, `individual` ali `demo_access`
company(body, string)— Podjetje, največ 160 znakov (neobvezno)
phone(body, string)— Telefonska številka, največ 40 znakov (neobvezno)
companyWebsite(body, string)— Spletno mesto podjetja, največ 200 znakov (neobvezno)
paymentMethod(body, string)— Način plačila: `paypal`, `kreditkarte`, `rechnung`, `stripe_card` ali `stripe_sepa` (neobvezno)
wish(body, string)— Želja: `trial`, `subscription` ali `offer`; pri `demo_access` vedno `trial` (neobvezno)
message(body, string)— Sporočilo, največ 3000 znakov (neobvezno)

Primer zahteve

{"name":"Janez Novak","email":"max@example.com","package":"demo_access"}

Primer odgovora

{"ok":false,"error":"EMAIL_NOT_VERIFIED","message":"Prosimo, najprej potrdite svoj e-poštni naslov."}

Kode napak

400 VALIDATION_ERROR — Manjka obvezno polje, ali so paket, način plačila ali želja neveljavni.
400 EMAIL_NOT_VERIFIED — E-poštni naslov prej ni bil potrjen prek `/email/start-verification` in `/email/verify`, ali `verification_token` manjka oziroma je neveljaven.

Preverjeno vedenje

Prazno telo vrne 400 `VALIDATION_ERROR`; veljavni podatki brez potrjenega e-poštnega naslova vrnejo 400 `EMAIL_NOT_VERIFIED`. Primer uspeha sledi dokumentiranemu postopku po potrditvi e-pošte.

Javni obrazci

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