POST/api/public/consultation

Javni obrazec za zahtevo za svetovanje na spletni strani Zentor.

Stran »POST /api/public/consultation — API-referenca« obravnava funkcionalno območje, ki ga označuje URL. Obstoječa vsebina je dopolnjena z dejanskim potekom, predpogoji in znanimi omejitvami. Graditelj obrazcev podpira prosto nastavljive obrazce s ključnimi besedami sprožilca, tipi polj in oznako obveznih polj. Funkcija je preizkušena od konca do konca (E2E). Dokumentacijo za `POST /api/public/consultation` je treba brati kot tehnični opis te konkretne končne točke. Odločilni so metoda, pot, overjanje, obvezna polja, možne napake in vprašanje, ali ponovni klic sproži enak učinek. Ta URL https://zentor-app.de/hilfe/api-referenz/formulare/forms.consultation zato ne sme vsebovati splošnih reklamnih izjav, temveč le razumljive korake integracije in dokazane primere odgovorov. Za klic `/api/public/consultation` se zahteva sestavi v skladu z registrom. Javne poti ne potrebujejo splošnega API ključa za razvijalce, ker Zentor takega sistema ključev ne ponuja. Zaščitene poti gradnika pa namesto tega uporabljajo enkrat prikazani Embed-Token in preverjanje izvora (Origin). Status HTTP in vsebino JSON je treba ovrednotiti skupaj; samo polje `ok` ne nadomešča obravnave napak. Pri preizkusu `POST /api/public/consultation` je treba uporabiti anonimizirane vrednosti. Pravi podatki strank, produktivni UUID-ji, sejni tokeni in konkretni časovni žigi ne sodijo v javne primere. Znana platformna omejitev je 2.000 zahtev v 15 minutah; drugačna posamična omejitev ni dokazana. Neidempotentnih klicev POST po nejasni prekinitvi omrežja ne smemo slepo ponavljati. Tipične napake pri integraciji za to pot nastanejo zaradi manjkajočih obveznih parametrov, napačnih podatkovnih tipov, poteklih enkratnih kod, nedovoljenih izvorov (Origins) ali zapisa, ki predhodno ne obstaja. Aplikacija naj take primere obravnava ločeno in beleži sporočilo o napaki, ki ga vrne končna točka, brez beleženja skrivnih vsebin. Uspešna zahteva potrjuje le ta korak obdelave, ne pa samodejno uspeha naknadnega pošiljanja e-pošte, plačila ali SSO. To je za »POST /api/public/consultation« neposredno pomembno. Tehnično preverjanje te strani se mora zavezujoče opirati na register v `app/frontend/src/content/api-reference/` in pripadajoče poti zaledja. Opombe o testih v živo smejo trditi le to, kar je bilo dejansko preverjeno. Negativni test ali analogija s kodo ni popoln dokaz uspeha. Pri POST /api/public/consultation — API-referenca je zato treba jasno razlikovati med dokumentirano strukturo, avtomatiziranim testom in zanesljivo opaženim obnašanjem v živo.

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

{"ok":true,"message":"Vaše svetovalno povpraševanje je bilo poslano. Kmalu se vam bomo oglasili."}