Koneksi API Notion

Kunjungi developer hub kami untuk dokumentasi, sumber daya, dan alat manajemen koneksi.

1. Di sidebar kiri Anda, buka Settings lalu tab Koneksi.

2. Hanya pemilik ruang kerja yang dapat mengakses tab Koneksi dan membuat integrasi. Jika Anda bukan admin, silakan hubungi admin ruang kerja Anda atau gunakan ruang kerja yang berbeda.

3. Klik tautan Kembangkan koneksi Anda sendiri di bagian bawah.

4. Koneksi saya akan terbuka di browser default Anda. Klik tombol + Koneksi baru.

5. Berikan Name untuk koneksi Anda. Secara opsional, Anda juga dapat mengunggah gambar untuk digunakan sebagai Logo.

6. Gunakan menu drop-down untuk menentukan ruang kerja terkait mana yang ingin Anda gunakan dengan koneksi ini.

   

   Catatan: Pastikan Anda masuk ke Notion pada sesi web Anda dengan akun yang sama dengan yang Anda gunakan di desktop. Jika tidak, Anda tidak akan melihat akun dan ruang kerja yang benar!

   

7. Koneksi internal Anda telah berhasil ditambahkan! Anda sekarang dapat melihatnya di ruang kerja Anda, di menu Settings → Koneksi.

8. Klik ••• di samping koneksi internal untuk mengambil token koneksi internal. Anda akan memerlukan token ini untuk otomatisasi atau alur kerja berbasis API apa pun yang dibuat tim Anda, atau untuk menautkan ruang kerja Anda ke beberapa platform mitra.

Semua koneksi yang baru ditambahkan pada awalnya bersifat internal. Jika Anda seorang pengembang yang sedang mengerjakan koneksi publik, gunakan petunjuk di atas terlebih dahulu untuk membuat koneksi internal.

Kemudian, ikuti petunjuk di developer guide kami untuk mengubahnya menjadi koneksi publik.

Selama proses penyiapan aplikasi, pengembang akan dapat memilih tingkat akses yang diperlukan dari pengguna.

• Kemampuan konten:

  • Membaca konten saja

  • Menulis konten saja

  • Sisipkan konten

• Kemampuan pengguna

  • Tidak ada informasi pengguna

  • Membaca info pengguna (tidak termasuk alamat email pengguna)

  • Membaca info pengguna (termasuk email)

Saat pengguna menginstal koneksi, tingkat akses ini akan ditampilkan. Ini juga akan muncul di menu Share pada halaman yang telah ditambahkan koneksinya. Pelajari lebih lanjut tentang menginstal koneksi di ruang kerja →

Webhook koneksi memungkinkan koneksi untuk memantau dan merespons perubahan di ruang kerja Notion secara real-time.

Saat perubahan terjadi di halaman atau database yang dibagikan dengan koneksi Anda, Notion secara otomatis mengirimkan pemberitahuan ke titik akhir webhook Anda, yang memungkinkan koneksi Anda untuk memperbarui alat lain, menjalankan tugas otomatis, atau menampilkan perubahan terbaru secara instan.

Untuk Instruksi, silakan kunjungi dokumentasi pengembang kami.

Tindakan webhook dan webhook koneksi memiliki beberapa kesamaan—keduanya memiliki pemicu dan dapat mengirim Acara ke layanan pihak ketiga. Namun, webhook koneksi menawarkan kemampuan yang lebih luas:

• Webhook koneksi dapat memantau aktivitas di beberapa ruang kerja.

• Webhook koneksi dapat menangani jumlah tindakan yang tidak terbatas.

Sebaliknya, tindakan webhook dirancang untuk kasus penggunaan yang lebih sederhana dan dikonfigurasi melalui otomatisasi basis data dengan serangkaian pemicu yang terbatas.