POST/api/public/consultation

Pormularyo ng kahilingan para sa konsultasyon na pampubliko mula sa website ng Zentor.

Ang pahina na "POST /api/public/consultation — API Reference" ay tumutukoy sa partikular na functional area na nakasaad sa URL. Ang kasalukuyang nilalaman ay dinagdagan ng aktwal na proseso, mga kinakailangan, at mga kilalang limitasyon. Sinusuportahan ng form builder ang mga form na maaaring i-configure nang malaya, gamit ang mga trigger keywords, mga uri ng field, at mga mandatoryong field. Ang function na ito ay sinubok nang end-to-end. Ang dokumentasyon para sa `POST /api/public/consultation` ay dapat basahin bilang isang teknikal na paglalarawan ng partikular na endpoint na ito. Mahalaga ang pamamaraan, path, authentication, mga mandatoryong field, posibleng mga error, at kung ang pag-uulit ng tawag ay magdudulot ng parehong resulta. Samakatuwid, ang URL na ito na https://zentor-app.de/hilfe/api-referenz/formulare/forms.consultation ay hindi dapat maglaman ng mga pangkalahatang pahayag sa advertising, kundi mga hakbang sa integrasyon na maaaring gawin kaagad at mga halimbawa ng tugon na napatunayan. Para sa isang tawag sa `/api/public/consultation`, ang kahilingan ay binuo alinsunod sa registry. Ang mga pampublikong ruta ay hindi nangangailangan ng pangkalahatang developer API key dahil ang Zentor ay hindi nag-aalok ng ganitong uri ng sistema ng key. Sa kabilang banda, ang mga protektadong widget route ay gumagamit ng isang embed token na ipinapakita nang isang beses at isang pag-verify ng origin. Ang HTTP status at ang JSON content ay dapat suriin nang magkasama; ang isang field na `ok` lamang ay hindi pumapalit sa paghawak ng error. Kapag sinusubok ang `POST /api/public/consultation`, dapat gamitin ang mga anonymized na halaga. Ang mga tunay na data ng customer, produktibong UUID, mga session token, at mga tiyak na timestamp ay hindi dapat isama sa mga pampublikong halimbawa. Ang kilalang limitasyon sa buong platform ay 2,000 na kahilingan sa loob ng 15 minuto; walang napatunayang indibidwal na limitasyon. Ang mga hindi idempotent na POST request ay hindi dapat ulitin nang basta-basta pagkatapos ng hindi malinaw na pagkabigo ng network. Ang mga karaniwang pagkakamali sa integrasyon para sa rutang ito ay maaaring sanhi ng mga nawawalang mandatoryong parameter, maling mga uri ng data, mga expired na one-time code, mga hindi pinahihintulutang origin, o isang dataset na hindi pa umiiral. Ang aplikasyon ay dapat na humawak ng mga kasong ito nang hiwalay at i-log ang mensahe ng error na ibinalik ng endpoint, nang hindi isinasama ang mga sensitibong nilalaman. Ang isang matagumpay na kahilingan ay nagkukumpirma lamang sa hakbang na ito ng pagproseso, hindi awtomatikong isang matagumpay na pagpapadala ng email, pagbabayad, o SSO. Ito ay may direktang kaugnayan sa "POST /api/public/consultation". Ang teknikal na pagsusuri ng pahinang ito ay dapat na batay sa registry sa `app/frontend/src/content/api-reference/` at mga kaugnay na backend route. Ang mga live na tala ng pagsubok ay dapat lamang magpahayag ng kung ano ang talagang nasuri. Ang isang negatibong pagsubok o isang pagkakapareho ng code ay hindi kumpleto. Samakatuwid, para sa POST /api/public/consultation — API Reference, dapat na malinaw na paghiwalayin ang dokumentadong istraktura, automated na pagsubok, at ang aktwal na obserbasyong pag-uugali.

Auth & Absicherung

Keine Authentifizierung erforderlich

Idempotent: Nein

Parameter

name(body, string, erforderlich)2 hanggang 120 karakter.
email(body, string, erforderlich)Validong email address.
company(body, string)
message(body, string)
phone(body, string)
consentGiven(body, boolean, erforderlich)Dapat ito ay "true".

Beispiel-Request

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

Beispiel-Response

{"ok":true,"message":"Ang iyong kahilingan para sa konsultasyon ay natanggap na. Makikipag-ugnayan kami sa iyo sa lalong madaling panahon."}

Fehlercodes

400 VALIDATION_ERRORKinakailangang punan ang field na ito/hindi ito wasto, o kulang ang pahintulot.

Live-Test-Nachweis

Matagumpay (200) at negatibong kaso (400) na na-verify nang live.

Mga pampublikong form.