POST/api/public/consultation

Formulir permintaan konsultasi publik dari situs web Zentor.

Halaman “POST /api/public/consultation — Referensi API” membahas area fungsional yang ditunjuk dalam URL. Konten yang ada dilengkapi dengan alur kerja aktual, prasyarat, dan batasan yang diketahui. Pembangun formulir mendukung formulir yang dapat dikonfigurasi secara bebas dengan kata kunci pemicu, jenis bidang, dan penandaan bidang wajib. Fungsi ini telah diuji secara end-to-end (E2E). Dokumentasi untuk `POST /api/public/consultation` harus dibaca sebagai deskripsi teknis dari titik akhir ini. Yang penting adalah metode, jalur, autentikasi, bidang wajib, kemungkinan kesalahan, dan pertanyaan apakah panggilan ulang memicu efek yang sama. URL yang tercantum https://zentor-app.de/hilfe/api-referenz/formulare/forms.consultation oleh karena itu tidak boleh memuat pernyataan pemasaran umum, melainkan hanya langkah integrasi yang dapat direproduksi dan contoh respons yang terverifikasi. Untuk panggilan ke `/api/public/consultation`, permintaan harus disusun sesuai dengan Registry. Rute publik tidak memerlukan kunci API pengembang umum karena Zentor tidak menawarkan sistem kunci semacam itu. Sebaliknya, rute widget yang dilindungi menggunakan Embed-Token yang ditampilkan sekali dan pemeriksaan Origin. Status HTTP dan konten JSON harus dievaluasi bersama; bidang `ok` saja tidak menggantikan penanganan kesalahan. Saat menguji `POST /api/public/consultation`, nilai yang dianonimkan harus digunakan. Data pelanggan nyata, UUID produksi, token sesi, dan stempel waktu konkret tidak termasuk dalam contoh publik. Batas platform yang diketahui adalah 2.000 permintaan dalam 15 menit; batas tunggal yang menyimpang tidak terbukti. Panggilan POST yang tidak idempoten tidak boleh diulang secara membabi buta setelah pemutusan jaringan yang tidak jelas. Kesalahan integrasi tipikal untuk rute ini muncul karena parameter wajib yang hilang, tipe data yang salah, kode sekali pakai yang kedaluwarsa, Origin yang tidak diizinkan, atau catatan data yang belum ada sebelumnya. Aplikasi harus menangani kasus-kasus tersebut secara terpisah dan mencatat pesan kesalahan yang dikembalikan oleh titik akhir, tanpa menyertakan konten rahasia. Permintaan yang berhasil hanya mengonfirmasi langkah pemrosesan ini, bukan secara otomatis keberhasilan pengiriman email, pembayaran, atau SSO di kemudian hari. Hal ini sangat relevan untuk “POST /api/public/consultation”. Pemeriksaan teknis halaman ini harus secara tegas berfokus pada Registry di `app/frontend/src/content/api-reference/` dan rute backend terkait. Catatan uji langsung hanya boleh mengklaim apa yang benar-benar telah diuji. Uji negatif atau analogi kode bukan merupakan instruksi keberhasilan yang lengkap. Untuk POST /api/public/consultation — Referensi API, oleh karena itu harus dibedakan dengan jelas antara struktur yang didokumentasikan, pengujian otomatis, dan perilaku langsung yang diamati dengan aman.

Auth & Absicherung

Keine Authentifizierung erforderlich

Idempotent: Nein

Parameter

name(body, string, erforderlich)2–120 karakter
email(body, string, erforderlich)Alamat email yang valid
company(body, string)
message(body, string)
phone(body, string)
consentGiven(body, boolean, erforderlich)Harus benar

Beispiel-Request

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

Beispiel-Response

{"ok":true,"message":"Permintaan konsultasi Anda telah dikirim. Kami akan segera menghubungi Anda."}

Fehlercodes

400 VALIDATION_ERRORKolom wajib tidak ada/tidak valid atau persetujuan tidak ada.

Live-Test-Nachweis

Berhasil (200) dan kasus negatif (400) telah diverifikasi secara langsung.

Formulir Publik