POST/api/public/contact

Borang kenalan awam laman web Zentor. Buat permintaan di dalam sistem utama dalaman.

`POST /api/public/contact` memproses borang hubungi awam laman web Zentor dan menyimpan permintaan dalam sistem lead dalaman. Titik akhir ini tidak memerlukan pengesahan papan pemuka dan tidak idempoten. Setiap penghantaran yang berjaya boleh menghasilkan lead baharu. Oleh itu, frontend perlu melumpuhkan butang hantar selepas klik pertama dan tidak mencetuskan sebarang percubaan semula automatik. Antara medan wajib yang disahkan ialah `name`, `email` dan `message`. Nama mesti antara 2 hingga 120 aksara panjangnya, alamat e-mel mesti mempunyai format yang sah, dan mesej mesti memenuhi peraturan pengesahan di pihak pelayan. Medan tambahan hanya boleh dihantar jika ia benar-benar ditetapkan dalam skema sebenar. Nilai yang tidak diketahui tidak sepatutnya digunakan untuk mengawal sifat dalaman lead. Borang yang betul menyemak medan wajib sudah pun di pelayar, tetapi tidak bergantung semata-mata pada semakan ini. Pelayan tetap menjadi penentu. Sekiranya berlaku ralat pengesahan, antara muka perlu menandakan medan yang terlibat dan mengekalkan kandungan yang telah dimasukkan. Mesej kejayaan generik hanya boleh muncul selepas respons positif daripada pelayan. Borang hubungi bukan saluran yang selamat untuk kata laluan, kunci API, token widget, data pembayaran atau rekod pelanggan yang lengkap. Pengguna perlu menyatakan kes penggunaan, produk yang terlibat dan alamat e-mel perniagaan yang boleh dihubungi. Sekiranya berlaku masalah teknikal, nama penyewa, masa kejadian, fungsi yang terjejas dan langkah yang boleh diulang membantu, tanpa menghantar kandungan peribadi yang tidak perlu. Aliran yang realistik: Pelawat mengisi nama, e-mel dan mesej, mengesahkan notis privasi laman jika perlu, dan menghantar borang. Pelayan mengesahkan data, mencipta lead dan memberikan respons kejayaan. Sekiranya e-mel tidak sah atau nama terlalu pendek, lead lengkap tidak akan dicipta. Titik akhir ini tidak mencipta penyewa, tidak menempah pakej dan tidak menggantikan konfigurasi produk yang berstruktur atau proses perundingan. Untuk perlindungan daripada spam dan permintaan bersiri automatik, klien perlu menghormati ralat di pihak pelayan dan tidak memulakan gelung tanpa henti dengan serta-merta. Respons yang berjaya hanya boleh mengosongkan medan input selepas pelayan mengesahkan penerimaan. Sekiranya respons tidak diterima, pengguna boleh menyimpan kandungan dan menghantarnya semula secara terkawal kemudian. Untuk penyusunan dalaman, mesej perlu mengandungi sebab sebenar, tanpa frasa pemasaran atau lampiran sulit. Subjek yang jelas dan penerangan masalah yang tepat mengurangkan pertanyaan susulan. Namun, API itu sendiri tidak menetapkan sebarang keutamaan yang dijamin dan tidak mengesahkan sebarang tempoh pemprosesan yang tetap.

{"name":"Max Mustermann","email":"max@example.com","message":"Ihre Nachricht (mind. 10 Zeichen).","consentGiven":true}

{"ok":true,"message":"Ihre Anfrage wurde übermittelt."}