Ke-15 scope untuk kunci API dan koneksi AI: apa yang diizinkan setiap scope, namanya di dasbor, dan apa yang tidak bisa dilakukan kunci API mana pun.
Scope menentukan apa yang boleh dilakukan sebuah kunci API. Ke-15 scope yang sama juga berlaku untuk asisten AI yang Anda hubungkan lewat MCP. Selalu pilih hanya scope yang benar-benar diperlukan sebuah aplikasi.
Aturan dasar
- Setiap endpoint memerlukan tepat satu scope
- Untuk kunci API, write:X otomatis mencakup read:X – dasbor mencatat “write:X otomatis mencakup read:X”
- Jika scope-nya tidak ada, API merespons dengan 403 insufficient_scope dan menyebutkan scope yang diperlukan di details.required_scope
- Endpoint yang sama sekali tidak diaktifkan untuk kunci API juga merespons dengan 403 insufficient_scope
- Fungsi pemilik dan admin seperti anggota, penagihan, atau mengelola domain tidak bisa dijangkau dengan scope apa pun
Semua scope
Di dialog “Buat kunci API baru” Anda memilih “Baca” atau “Tulis” untuk setiap area; daftar kunci menampilkan nama scope dari kolom pertama. Bentuk “Baca · Halaman” muncul di halaman persetujuan untuk aplikasi AI dan di “Aplikasi terhubung”.
| Scope | Untuk aplikasi AI | Mengizinkan |
|---|---|---|
| read:pages | Baca · Halaman | Mendaftar dan membaca halaman, membaca dan memvalidasi draf, mendaftar blok, membaca SEO, mendaftar versi, mengambil jenis blok |
| write:pages | Tulis · Halaman | Membuat dan mengedit halaman (termasuk handle), mengedit draf, membuat, mengedit, menghapus, dan mengurutkan ulang blok, mengedit SEO, visibilitas, publikasi, memulihkan versi, tautan undangan untuk halaman privat |
| read:links | Baca · Tautan | Mendaftar dan membaca tautan sebuah halaman |
| write:links | Tulis · Tautan | Membuat, mengedit, menghapus, dan mengurutkan ulang tautan |
| read:assets | Baca · Aset | Mendaftar aset |
| write:assets | Tulis · Aset | Mengunggah dan menghapus aset, unggahan untuk sebuah halaman |
| read:forms | Baca · Formulir | Membaca formulir, ringkasan, mendaftar kiriman dan mengekspornya sebagai CSV (ekspor mulai Creator Pro) |
| write:forms | Tulis · Formulir | Membuat, mengedit, dan menghapus formulir |
| read:stats | Baca · Statistik | Statistik halaman dan workspace (ringkasan, deret waktu, perbandingan, tautan, widget, konversi, halaman teratas), riwayat push, dan pemakaian push |
| read:workspaces | Baca · Workspace | Membaca fitur paket, pemakaian, daftar anggota, dan pengaturan workspace, mendaftar domain, mendaftar dan membaca templat, mendaftar dan membaca rahasia callback (tanpa rahasia dalam teks biasa) |
| write:workspaces | Tulis · Workspace | Saat ini tidak ada endpoint di luar read:workspaces |
| read:donations | Baca · Pembayaran pendukung | Total pembayaran pendukung workspace (pembayaran lewat blok “Dukung”) |
| read:short_links | Baca · Tautan pendek | Mendaftar dan membaca tautan pendek |
| write:short_links | Tulis · Tautan pendek | Membuat, mengedit, dan menghapus tautan pendek |
| write:templates | Tulis · Templat workspace | Membuat, mengedit, dan menghapus templat workspace sendiri (dibaca dengan read:workspaces), lihat Templat sendiri |
Endpoint mana persisnya yang termasuk dalam scope mana ditunjukkan di Endpoint per area.
Yang tidak bisa dilakukan kunci API mana pun
- Menghapus halaman
- Membuat tautan pratinjau untuk draf
- Rincian statistik menurut perangkat, negara, perujuk, dan UTM
- Mengirim notifikasi push dan mengelola aturan push
- Menghubungkan atau memutus integrasi
- Mengelola webhook
- Menambah, memverifikasi, mengaktifkan, menonaktifkan, atau menghapus domain
- Mengelola anggota, undangan, dan peran, mengalihkan kepemilikan
- Mengubah pengaturan workspace, penagihan
- Membuat, mengedit, merotasi, atau menghapus rahasia callback
- Daftar pembayaran pendukung, permintaan akses data, dan menganonimkan kiriman formulir
- Mengelola profil Anda, halaman yang Anda ikuti, dan kunci API itu sendiri
Hal-hal ini Anda lakukan di dasbor.
Scope untuk asisten AI
Untuk koneksi MCP, Anda memilih scope yang sama di halaman persetujuan. Ada dua perbedaan: pertama, izin tulis di sana tidak mencakup izin baca – jadi berikan keduanya. Kedua, peran Anda membatasi pilihan: pelihat hanya mendapat izin baca (tanpa formulir dan tautan pendek), editor mendapat semua kecuali “Tulis · Workspace”, tautan pendek, dan templat workspace. Selengkapnya di Izin, keamanan, dan batas.
Kombinasi yang disarankan
| Kasus penggunaan | Scope |
|---|---|
| Pelaporan dan dasbor | read:stats, read:pages |
| Menyinkronkan tautan dari CMS atau toko | write:links, read:pages |
| Mengurus dan memublikasikan halaman secara otomatis | write:pages, write:links |
| Tautan kampanye dari CRM | write:short_links |
| Meneruskan prospek dari formulir ke CRM | read:forms |
| Meluncurkan templat dari pipeline CI | write:templates, read:workspaces |
Mungkin ini juga berguna
Tidak menemukan jawabannya?
Beri tahu kami apa yang Anda perlukan, dan tim dukungan kami akan membantu Anda secara langsung.