POST/api/public/access-request
Skickar in en åtkomstbegäran för ett paket (Starter, Individuell eller 14-dagars demo). Det krävs en tidigare bekräftad e-postadress.
Bekräfta först e-postadressen via `POST /api/public/access-request/email/start-verification` och `POST /api/public/access-request/email/verify`. Skicka sedan `name`, samma `email`, paketet `package` (`starter`, `individual` eller `demo_access`) och den mottagna `verification_token`. Valfria är `company`, `phone`, `companyWebsite`, `paymentMethod` (`paypal`, `kreditkarte`, `rechnung`, `stripe_card` eller `stripe_sepa`), `wish` (`trial`, `subscription` eller `offer`; alltid `trial` vid demoåtkomst) och `message`. Utan giltig bekräftelse svarar servern med 400 `EMAIL_NOT_VERIFIED`. Saknade obligatoriska fält eller ogiltiga värden för paket, betalningsmetod eller önskemål resulterar i 400 `VALIDATION_ERROR`. Varje lyckad förfrågan skapas på nytt och behandlas av Zentor; upprepa därför inte anropet automatiskt. Högst 10 förfrågningar per 15 minuter per IP-adress. Dessutom gäller Zentors åtkomstregler (IP-, lands- och e-postdomänregler); avvisade anrop får 403.
Översikt
Anrop: POST /api/public/access-request. Endpointen tillhör gruppen ”Offentliga formulär” i Zentor Apps API. Den är offentligt tillgänglig och kräver ingen autentisering. Anropet är inte idempotent: Varje lyckat anrop utlöser åtgärden på nytt. Obligatoriska parametrar: name (body), email (body), package (body). Valfria parametrar: company (body), phone (body), companyWebsite (body), paymentMethod (body), wish (body), message (body). Dokumenterade felfall: 400 VALIDATION_ERROR, 400 EMAIL_NOT_VERIFIED. Exempelsvaret nedan visar strukturen för ett lyckat svar i JSON-format.
Autentisering & säkerhet
Ingen autentisering krävs
Idempotent: Nej
Parametrar
name(body, string, obligatorisk)— Namn, 2–120 teckenemail(body, string, obligatorisk)— E-postadress som tidigare bekräftats via `/email/verify`package(body, string, obligatorisk)— Paket: `starter`, `individual` eller `demo_access`company(body, string)— Företag, högst 160 tecken (valfritt)phone(body, string)— Telefonnummer, högst 40 tecken (valfritt)companyWebsite(body, string)— Företagets webbplats, högst 200 tecken (valfritt)paymentMethod(body, string)— Betalningsmetod: `paypal`, `kreditkarte`, `rechnung`, `stripe_card` eller `stripe_sepa` (valfritt)wish(body, string)— Önskemål: `trial`, `subscription` eller `offer`; alltid `trial` vid `demo_access` (valfritt)message(body, string)— Meddelande, högst 3000 tecken (valfritt)Exempel på request
{"name":"Sven Svensson","email":"max@example.com","package":"demo_access"}Exempel på response
{"ok":false,"error":"EMAIL_NOT_VERIFIED","message":"Vänligen bekräfta först din e-postadress."}Felkoder
400 VALIDATION_ERROR — Ett obligatoriskt fält saknas, eller paket, betalningsmetod eller önskemål är ogiltigt.400 EMAIL_NOT_VERIFIED — E-postadressen har inte tidigare bekräftats via `/email/start-verification` och `/email/verify`, eller `verification_token` saknas eller är ogiltig.Verifierat beteende
En tom kropp returnerar 400 `VALIDATION_ERROR`; giltiga uppgifter utan bekräftad e-postadress returnerar 400 `EMAIL_NOT_VERIFIED`. Framgångsfallet följer det dokumenterade förloppet efter e-postbekräftelse.
Offentliga formulär
POST /api/public/contactTar emot en förfrågan från kontaktformuläret på Zentor App-webbplatsen och vidarebefordrar den till Zentor-teamet.POST /api/public/consultationTar emot en rådgivningsförfrågan från formuläret på Zentor App-webbplatsen.POST /api/public/access-request/email/start-verificationSkickar en sexsiffrig bekräftelsekod, giltig i 10 minuter, till den angivna e-postadressen – det första steget i en åtkomstbegäran.POST /api/public/access-request/email/verifyKontrollerar koden som skickas via e-post och utfärdar en bekräftelsetoken för den efterföljande åtkomstbegäran.GET /api/public/access-request/payment-statusAnger vilka betalningsmetoder (PayPal, Stripe) som för tillfället är tillgängliga för åtkomstbegäran.GET /api/public/access-request/paypal/configReturnerar den offentliga PayPal-konfigurationen (aktiverad, läge, valuta) för betalningssteget.POST /api/public/access-request/paypal/create-orderSkapar en PayPal-order för det valda paketet.POST /api/public/access-request/paypal/capture-orderSlutför (capture) en tidigare skapad order som köparen har godkänt i PayPal-checkouten. Beloppet fastställs uteslutande av servern.POST /api/public/access-request/stripe/create-checkoutSkapar en Stripe-checkoutsession för det valda paketet.POST /api/public/activate-accountAktiverar ett nyskapat användarkonto och ställer in det första lösenordet – utlöst via länken i inbjudningsmejlet.