API admin untuk organisasi Enterprise

API admin Notion memungkinkan organisasi Anda menangani pekerjaan admin dengan kode. Ini mencakup tugas-tugas umum seperti memulai Ekspor ruang kerja, membuat dan merilis Reservasi hukum, memproses log keluar pengguna terkelola dari Notion, dan banyak lagi.

Anda dapat mengatur ini di pengaturan organisasi Anda. Anda membuat bot admin untuk organisasi Anda, lalu memberinya token dengan hanya akses yang diperlukannya.

• Organisasi Anda harus menggunakan Paket Perusahaan.

• Anda harus menjadi pemilik organisasi.

• Ini dibuat untuk tim admin, TI, keamanan, dan kepatuhan. Anggota dan tamu tidak akan merasakan perubahan apa pun dalam pekerjaan sehari-hari mereka.

1. Buka pengalih ruang kerja Anda dan pilih Kelola organisasi.

2. Buka Umum, lalu buka Kelola token API admin tingkat organisasi.

3. Pilih Buat koneksi.

4. Beri nama koneksi yang akan dikenali oleh tim Anda, seperti “Otomatisasi kepatuhan,” dan pilih hanya akses yang diperlukannya. Jika koneksi hanya memproses Ekspor, jangan berikan akses Reservasi hukum.

5. Pilih Buat token, lalu Salin token tersebut dan simpan di pengelola rahasia yang sudah digunakan oleh tim Anda.

Anda akan melihat koneksi baru tercantum di pengaturan organisasi Anda, beserta siapa yang membuatnya dan kapan. Anda dapat kembali dan Salin token tersebut kapan saja dari menu koneksi.

• Pilih rangkaian akses terkecil yang masih dapat menyelesaikan pekerjaan.

• Rotasi token sesuai jadwal yang ditetapkan oleh tim keamanan Anda.

• Hapus token segera jika dibagikan secara tidak sengaja atau orang yang memilikinya berganti peran. Skrip apa pun yang menggunakan token tersebut akan langsung berhenti berfungsi.

• Anda tidak dapat membatasi token admin ke alamat IP atau jaringan tertentu. Gunakan kontrol yang sudah Anda miliki, seperti menyimpan token di pengelola rahasia dan menjalankan panggilan dari sistem yang Anda percayai.

Tindakan yang dilakukan dengan token admin akan muncul di log audit Anda. Bot admin tercantum sebagai aktornya, sehingga Anda dapat membedakan pekerjaan otomatis dari pekerjaan manusia.

• Panggilan ditolak. Periksa apakah organisasi Anda menggunakan Paket Perusahaan.

• Anda mendapatkan kesalahan izin. Periksa apakah token memiliki akses ke tindakan yang Anda panggil. Token yang dicakup untuk Ekspor tidak dapat membuat Reservasi hukum.

• Panggilan keluar tidak melakukan apa pun. Periksa apakah akun tersebut adalah pengguna terkelola. Akun di luar domain terverifikasi Anda tidak tercakup.

Untuk format permintaan, parameter, dan contoh kode, lihat referensi API admin di dokumen pengembang.