API anahtarları ve yapay zekâ bağlantıları için 15 kapsamın tümü: her kapsam neye izin verir, panelde nasıl adlandırılır ve hiçbir API anahtarı neyi yapamaz.
Kapsamlar bir API anahtarının neler yapabileceğini belirler. Aynı 15 kapsam, MCP üzerinden bağladığın yapay zekâ asistanları için de geçerlidir. Her zaman yalnızca bir uygulamanın gerçekten ihtiyaç duyduğu kapsamları seç.
Temel kurallar
- Her uç nokta tam olarak bir kapsam gerektirir
- API anahtarlarında write:X otomatik olarak read:X’i de içerir – panel “write:X otomatik olarak read:X’i de kapsar” notunu gösterir
- Kapsam eksikse API 403 insufficient_scope ile yanıt verir ve gereken kapsamı details.required_scope içinde belirtir
- API anahtarları için hiç etkinleştirilmemiş uç noktalar da 403 insufficient_scope ile yanıt verir
- Üyeler, faturalama veya alan adı yönetimi gibi sahip ve yönetici işlevlerine hiçbir kapsamla ulaşılamaz
Tüm kapsamlar
“Yeni API anahtarı oluştur” penceresinde her alan için “Okuma” veya “Yazma”yı seçersin; anahtar listesi ilk sütundaki kapsam adlarını gösterir. “Okuma · Sayfalar” biçimi, yapay zekâ uygulamaları için onay sayfasında ve “Bağlı uygulamalar” altında görünür.
| Kapsam | Yapay zekâ uygulamaları için | İzin verdikleri |
|---|---|---|
| read:pages | Okuma · Sayfalar | Sayfaları listeleme ve okuma, taslağı okuma ve doğrulama, blokları listeleme, SEO’yu okuma, sürümleri listeleme, blok türlerini getirme |
| write:pages | Yazma · Sayfalar | Sayfa oluşturma ve düzenleme (kullanıcı adı dahil), taslağı düzenleme, blok oluşturma, düzenleme, silme ve yeniden sıralama, SEO’yu düzenleme, görünürlük, yayınlama, bir sürümü geri yükleme, özel sayfalar için davet bağlantıları |
| read:links | Okuma · Bağlantılar | Bir sayfanın bağlantılarını listeleme ve okuma |
| write:links | Yazma · Bağlantılar | Bağlantı oluşturma, düzenleme, silme ve yeniden sıralama |
| read:assets | Okuma · Dosyalar | Dosyaları listeleme |
| write:assets | Yazma · Dosyalar | Dosya yükleme ve silme, bir sayfa için yüklemeler |
| read:forms | Okuma · Formlar | Formları okuma, özet, gönderimleri listeleme ve CSV olarak dışa aktarma (dışa aktarma Creator Pro’dan itibaren) |
| write:forms | Yazma · Formlar | Form oluşturma, düzenleme ve silme |
| read:stats | Okuma · İstatistikler | Sayfa ve çalışma alanı istatistikleri (özet, zaman serisi, karşılaştırma, bağlantılar, widget’lar, dönüşümler, en iyi sayfalar), bildirim geçmişi ve bildirim kullanımı |
| read:workspaces | Okuma · Çalışma alanları | Plan özelliklerini, kullanımı, üye listesini ve çalışma alanı ayarlarını okuma, alan adlarını listeleme, şablonları listeleme ve okuma, callback gizli anahtarlarını listeleme ve okuma (düz metin gizli değer olmadan) |
| write:workspaces | Yazma · Çalışma alanları | Şu anda read:workspaces’in ötesinde uç nokta yok |
| read:donations | Okuma · Destekçi ödemeleri | Çalışma alanının destekçi ödemelerinin toplamları (“Destekle” bloğu üzerinden ödemeler) |
| read:short_links | Okuma · Kısa bağlantılar | Kısa bağlantıları listeleme ve okuma |
| write:short_links | Yazma · Kısa bağlantılar | Kısa bağlantı oluşturma, düzenleme ve silme |
| write:templates | Yazma · Çalışma alanı şablonları | Kendi çalışma alanı şablonlarını oluşturma, düzenleme ve silme (read:workspaces ile okunurlar), bkz. Özel şablonlar |
Hangi uç noktaların tam olarak hangi kapsama ait olduğu Alanlara göre uç noktalar bölümünde gösteriliyor.
Hiçbir API anahtarının yapamadıkları
- Sayfa silme
- Taslak için önizleme bağlantısı oluşturma
- Cihaza, ülkeye, yönlendirene ve UTM’ye göre istatistik kırılımları
- Anlık bildirim gönderme ve bildirim kurallarını yönetme
- Entegrasyonları bağlama veya bağlantılarını kesme
- Webhook’ları yönetme
- Alan adı ekleme, doğrulama, etkinleştirme, devre dışı bırakma veya silme
- Üyeleri, davetleri ve rolleri yönetme, sahipliği devretme
- Çalışma alanı ayarlarını değiştirme, faturalama
- Callback gizli anahtarlarını oluşturma, düzenleme, yenileme veya silme
- Destekçi ödemelerinin listesi, veri erişim talepleri ve form gönderimlerini anonimleştirme
- Profilini, takip ettiğin sayfaları ve API anahtarlarının kendisini yönetme
Bunları panelde yaparsın.
Yapay zekâ asistanları için kapsamlar
Bir MCP bağlantısı için onay sayfasında aynı kapsamları seçersin. İki fark var: birincisi, orada bir yazma izni okuma iznini içermez – bu yüzden ikisini de ver. İkincisi, rolün seçimi sınırlar: görüntüleyenler yalnızca okuma izinleri alır (formlar ve kısa bağlantılar olmadan), editörler “Yazma · Çalışma alanları”, kısa bağlantılar ve çalışma alanı şablonları dışında her şeyi alır. Daha fazlası İzinler, güvenlik ve limitler bölümünde.
Önerilen kombinasyonlar
| Kullanım durumu | Kapsamlar |
|---|---|
| Raporlama ve panolar | read:stats, read:pages |
| Bir CMS’ten veya mağazadan bağlantıları senkronize etme | write:links, read:pages |
| Sayfaları otomatik olarak yönetme ve yayınlama | write:pages, write:links |
| CRM’den kampanya bağlantıları | write:short_links |
| Formlardan gelen potansiyel müşterileri CRM’e aktarma | read:forms |
| Şablonları bir CI hattından dağıtma | write:templates, read:workspaces |
Bunlar da işine yarayabilir
Bir şey bulamadın mı?
Neye ihtiyacın olduğunu bize anlat, destek ekibimiz sana kişisel olarak yardımcı olsun.