Referensi API

Referensi ini hanya menjelaskan endpoint JSON nyata yang dapat digunakan secara publik -- metode, path, jenis autentikasi, parameter wajib, contoh request dan response, serta kode error yang terdokumentasi untuk setiap endpoint. Zentor tidak memiliki sistem kunci API umum untuk developer; tergantung rutenya, akses dilakukan tanpa autentikasi atau melalui token embed widget dengan pemeriksaan origin. Rute dashboard internal dan endpoint Master Admin sengaja tidak termasuk dalam referensi publik ini, karena hanya dapat diakses melalui sesi login biasa.

Setiap entri endpoint memuat catatan uji langsung yang mengungkapkan apakah informasi tersebut berasal dari skema registry, pengujian otomatis, atau pengamatan langsung yang sebenarnya -- sekadar kemiripan dengan jalur kode yang berfungsi tidak dianggap sebagai bukti lengkap. Selain itu, panggilan yang berhasil secara teknis selalu hanya mengonfirmasi pemrosesan request itu sendiri, bukan secara otomatis proses lanjutan seperti pengiriman email, penyelesaian pembayaran, atau login SSO yang telah selesai.

Pengamanan bergantung pada masing-masing grup. Endpoint publik untuk hukum, pemasaran, dan formulir tidak memerlukan sesi dashboard. Sebaliknya, widget chat menggunakan header `X-Widget-Token` dan allowlist origin. Login dashboard menghasilkan JWT sesi dengan masa berlaku dua belas jam dan refresh token yang berlaku selama tujuh hari. Endpoint SSO bekerja dengan kode sekali pakai dan alur callback tersendiri.

Bacalah setiap halaman endpoint sebagai kontrak tersendiri. Yang menentukan adalah metode HTTP, path, parameter wajib, tipe data, body request, struktur response, kode error, dan idempotensi. Contoh menunjukkan format yang mungkin, tetapi tidak menggantikan pemeriksaan response yang sebenarnya. Status konfigurasi, validasi, izin, dan penyedia eksternal dapat mengubah hasilnya.

Rate limit seluruh platform yang telah dikonfirmasi adalah 2.000 request dalam 15 menit. Batas terpisah per endpoint tidak terdokumentasi secara menyeluruh. Karena itu, klien sebaiknya tidak menggunakan loop polling yang terlalu rapat tanpa perlu. Pada operasi yang tidak idempoten, percobaan ulang otomatis dapat menghasilkan data atau pesan ganda.

Nilai sensitif tidak boleh masuk ke log. Ini mencakup kata sandi, token reset, kode verifikasi, token widget, ID sesi, dan contoh data yang berisi data pribadi nyata. Gunakan nilai yang dianonimkan dalam dokumentasi dan pengujian. Catatan uji langsung harus mencerminkan bukti yang sebenarnya secara akurat.