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:readHesap kimliği, kullanıcı adı, e-posta, rol ve dil
api-logs:readHesaba ait API istek geçmişi
servers:readHesaba ait sunucular, bağlantı bilgisi ve canlı durum
servers:powerMinecraft sürecini başlatma, durdurma ve yeniden başlatma
invoices:readHesaba ait faturaları salt okunur görüntüleme
notifications:readHesaba ait bildirimleri görüntüleme
notifications:writeHesaba 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:read ve api-logs:read
  • Güç otomasyonu: servers:read ve servers:power
  • Bildirim botu: notifications:read; okundu işaretleyecekse ayrıca notifications: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.