POST/api/public/consultation

Offentligt rådgivningsanmodningsformular på Zentor-webstedet.

Siden „POST /api/public/consultation — API-Referenz" behandler det funktionsområde, der er angivet i URL'en. Det eksisterende indhold suppleres med det faktiske forløb, forudsætningerne og de kendte begrænsninger. Formularbyggesættet understøtter frit konfigurerbare formularer med trigger-nøgleord, feltyper og markering af obligatoriske felter. Funktionen er E2E-testet. Dokumentationen for `POST /api/public/consultation` skal læses som en teknisk beskrivelse af dette konkrete endpoint. Det afgørende er metode, sti, autentificering, obligatoriske felter, mulige fejl og spørgsmålet om, hvorvidt et nyt kald udløser samme effekt. Den foreliggende URL https://zentor-app.de/hilfe/api-referenz/formulare/forms.consultation må derfor ikke indeholde generelle reklameudsagn, men kun umiddelbart gennemførlige integrationstrin og dokumenterede svareksempler. For et kald til `/api/public/consultation` opbygges anmodningen i overensstemmelse med registret. Offentlige ruter kræver ingen generel udvikler-API-nøgle, fordi Zentor ikke tilbyder et sådant nøglesystem. Beskyttede widget-ruter bruger derimod den engangsviste embed-token og en origin-kontrol. HTTP-statusen og JSON-indholdet skal vurderes sammen; et `ok`-felt alene erstatter ikke fejlhåndtering. Ved test af `POST /api/public/consultation` skal der anvendes anonymiserede værdier. Reelle kundedata, produktions-UUID'er, sessionstokens og konkrete tidsstempler hører ikke til i offentlige eksempler. Den kendte platformsdækkende grænse er 2.000 anmodninger inden for 15 minutter; et afvigende individuelt limit er ikke dokumenteret. Ikke-idempotente POST-kald må ikke blindt gentages efter en uklar netværksafbrydelse. Typiske integrationsfejl for denne route opstår på grund af manglende obligatoriske parametre, forkerte datatyper, udløbne engangskoder, ikke-tilladte origins eller en post, der ikke findes på forhånd. Applikationen bør håndtere sådanne tilfælde separat og logge den fejlmeddelelse, som endpointet returnerer, uden at skrive hemmeligt indhold med. En vellykket request bekræfter kun dette behandlingstrin, ikke automatisk en efterfølgende e-mail-, betalings- eller SSO-succes. Dette er umiddelbart relevant for "POST /api/public/consultation". Den tekniske gennemgang af denne side skal bindende baseres på registret under `app/frontend/src/content/api-reference/` og de tilhørende backend-ruter. Live-test-notater må kun hævde det, der faktisk er blevet testet. En negativ test eller en kodeanalogi er ikke et fuldstændigt bevis på succes. For POST /api/public/consultation — API-reference skal der derfor klart skelnes mellem dokumenteret struktur, automatiseret test og sikkert observeret live-adfærd.

Auth & Absicherung

Keine Authentifizierung erforderlich

Idempotent: Nein

Parameter

name(body, string, erforderlich)2–120 tegn
email(body, string, erforderlich)Gyldig e-mailadresse
company(body, string)
message(body, string)
phone(body, string)
consentGiven(body, boolean, erforderlich)Skal være sandt

Beispiel-Request

{"name":"Max Mustermann","email":"max@example.com","company":"Mønstervirksomhed","message":"Anliggende","consentGiven":true}

Beispiel-Response

{"ok":true,"message":"Deres konsultationsanmodning er blevet sendt. Vi kontakter Dem snart."}

Fehlercodes

400 VALIDATION_ERRORObligatorisk felt mangler/ugyldigt, eller samtykke mangler.

Live-Test-Nachweis

Succes (200) og negativt tilfælde (400) live verificeret.

Offentlige formularer