Müşteri API'si
Yetki kapsamları
Her entegrasyona yalnız ihtiyaç duyduğu API izinlerini verin.
Son güncelleme
| Kapsam | İzin verdiği erişim |
|---|---|
account:read | Hesap kimliği, kullanıcı adı, e-posta, rol ve dil |
api-logs:read | Hesaba ait API istek geçmişi |
servers:read | Hesaba ait sunucular, bağlantı bilgisi ve canlı durum |
servers:power | Minecraft sürecini başlatma, durdurma ve yeniden başlatma |
invoices:read | Hesaba ait faturaları salt okunur görüntüleme |
notifications:read | Hesaba ait bildirimleri görüntüleme |
notifications:write | Hesaba ait bildirimleri okundu olarak işaretleme |
En az ayrıcalık örnekleri
- Durum sayfası: yalnız
servers:read - Fatura arşivi: yalnız
invoices:read - İzleme uygulaması:
servers:readveapi-logs:read - Güç otomasyonu:
servers:readveservers:power - Bildirim botu:
notifications:read; okundu işaretleyecekse ayrıcanotifications:write
Bir uç nokta gerekli kapsam olmadan çağrılırsa 403 INSUFFICIENT_SCOPE döner ve required_scope alanı gereken izni belirtir.
Sahiplik kapsamdan ayrıdır
Bir anahtar doğru kapsama sahip olsa bile yalnız anahtar sahibinin kayıtlarına erişebilir. Başka müşteriye ait bir kimlik gönderildiğinde kayıt yokmuş gibi 404 döner.