POST/api/public/access-request
Sender inn en tilgangsforespørsel for en pakke (Starter, Individuell eller 14-dagers demo). Det krever en tidligere bekreftet e-postadresse.
Bekreft først e-postadressen via `POST /api/public/access-request/email/start-verification` og `POST /api/public/access-request/email/verify`. Send deretter `name`, samme `email`, pakken `package` (`starter`, `individual` eller `demo_access`) og det mottatte `verification_token`. Valgfrie er `company`, `phone`, `companyWebsite`, `paymentMethod` (`paypal`, `kreditkarte`, `rechnung`, `stripe_card` eller `stripe_sepa`), `wish` (`trial`, `subscription` eller `offer`; alltid `trial` ved demotilgang) og `message`. Uten gyldig bekreftelse svarer serveren med 400 `EMAIL_NOT_VERIFIED`. Manglende obligatoriske felter eller ugyldige verdier for pakke, betalingsmetode eller ønske resulterer i 400 `VALIDATION_ERROR`. Hver vellykket forespørsel opprettes på nytt og behandles av Zentor; gjenta derfor ikke kallet automatisk. Høyst 10 forespørsler per 15 minutter per IP-adresse. I tillegg gjelder Zentors tilgangsregler (IP-, land- og e-postdomeneregler); avviste kall får 403.
Oversikt
Kall: POST /api/public/access-request. Endepunktet tilhører gruppen «Offentlige skjemaer» i API-et til Zentor App. Det er offentlig tilgjengelig og krever ingen autentisering. Kallet er ikke idempotent: Hvert vellykket kall utløser handlingen på nytt. Obligatoriske parametere: name (body), email (body), package (body). Valgfrie parametere: company (body), phone (body), companyWebsite (body), paymentMethod (body), wish (body), message (body). Dokumenterte feiltilfeller: 400 VALIDATION_ERROR, 400 EMAIL_NOT_VERIFIED. Eksempelsvaret nedenfor viser strukturen til et vellykket svar i JSON-format.
Autentisering og sikring
Ingen autentisering påkrevd
Idempotent: Nei
Parametere
name(body, string, påkrevd)— Navn, 2–120 tegnemail(body, string, påkrevd)— E-postadresse som tidligere er bekreftet via `/email/verify`package(body, string, påkrevd)— Pakke: `starter`, `individual` eller `demo_access`company(body, string)— Firma, maks. 160 tegn (valgfritt)phone(body, string)— Telefonnummer, maks. 40 tegn (valgfritt)companyWebsite(body, string)— Virksomhetens nettsted, maks. 200 tegn (valgfritt)paymentMethod(body, string)— Betalingsmetode: `paypal`, `kreditkarte`, `rechnung`, `stripe_card` eller `stripe_sepa` (valgfritt)wish(body, string)— Ønske: `trial`, `subscription` eller `offer`; alltid `trial` ved `demo_access` (valgfritt)message(body, string)— Melding, maks. 3000 tegn (valgfritt)Eksempel på forespørsel
{"name":"Ola Nordmann","email":"max@example.com","package":"demo_access"}Eksempel på svar
{"ok":false,"error":"EMAIL_NOT_VERIFIED","message":"Bekreft først e-postadressen din."}Feilkoder
400 VALIDATION_ERROR — Et obligatorisk felt mangler, eller pakke, betalingsmetode eller ønske er ugyldig.400 EMAIL_NOT_VERIFIED — E-postadressen er ikke tidligere bekreftet via `/email/start-verification` og `/email/verify`, eller `verification_token` mangler eller er ugyldig.Verifisert oppførsel
En tom kropp returnerer 400 `VALIDATION_ERROR`; gyldige data uten bekreftet e-postadresse returnerer 400 `EMAIL_NOT_VERIFIED`. Suksesstilfellet følger det dokumenterte forløpet etter e-postbekreftelse.
Offentlige skjemaer
POST /api/public/contactMottar en forespørsel fra kontaktformularen på Zentor App-nettstedet og videresender den til Zentor-teamet.POST /api/public/consultationMottar en rådgivningsforespørsel fra formularen på Zentor App-nettstedet.POST /api/public/access-request/email/start-verificationSender en sekssifret bekreftelseskode, gyldig i 10 minutter, til den angitte e-postadressen – det første trinnet i en tilgangsforespørsel.POST /api/public/access-request/email/verifyKontrollerer koden som sendes via e-post, og utsteder et bekreftelsestoken for den etterfølgende tilgangsforespørselen.GET /api/public/access-request/payment-statusAngir hvilke betalingsmetoder (PayPal, Stripe) som for øyeblikket er tilgjengelige for tilgangsforespørselen.GET /api/public/access-request/paypal/configReturnerer den offentlige PayPal-konfigurasjonen (aktivert, modus, valuta) for betalingssteget.POST /api/public/access-request/paypal/create-orderOppretter en PayPal-ordre for den valgte pakken.POST /api/public/access-request/paypal/capture-orderFullfører (capture) en tidligere opprettet ordre som kjøperen har godkjent i PayPal-checkouten. Beløpet fastsettes utelukkende av serveren.POST /api/public/access-request/stripe/create-checkoutOppretter en Stripe-checkout-sesjon for den valgte pakken.POST /api/public/activate-accountAktiverer en nyopprettet brukerkonto og setter det første passordet – utløst via lenken i invitasjons-e-posten.