POST/api/public/consultation
Offentlig skjema for rådgivningsforespørsel på Zentor-nettstedet.
Siden «POST /api/public/consultation — API-referanse» omhandler funksjonsområdet som er angitt i URL-en. Det eksisterende innholdet suppleres med det faktiske forløpet, forutsetningene og de kjente begrensningene. Skjemabyggeren støtter fritt konfigurerbare skjemaer med utløsernøkkelord, felttyper og merking av obligatoriske felt. Funksjonen er E2E-testet. Dokumentasjonen for `POST /api/public/consultation` må leses som en teknisk beskrivelse av dette konkrete endepunktet. Avgjørende er metode, sti, autentisering, obligatoriske felt, mulige feil og spørsmålet om et nytt kall utløser samme effekt. Den aktuelle URL-en https://zentor-app.de/hilfe/api-referenz/formulare/forms.consultation skal derfor ikke inneholde generelle reklameutsagn, bare etterprøvbare integrasjonstrinn og dokumenterte svareksempler. Ved et kall til `/api/public/consultation` bygges forespørselen opp i samsvar med registeret. Offentlige ruter krever ingen generell utvikler-API-nøkkel, fordi Zentor ikke tilbyr noe slikt nøkkelsystem. Beskyttede widget-ruter bruker derimot embed-tokenet som vises én gang, og en Origin-kontroll. HTTP-statusen og JSON-innholdet må vurderes sammen; et `ok`-felt alene erstatter ikke feilhåndtering. Ved testing av `POST /api/public/consultation` skal det brukes anonymiserte verdier. Ekte kundedata, produktive UUID-er, økttokener og konkrete tidsstempler hører ikke hjemme i offentlige eksempler. Den kjente plattformomfattende grensen er 2.000 forespørsler innen 15 minutter; en avvikende enkeltgrense er ikke dokumentert. Ikke-idempotente POST-kall skal ikke gjentas blindt etter et uklart nettverksbrudd. Typiske integrasjonsfeil for denne ruten skyldes manglende obligatoriske parametere, feil datatyper, utløpte engangskoder, ikke-tillatte Origins eller en datapost som ikke finnes på forhånd. Applikasjonen bør behandle slike tilfeller hver for seg og logge feilmeldingen som endepunktet returnerer, uten å logge hemmelig innhold. En vellykket forespørsel bekrefter bare dette behandlingstrinnet, ikke automatisk et vellykket etterfølgende e-post-, betalings- eller SSO-trinn. Dette er direkte relevant for «POST /api/public/consultation». Den tekniske kontrollen av denne siden skal bindende baseres på registeret under `app/frontend/src/content/api-reference/` og de tilhørende backend-rutene. Live-test-merknader skal bare påstå det som faktisk er kontrollert. En negativtest eller en kodeanalogi er ikke et fullstendig suksessbevis. For POST /api/public/consultation — API-referanse må det derfor skilles tydelig mellom dokumentert struktur, automatisert test og sikkert observert live-atferd.
Autentisering og sikring
Ingen autentisering påkrevd
Idempotent: Nei
Parametere
name(body, string, påkrevd)— 2–120 tegnemail(body, string, påkrevd)— Gyldig e-postadressecompany(body, string)message(body, string)phone(body, string)consentGiven(body, boolean, påkrevd)— Må være trueEksempel på forespørsel
{"name":"Max Mustermann","email":"max@example.com","company":"Musterfirma","message":"Henvendelse","consentGiven":true}Eksempel på svar
{"ok":true,"message":"Forespørselen din om rådgivning er sendt. Vi tar kontakt med deg snart."}Feilkoder
400 VALIDATION_ERROR — Manglende eller ugyldig obligatorisk felt eller manglende samtykke.Live-testbevis
Suksess (200) og negativtilfelle (400) verifisert live.