POST/api/public/consultation

Ëffentlech Consultatiounsanfrageform vum Zentor-Websäit.

D'Säit „POST /api/public/consultation — API-Referenz“ behandelt de Funktiounsberäich, deen an der URL genannt gëtt. Den existente Inhalt gëtt ëm den tatsächleche Oflaf, d'Viraussetzungen an déi bekannt Grenze ergänzt. De Formulaire-Baukaste ënnerstëtzt fräi konfiguréierbar Formulairë mat Trigger-Schlësselwierder, Feldtypen a Flichtfeld-Kennzeechnung. D'Funktioun ass E2E-getest. D'Dokumentatioun zu `POST /api/public/consultation` muss als technesch Beschreiwung vun dësem konkreten Endpunkt gelies ginn. Entscheedend sinn Method, Wee, Authentifizéierung, Flichtfelder, méiglech Feeler an d'Fro, ob en erneite Opruff dee selwechten Effekt auslöst. Déi virleiend URL https://zentor-app.de/hilfe/api-referenz/formulare/forms.consultation dierf dofir keng allgemeng Reklammausoen enthalen, mä nëmmen nozvollzéibar Integratiounsschrëtt a beluechten Äntwertbeispiller. Fir en Opruff vun `/api/public/consultation` gëtt d'Ufro entspriechend der Registry opgebaut. Ëffentlech Routen brauchen keen allgemengen Entwéckler-API-Schlëssel, well Zentor keen esou Schlësselsystem ubitt. Geschützte Widget-Routen benotzen dogéint den eemol ugewisenen Embed-Token an eng Origin-Préiwung. Den HTTP-Status an den JSON-Inhalt mussen zesumme ausgewäert ginn; e `ok`-Feld eleng ersetzt keng Feelerbehandlung. Beim Test vun `POST /api/public/consultation` sinn anonymiséiert Wäerter ze benotzen. Reell Kundendaten, produktiv UUIDs, Sitzungs-Tokens a konkret Zäitstempele gehéieren net an ëffentlech Beispiller. De bekannte plattformwäite Grenzwäert läit bei 2.000 Ufroen bannent 15 Minutten; e ofweichend Eenzellimit ass net beluecht. Net idempotent POST-Opruff dierfen no engem onkloren Netzwierkofbroch net blann widderholl ginn. Typesch Integratiounsfeeler fir dës Rout entstinn duerch feelend Flichtparameter, falsch Datentypen, ofgelafen Eemolcoden, net erlaabt Origins oder e virdrun net virhannenen Datesaz. D'Applikatioun sollt esou Fäll getrennt behandelen an déi vum Endpunkt zréckgeliwwert Feelermeldung protokolléieren, ouni geheim Inhalter matzeschreiwen. En erfollegräiche Request bestätegt nëmmen dëse Verschaffungsschrëtt, net automatesch en dozou ugelagerten E-Mail-, Bezuel- oder SSO-Erfolleg. Dëst ass fir „POST /api/public/consultation“ direkt relevant. D'technesch Iwwerpréiwung vun dëser Säit soll verbindlech sech op d'Registry ënner `app/frontend/src/content/api-reference/` an déi zougehéiereg Backend-Routen stëtzen. Live-Test-Vermierker dierfen nëmmen dat behaapten, wat tatsächlech gepréift gouf. En Negativtest oder eng Code-Analogie ass kee vollstännege Erfollegsnowäis. Fir POST /api/public/consultation — API-Referenz ass dofir kloer tëscht dokumentéierter Struktur, automatiséiertem Test a sécher beobachtetem Live-Verhalen ze ënnerscheeden.

Auth & Absicherung

Keine Authentifizierung erforderlich

Idempotent: Nein

Parameter

name(body, string, erforderlich)2120 Zeechen
email(body, string, erforderlich)Gëlteg E-Mail Adress
company(body, string)
message(body, string)
phone(body, string)
consentGiven(body, boolean, erforderlich)Muss richteg sinn

Beispiel-Request

{"name":"Max Mustermann","email":"max@example.com","company":"Musterfirma","message":"Anliegen","consentGiven":true}

Beispiel-Response

{"ok":true,"message":"Ihre Beratungsanfrage wurde übermittelt. Wir melden uns in Kürze bei Ihnen."}

Fehlercodes

400 VALIDATION_ERRORD'Formatioun ass net/net gülteg oder d'Konsentatioun ass net.

Live-Test-Nachweis

Erfolleg (200) an Negativ (400) live verifizéiert.

Ëffentlech Formulairen