POST/api/public/consultation

Zentor 網站的公開諮詢申請表單。

「POST /api/public/consultation — API 參考」頁面涵蓋 URL 所指的功能範疇。現有內容補充了實際流程、先決條件及已知限制。表單建構器支援可自由設定的表單,包括觸發關鍵詞、欄位類型及必填欄位標記。此功能已通過 E2E 測試。 `POST /api/public/consultation` 的文件必須當作此具體端點的技術說明來閱讀。關鍵在於方法、路徑、身份驗證、必填欄位、可能出現的錯誤,以及再次呼叫會否觸發相同效果。因此,本 URL https://zentor-app.de/hilfe/api-referenz/formulare/forms.consultation 不得包含一般宣傳語句,只可包含可追溯的整合步驟及有根據的回應範例。 呼叫 `/api/public/consultation` 時,請求按註冊表組成。公開路由不需要一般開發者 API 金鑰,因為 Zentor 沒有提供這類金鑰系統。相反,受保護的小工具路由使用只顯示一次的嵌入 Token 及 Origin 檢查。HTTP 狀態與 JSON 內容必須一併評估;單靠 `ok` 欄位不能取代錯誤處理。 測試 `POST /api/public/consultation` 時應使用匿名化數值。真實客戶資料、正式環境 UUID、工作階段 Token 及具體時間戳不應出現在公開範例中。已知的全平台限制為 15 分鐘內 2.000 次請求;並無證據顯示有不同的個別限制。非冪等的 POST 呼叫在網絡中斷情況不明時,不得盲目重試。 此路由常見的整合錯誤來自缺少必填參數、錯誤數據類型、已過期的一次性代碼、不獲允許的 Origin,或事前不存在的數據記錄。應用程式應分開處理這些情況,並記錄端點返回的錯誤訊息,但不可記錄機密內容。成功的請求只確認此處理步驟,並不自動代表後續的電郵、付款或 SSO 步驟成功。這點與「POST /api/public/consultation」直接相關。 此頁面的技術審查必須以 `app/frontend/src/content/api-reference/` 的註冊表及相關後端路由為依據。實時測試註記只可聲稱實際測試過的內容。負面測試或程式碼類比並非完整的成功證明。因此,就「POST /api/public/consultation — API 參考」而言,必須清楚區分已記錄的結構、自動化測試及確實觀察到的實時行為。

身份驗證同安全保障

唔需要身份驗證

冪等: 唔係

參數

name(body, string,必填)— 2–120 個字元
email(body, string,必填)— 有效電郵地址
company(body, string)
message(body, string)
phone(body, string)
consentGiven(body, boolean,必填)— 必須為 true

請求範例

{"name":"Max Mustermann","email":"max@example.com","company":"Musterfirma","message":"關注事項","consentGiven":true}

回應範例

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

錯誤代碼

400 VALIDATION_ERROR — 缺少必填欄位或無效,或欠缺同意。

即時測試證明

成功 (200) 同負例 (400) 已即時驗證。

← 公開表單