POST/api/public/consultation
Offentligt formulär för rådgivningsförfrågan på Zentors webbplats.
Sidan ”POST /api/public/consultation — API-referens” behandlar det funktionsområde som anges i URL:en. Det befintliga innehållet kompletteras med det faktiska förloppet, förutsättningarna och de kända begränsningarna. Formulärbyggaren stöder fritt konfigurerbara formulär med utlösande nyckelord, fälttyper och markering av obligatoriska fält. Funktionen är E2E-testad. Dokumentationen för `POST /api/public/consultation` måste läsas som en teknisk beskrivning av just denna endpoint. Avgörande är metod, sökväg, autentisering, obligatoriska fält, möjliga fel och frågan om ett nytt anrop utlöser samma effekt. Den aktuella URL:en https://zentor-app.de/hilfe/api-referenz/formulare/forms.consultation får därför inte innehålla några allmänna reklampåståenden, utan endast begripliga integrationssteg och styrkta svarsexempel. För ett anrop till `/api/public/consultation` byggs begäran upp enligt registret. Offentliga routes kräver ingen allmän API-nyckel för utvecklare, eftersom Zentor inte erbjuder något sådant nyckelsystem. Skyddade widget-routes använder däremot den embed-token som visas en enda gång samt en origin-kontroll. HTTP-status och JSON-innehåll måste utvärderas tillsammans; ett `ok`-fält ensamt ersätter inte felhantering. Vid test av `POST /api/public/consultation` ska anonymiserade värden användas. Verkliga kunddata, produktiva UUID:er, sessionstokens och konkreta tidsstämplar hör inte hemma i offentliga exempel. Den kända plattformsövergripande gränsen är 2.000 begäranden inom 15 minuter; en avvikande enskild gräns är inte belagd. Icke-idempotenta POST-anrop får inte upprepas blint efter ett oklart nätverksavbrott. Typiska integrationsfel för denna route beror på saknade obligatoriska parametrar, felaktiga datatyper, utgångna engångskoder, icke tillåtna origins eller en post som inte finns i förväg. Applikationen bör hantera sådana fall separat och logga det felmeddelande som endpointen returnerar, utan att skriva med hemligt innehåll. En lyckad begäran bekräftar endast detta bearbetningssteg, inte automatiskt en därpå följande e-post-, betalnings- eller SSO-framgång. Detta är direkt relevant för ”POST /api/public/consultation”. Den tekniska granskningen av denna sida ska bindande stödja sig på registret under `app/frontend/src/content/api-reference/` och tillhörande backend-routes. Anteckningar om live-test får bara påstå det som faktiskt har prövats. Ett negativt test eller en kodanalogi är inget fullständigt framgångsbevis. För POST /api/public/consultation — API-referens måste man därför tydligt skilja mellan dokumenterad struktur, automatiserat test och säkert observerat live-beteende.
Autentisering & säkerhet
Ingen autentisering krävs
Idempotent: Nej
Parametrar
name(body, string, obligatorisk)— 2–120 teckenemail(body, string, obligatorisk)— Giltig e-postadresscompany(body, string)message(body, string)phone(body, string)consentGiven(body, boolean, obligatorisk)— Måste vara trueExempel på request
{"name":"Max Mustermann","email":"max@example.com","company":"Musterfirma","message":"Ärende","consentGiven":true}Exempel på response
{"ok":true,"message":"Din förfrågan om rådgivning har skickats. Vi återkommer snart till dig."}Felkoder
400 VALIDATION_ERROR — Obligatoriskt fält saknas/är ogiltigt eller samtycke saknas.Bevis från livetest
Framgång (200) och negativt fall (400) verifierade live.