POST/api/public/consultation

Javni obrazac za upit za savjet s web stranice Zentor.

Stranica „POST /api/public/consultation — API referenca“ obuhvaća funkcionalnu oblast navedenu u URL-u. Postojeći sadržaj bit će dopunjen stvarnim postupkom, preduvjetima i poznatim ograničenjima. Alat za izradu obrazaca podržava obrasce koji se mogu slobodno konfigurirati, s ključnim riječima za pokretače, tipovima polja i obilježavanjem obaveznih polja. Funkcija je testirana od kraja do kraja. Dokumentacija za `POST /api/public/consultation` mora se čitati kao tehnički opis ovog konkretnog krajnjeg točke. Ključno je razumjeti metodu, putanju, autentifikaciju, obavezna polja, moguće pogreške i pitanje je li ponovni poziv istog kraja točke isti učinak. Stoga, URL https://zentor-app.de/hilfe/api-referenz/formulare/forms.consultation ne smije sadržavati općenite reklamne izjave, već samo korake integracije koji se mogu odmah provesti i dokazane primjere odgovora. Za poziv `/api/public/consultation`, zahtjev se konstruira prema registru. Javne rute ne zahtijevaju opći API ključ za razvoj, jer Zentor ne nudi takav sustav ključeva. Zaštićene widget rute, s druge strane, koriste jedinstveni embed token koji se prikazuje i provjeru izvora. HTTP status i JSON sadržaj moraju se zajedno procijeniti; samo `ok` polje ne zamjenjuje obradu pogrešaka. Prilikom testiranja `POST /api/public/consultation`, potrebno je koristiti anonimizirane vrijednosti. Stvarni podatci o korisnicima, produktivne UUID-ove, tokeni sesije i konkretni vremenski žigovi ne smiju se nalaziti u javnim primjerima. Poznata globalna granica iznosi 2000 zahtjeva u roku od 15 minuta; pojedinačna granica koja se razlikuje nije dokazana. Neidempotentni POST pozivi ne smiju se slijepo ponavljati nakon nejasnog prekida mreže. Tipične integracijske pogreške za ovu rutu nastaju zbog nedostajućih obaveznih parametara, pogrešnih tipova podataka, isteklinih jednokratnih kodova, nedozvojenih izvora ili nepostojećeg skupa podataka. Aplikacija bi trebala zasebno obraditi takve slučajeve i zabilježiti poruku o pogrešci koju vraća krajnja točka, bez zapisivanja tajnih sadržaja. Uspješan zahtjev potvrđuje samo ovaj korak obrade, a ne automatski uspjeh e-pošte, plaćanja ili SSO-a. Ovo je izravno relevantno za „POST /api/public/consultation“. Tehnička provjera ove stranice mora se obavezno temeljiti na registru pod `app/frontend/src/content/api-reference/` i povezanim backend rutama. Bilješke o testiranju u stvarnom vremenu mogu tvrditi samo ono što je stvarno testirano. Negativni test ili analiza koda nisu potpuni uvjeti za uspjeh. Stoga, za POST /api/public/consultation — API referenca, jasno je potrebno razlikovati dokumentiranu strukturu, automatizirano testiranje i sigurno opaženo ponašanje u stvarnom svijetu.

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

{"ok":true,"message":"Vaš zahtjev za savjet je poslan. Uskoro ćemo vas kontaktirati."}