POST/api/public/consultation

Zentor-verkkosivuston julkinen yhteydenottolomake neuvontakyselyitä varten.

Sivu "POST /api/public/consultation — API-viittaus" käsittelee URL:ssä määriteltyä toiminnallisuuden aluetta. Olemassa oleva sisältö täydennetään todellisella prosessin kululla, edellytyksillä ja tunnetuilla rajoituksilla. Lomakkeiden rakennustyökalu tukee vapaasti konfiguroitavia lomakkeita, joissa on trigger-avainsanoja, kenttätyyppejä ja pakollisia kenttiä. Toiminnallisuus on testattu päästä päähän. `POST /api/public/consultation`:n dokumentaatio on luettava teknisenä kuvauksena tästä tietystä päätepisteestä. Tärkeää on menetelmä, polku, todennus, pakolliset kentät, mahdolliset virheet ja se, aiheuttaako toistuva kutsu saman vaikutuksen. Tämä URL-osoite https://zentor-app.de/hilfe/api-referenz/formulare/forms.consultation ei saa sisältää yleisiä mainoslauseita, vaan ainoastaan välittömästi toteutettavia integraatiovaiheita ja todistettuja vastausesimerkkejä. `/api/public/consultation`:n kutsu tehdään rakenteen mukaisesti, joka on määritelty rekisterissä. Julkiset reitit eivät vaadi yleistä kehittäjän API-avainta, koska Zentor ei tarjoa tällaista avainjärjestelmää. Suojatut widget-reitit käyttävät sen sijaan ainoastaan kerran näytettyä upotus-tokenia ja alkuperätarkistusta. HTTP-tila ja JSON-sisältö on arvioitava yhdessä; yksittäinen `ok`-kenttä ei korvaa virheenkäsittelyä. `POST /api/public/consultation`:n testaamisessa on käytettävä anonymisoituja arvoja. Todellisia asiakastietoja, tuotantoympäristön UUID-tunnisteita, istunto-tokeneita ja konkreettisia aikaleimoja ei saa sisällyttää julkisiin esimerkkeihin. Tunnettu alustatasoinen rajoitus on 2 000 pyyntöä 15 minuutin sisällä; erillistä yksittäistä rajoitusta ei ole todistettu. Ei-idempotentteja POST-pyyntöjä ei saa toistaa sokeasti verkkoyhteyden katkeamisen jälkeen. Tyypillisiä integraatiovirheitä tälle reitille aiheutuvat puuttuvat pakolliset parametrit, virheelliset tietotyypit, vanhentuneet kertakäyttökoodit, sallimattomat alkuperät tai olemassa olematon tietojoukko. Sovelluksen tulisi käsitellä tällaisia tapauksia erikseen ja kirjata päätepisteen palauttama virheilmoitus ilman, että salaisia tietoja tallennetaan. Onnistunut pyyntö vahvistaa vain tämän käsittelyvaiheen, ei automaattisesti sähköpostin, maksun tai SSO-toiminnon onnistumisen. Tämä on suoraan relevanttia "POST /api/public/consultation" -toiminnolle. Tämän sivun tekninen tarkastus on sitovasti perustuttava rekisteriin `app/frontend/src/content/api-reference/` ja siihen liittyviin taustajärjestelmien reitteihin. Live-testausmerkinnöissä saa olla vain sellaisia väitteitä, jotka on todistettu. Negatiivinen testi tai koodin analogia ei ole täydellinen onnistumisen osoitus. Siksi "POST /api/public/consultation — API-viittaus" -sivulla on selvästi erotettava dokumentoitu rakenne, automatisoitu testaus ja varmasti havaittu käytöksessä oleva toiminta.

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

{"ok":true,"message":"Konsultointipyyntösi on lähetetty. Otamme sinuun pian yhteyttä."}