Kunci API

Kunci API memberi integrasi eksternal akses programatik ke data ruang kerja Anda tanpa menggunakan login anggota. Hanya admin. Setiap kunci membawa label yang dapat dibaca admin (untuk apa kunci itu) dan melacak tanggal pembuatan + timestamp terakhir dipakai sehingga Anda dapat mengenali kunci yang sudah usang.

Membuat kunci

1. Klik Buat kunci di bagian atas halaman.
2. Masukkan label deskriptif — untuk apa kunci ini? Contoh: "Integrasi Zapier", "Alat pelaporan internal", "Aplikasi seluler".

3. Klik Buat. Kunci ditampilkan satu kali — segera salin. Anda tidak akan melihatnya lagi setelah banner ditutup.
4. Tempel kunci ke integrasi Anda. Zellbox menerimanya sebagai Authorization: Bearer <key> pada setiap endpoint yang menerima autentikasi JWT.

Perlakukan kunci seperti kata sandi. Siapa pun yang memiliki kunci memiliki akses data yang sama dengan admin ruang kerja. Segera rotasi jika kunci bocor.

Merotasi kunci

Tidak ada rotasi di tempat. Untuk merotasi:

1. Buat kunci baru dengan tujuan yang sama.
2. Perbarui integrasi Anda dengan kunci baru.
3. Setelah Anda mengonfirmasi integrasi berfungsi, hapus kunci lama dari daftar.

Menghapus kunci

1. Temukan kunci di daftar.
2. Klik Hapus pada barisnya.
3. Konfirmasi di dialog. Kunci dicabut seketika — semua permintaan yang sedang berjalan yang menggunakannya akan mulai gagal dengan 401 pada panggilan berikutnya.