POST/api/public/contact

Tar emot en förfrågan från kontaktformuläret på Zentor App-webbplatsen och vidarebefordrar den till Zentor-teamet.

Obligatoriska fält är `name` (2–120 tecken), `email` (giltig e-postadress), `message` (10–3000 tecken) och `consentGiven`, som måste vara satt till `true`. Valfritt kan `company`, `phone` och `topic` skickas med. Vid framgång svarar servern med `{"ok":true}` och ett bekräftelsemeddelande. Saknas ett obligatoriskt fält, är det ogiltigt, eller saknas samtycket, svarar slutpunkten med 400 `VALIDATION_ERROR`; fältet `details` listar de enskilda felen så att du kan markera de berörda inmatningsfälten. Varje lyckad inlämning skapar en ny förfrågan. Inaktivera därför skicka-knappen tills svaret kommer, och upprepa 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/contact. 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), message (body), consentGiven (body). Valfria parametrar: company (body), phone (body), topic (body). Dokumenterade felfall: 400 VALIDATION_ERROR. 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 tecken
email(body, string, obligatorisk)— Giltig e-postadress
message(body, string, obligatorisk)— Meddelande, 10–3000 tecken
company(body, string)— Företag (valfritt)
phone(body, string)— Telefonnummer (valfritt)
topic(body, string)— Ämne för förfrågan (valfritt)
consentGiven(body, boolean, obligatorisk)— Dataskyddssamtycke, måste vara `true`

Exempel på request

{"name":"Max Mustermann","email":"max@example.com","message":"Ditt meddelande (minst 10 tecken).","consentGiven":true}

Exempel på response

{"ok":true,"message":"Din förfrågan har skickats in."}

Felkoder

400 VALIDATION_ERROR — Ett obligatoriskt fält saknas eller är ogiltigt, eller dataskyddssamtycket saknas. `details` innehåller de enskilda felmeddelandena.

Verifierat beteende

Fullständiga uppgifter returnerar 200; saknade obligatoriska fält eller saknat samtycke returnerar 400 `VALIDATION_ERROR`.

Offentliga formulär

POST /api/public/consultationTar emot en rådgivningsförfrågan från formuläret på Zentor App-webbplatsen.POST /api/public/access-requestSkickar in en åtkomstbegäran för ett paket (Starter, Individuell eller 14-dagars demo). Det krävs en tidigare bekräftad e-postadress.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.

Relaterade artiklar

← Offentliga formulär