POST/api/public/contact

Offentlig kontaktskjema på Zentor-nettstedet. Oppretter en forespørsel i det interne lead-systemet.

`POST /api/public/contact` behandler det offentlige kontaktformulæret på Zentor-nettstedet og lagrer forespørselen i det interne lead-systemet. Endepunktet krever ingen dashboard-autentisering og er ikke idempotent. Hver vellykket overføring kan generere et nytt lead. Frontendet bør derfor deaktivere Send-knappen etter første klikk og ikke utløse automatiske gjentakelser. De bekreftede obligatoriske feltene er `name`, `email` og `message`. Navnet må være mellom 2 og 120 tegn langt, e-postadressen må ha et gyldig format, og meldingen må oppfylle serverens valideringsregler. Ytterligere felt kan kun sendes hvis de er foreskrevet i det faktiske skjemaet. Ukjente verdier bør ikke brukes til å styre interne lead-egenskaper. Et korrekt skjema sjekker obligatoriske felt allerede i nettleseren, men stoler ikke utelukkende på denne sjekken. Serveren er avgjørende. Ved en valideringsfeil bør grensesnittet merke det berørte feltet og beholde de innmatte innholdene. En generell vellykket melding skal først vises etter en positiv svar fra serveren. Kontaktformulæret er ikke et sikkert kanal for passord, API-nøkler, widget-tokens, betalingsdata eller komplette kundeopplysninger. Brukerne bør oppgi anvendelsesområdet, det berørte produktet og en tilgjengelig forretnings-e-postadresse. Ved tekniske problemer hjelper tenant-navn, tidspunkt, berørt funksjon og gjentagelige trinn, uten å overføre unødvendige personopplysninger. En realistisk prosess: Besøkeren fyller ut navn, e-post og melding, bekrefter eventuelt nettsidens personverninformasjon og sender skjemaet. Serveren validerer dataene, oppretter leadet og leverer et vellykket svar. Ved ugyldig e-post eller for kort navn opprettes ikke et komplett lead. Endepunktet oppretter ikke en tenant, bokfører ikke et abonnement og erstatter ikke den strukturerte produktkonfigurasjonen eller rådgivningsprosessen. For beskyttelse mot spam og automatiserte serieforespørsler bør klienten respektere serverens feilmeldinger og ikke starte umiddelbare endeløse løkker. Et vellykket svar bør først tømme inndatafeltene når serveren har bekreftet mottak. Hvis svaret uteblir, kan brukeren lagre innholdet og senere sende det kontrollert på nytt. For intern tilordning bør meldingen inneholde den faktiske årsaken, uten markedsføringsfloskler eller konfidensielle vedlegg. Et tydelig emne og en presis problembeskrivelse reduserer oppfølgende spørsmål. API gir imidlertid ikke en garantert prioritet og bekrefter ikke en fast bearbeidelsesfrist.

Autentisering og sikring

Ingen autentisering påkrevd

Idempotent: Nei

Parametere

name(body, string, påkrevd)— 2–120 tegn
email(body, string, påkrevd)— Gyldig e-postadresse
message(body, string, påkrevd)— 10–3000 tegn
company(body, string)
phone(body, string)
topic(body, string)
consentGiven(body, boolean, påkrevd)— Må være true (samtykke til personvern)

Eksempel på forespørsel

{"name":"Max Mustermann","email":"max@example.com","message":"Meldingen din (minst 10 tegn).","consentGiven":true}

Eksempel på svar

{"ok":true,"message":"Din forespørsel er sendt."}

Feilkoder

400 VALIDATION_ERROR — Manglende eller ugyldig obligatorisk felt, eller manglende samtykke til personvern (detaljer i feilarray).

Live-testbevis

Suksess (200) og negativtilfelle (400, manglende felt inkl. manglende samtykke) verifisert live.

← Offentlige skjema