Written with AI assistance from the source video. The video is the authority.
30:37Vercel
Log in to leave a comment
No posts yet
Notion memiliki antarmuka yang nyaman. Inilah alasan mengapa pengembang independen menggunakan Notion sebagai backend ketika mereka tidak punya waktu untuk membangun server dan database secara terpisah. Namun, jika struktur ini dipertahankan pada tingkat produksi, Anda akan segera menemui jalan buntu. Notion API memberlakukan batas tarif (rate limit) sebanyak 3 permintaan per detik untuk setiap token integrasi. Jika batas ini terlampaui, kesalahan 429 atau 529 akan muncul.
Masalah akan semakin membesar bahkan ketika data menumpuk sedikit saja. Jumlah maksimum data yang dapat diambil dalam satu waktu adalah 100 entri. Anda harus mengimplementasikan pem分页 (pagination) sendiri, dan logika server menjadi rumit karena harus mengurai struktur properti yang bersarang. Ukuran data atribut yang masuk ke dalam satu halaman dibatasi hingga 2,5 megabita. Jika Anda mengabaikan batasan ini dan meluncurkan layanan, layar akan berhenti merespons atau data akan hilang saat permintaan pengguna membludak.
Anda tidak bisa terus-menerus menunggu panggilan API eksternal setiap saat. Lapisan caching (caching layer) harus ditempatkan di depan. Data statis harus di-cache di Redis atau Cloudflare KV, dan diperbarui secara berkala oleh background worker agar 80 persen dari total panggilan API dapat diproses secara lokal. Kecepatan respons akan turun di bawah 200 milidetik.
Parser yang meratakan (flatten) properti kompleks Notion di backend Python juga diperlukan. Respons Notion bersarang secara mendalam berdasarkan tipe. Buat parser yang mengiterasi dictionary, memeriksa bidang tipe, menggabungkan teks menjadi string, dan mengekstrak hanya array ID untuk data relasional. Hanya melalui proses preprocessing inilah pengembang frontend dapat langsung menggunakan data tanpa logika parsing.
Bahkan jika baris diubah di Notion, jika Anda memanggil API segera setelah webhook diterima, data lama akan dikembalikan. Ini karena pengindeksan tertunda (delayed indexing). Hal ini menjadi penyebab paket hilang atau data menjadi kacau.
Untuk mengatasi masalah ini, diperlukan rutinitas pemulihan latar belakang yang berkala. Bandingkan cache lokal dan timestamp dengan memanfaatkan filter waktu modifikasi Notion API. Jika terjadi kesalahan, tunggu dengan algoritma exponential backoff lalu coba lagi. Anda harus menyematkan rutinitas yang memilih dan memperbarui secara paksa hanya catatan yang telah berubah sejak titik sinkronisasi terakhir agar integritas data tidak rusak.
Kode yang mengirimkan permintaan dengan membawa kunci rahasia Notion secara langsung di browser klien sangat berbahaya. Token akan terekspos begitu saja dan masalah CORS juga akan muncul. Inilah mengapa proxy serverless middleware harus ditempatkan di tengah.
Klien mengirimkan permintaan ke serverless middleware, dan middleware tersebut melampirkan token yang disembunyikan di variabel lingkungan server untuk berkomunikasi dengan Notion API. Jika ini adalah lingkungan multi-tenant, tabel izin balik (reverse permission table) yang memetakan ID pengguna aplikasi dan pemilik halaman Notion harus ditempatkan di middleware. Struktur inilah yang harus dibuat untuk mencegah kecelakaan kebocoran token dan mengisolasi data secara aman.