Sunucu denetim kayıtları¶

Denetim kaydı girdisi, bir sunucuda yapılan tek bir değişikliği ve onu yapan hesabı kaydeder. Girdiler sunucuyu değiştiren işlemler tarafından yazılır ve Sunucu denetim kayıtlarını listele ile okunur.

Yol https://tebhos.com/api/v1 adresine görelidir, kimlik doğrulama gerektirir ve hem kullanıcı oturumlarını hem de bot token'larını kabul eder. Hata gövdeleri Hatalar sayfasındaki biçime uyar.

Denetim kaydı gerekçesi¶

TEBHOS bir istek başlığından denetim kaydı gerekçesi okumaz. İki işlem gerekçeyi gövdelerinden alır ve girdiye kaydeder:

• Sunucu yasağı oluştur reason alanını kullanır.
• Sunucu üyesini değiştir, zaman aşımı ayarladığında timeout_reason alanını kullanır.

Diğer tüm girdilerde reason null olur.

Sunucu denetim kaydı yanıtı nesnesi¶

users içindeki bir kullanıcıda id, username, discriminator, global_name, avatar, avatar_color ve flags bulunur. Artık mevcut olmayan bir hesap boş username, "0000" ayırt edicisi ve null avatar alanlarıyla döndürülür.

Sunucu denetim kaydı girdisi nesnesi¶

Girdilerin süresi, yazıldıktan 45 gün sonra dolar.

{
  "id": "1501314428688998184",
  "action_type": 22,
  "user_id": "1489002177550843905",
  "target_id": "1489002177550843906",
  "reason": "Advertising",
  "options": {"tebhos_action": "MEMBER_BAN", "target_type": "member"},
  "changes": []
}

Denetim kaydı değişikliği nesnesi¶

TEBHOS bir değişikliğin yalnızca yeni tarafını kaydeder; old_value yoktur. Çoğu eylem varlığın name değerini kaydeder. Sunucuyu değiştir, name, features, icon, banner, splash ve embed_splash alanlarından değiştirdiği her birini kaydeder; Sunucu rolünü değiştir name ve color değerlerini kaydeder; webhook oluşturma ayrıca channel_id değerini kaydeder; ses taşımaları channel_id ve connection_id değerlerini kaydeder; sunucu genelinde susturma ve sağırlaştırma mute ve deaf değerlerini kaydeder.

Denetim eylemleri¶

Değer sayısal action_type değeridir; action_type sorgu parametresinin kabul ettiği değer de budur. Son sütun, eylemi mevcut bir TEBHOS işleminin yazıp yazmadığını gösterir.

TEBHOS'a özgü eylemler. Standart bir numarası olmayan eylemler action_type 0 ile saklanır ve options.tebhos_action ile tanımlanır:

Bu tür girdiler action_type filtresi olmadan okunabilir. action_type=0 ile filtrelemek onları döndürür.

Sunucu denetim kayıtlarını listele¶

GET /guilds/{guild_id}/audit-logs

Denetim geçmişinin bir sayfasını bir sunucu denetim kaydı yanıtı nesnesi olarak döndürür. VIEW_AUDIT_LOG gerektirir.

Hız sınırı: guild:audit_logs, hesap ve sunucu başına 10 saniyede 20.

Sorgu parametreleri¶

Girdiler after ile de her zaman en yeniden eskiye döndürülür: bir after sayfası imlecin üzerindeki en yeni girdiyle başlar. Geçmişte geriye doğru ilerlemek için aldığınız son girdinin id değerini before olarak gönderin.

curl "https://tebhos.com/api/v1/guilds/1489002177550843904/audit-logs?limit=25&action_type=22" \
  -H "Authorization: Bot $TEBHOS_BOT_TOKEN"

Çoğu girdi yazıldığında sunucu ayrıca Gateway üzerinden bir Guild Audit Log Entry Create olayı alır. action_type değeri 0 olan girdiler gönderilmez.