Sunucu moderasyonu¶

Sunucu yasağı, bir hesabı bir sunucunun dışında tutar ve kaldırdığı üyelikten daha uzun süre kalır. Bu sayfa yasaklamaları kapsar. Bir üyeyi atmak Sunucu üyesini çıkar ile yapılır; zaman aşımı, sunucu genelinde susturma ve sağırlaştırma ise Sunucu üyesini değiştir ile ayarlanır.

Tüm yollar 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. Her yol BAN_MEMBERS gerektirir. Üye olmayan veya izne sahip olmayan bir çağıran 403 FORBIDDEN alır. Hata gövdeleri Hatalar sayfasındaki biçime uyar.

TEBHOS'ta toplu yasaklama ve üye budama (prune) işlemi yoktur.

Sunucu yasağı nesnesi¶

Alan	Tür	Açıklama
user	object	Yasaklanan hesap: `id`, `username` (bilinmiyorsa boş), `discriminator` (her zaman `0`), `global_name`, `avatar` (her zaman null) ve `bot` (her zaman `false`)
reason	?string	Yasak oluşturulurken verilen gerekçe
moderator_id	?snowflake	Yasağı oluşturan hesap
banned_at	?ISO8601 zaman damgası	Yasağın oluşturulduğu veya en son değiştirildiği zaman
expires_at	?ISO8601 zaman damgası	Geçici bir yasağın sona erdiği zaman; kalıcı yasak için null

Geçici bir yasak süresi dolduğunda otomatik olarak kaldırılır ve artık döndürülmez. Zaten yasaklı bir hesabı yasaklamak mevcut yasağın yerine geçer.

{
  "user": {
    "id": "1489002177550843906",
    "username": "spammer",
    "discriminator": 0,
    "global_name": null,
    "avatar": null,
    "bot": false
  },
  "reason": "Advertising",
  "moderator_id": "1489002177550843905",
  "banned_at": "2026-09-14T09:12:44+00:00",
  "expires_at": null
}

Bir yasak var olduğu sürece hesap sunucuya katılamaz: Daveti kabul et ve keşiften katılma 403 FORBIDDEN ile başarısız olur.

Sunucu yasaklarını listele¶

GET /guilds/{guild_id}/bans

Sunucunun tüm sunucu yasağı nesnelerini sayfalama olmadan tek bir dizide döndürür. BAN_MEMBERS gerektirir.

Hız sınırı: guild:members, hesap ve sunucu başına 10 saniyede 40 (üye okumaları ve üye araması ile paylaşılır).

curl https://tebhos.com/api/v1/guilds/1489002177550843904/bans \
  -H "Authorization: Bot $TEBHOS_BOT_TOKEN"

Sunucu yasağı oluştur¶

PUT /guilds/{guild_id}/bans/{user_id}

Bir hesabı yasaklar ve gövdesiz 204 döndürür. BAN_MEMBERS gerektirir. Hesabın üye olması gerekmez; üye olmayan birini yasaklamak onun sonradan katılmasını engeller. Hesap bir üyeyse çağıran rol hiyerarşisinde ondan üstün olmalıdır ve üye sunucudan çıkarılır.

Hız sınırı: guild:member:remove, hesap ve sunucu başına 10 saniyede 20 (atma ve yasak kaldırma ile paylaşılır).

JSON gövdesi¶

Her alan isteğe bağlıdır; hiçbir mesajı silmeyen kalıcı bir yasak için {} gönderin.

Alan	Tür	Açıklama
reason?	?string	Yasakta ve denetim kaydında saklanan gerekçe
delete_message_seconds?	integer	Hesabın sunucudaki mesajlarını bu kadar saniye geriye kadar siler. Tam günlere yukarı yuvarlanır, en fazla 7 gün
delete_message_days?	integer	Mesajları bu kadar gün geriye kadar siler, en fazla 7. Yalnızca `delete_message_seconds` yoksa veya 0 ise kullanılır
ban_duration_seconds?	integer	Yasağı bu kadar saniye süren geçici bir yasak yapar. Gönderilmemesi veya 0 kalıcı demektir

Mesaj silme işlemi, yasak saklandıktan sonra arka planda çalışır.

Durum	Kod	Koşul
400	`BAD_REQUEST`	`user_id` bir snowflake değil
403	`FORBIDDEN`	`BAN_MEMBERS` eksik veya çağıran üyeden üstün değil
404	`NOT_FOUND`	Bu kimliğe sahip bir hesap yok veya hedef çağıranın kendisi

Yasak oluşturmak bir MEMBER_BAN_ADD denetim girdisi kaydeder ve sunucuya Guild Ban Add, üye için ayrıca Guild Member Remove gönderir. Yasaklanan hesabın oturumları sunucudan çıkarılır. Yasaklanan üye takma adını, rollerini ve sunucu profilini kaybeder; etkin bir zaman aşımı korunmaz.

curl -X PUT https://tebhos.com/api/v1/guilds/1489002177550843904/bans/1489002177550843906 \
  -H "Authorization: Bot $TEBHOS_BOT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"reason": "Advertising", "delete_message_seconds": 86400, "ban_duration_seconds": 604800}'

Sunucu yasağını kaldır¶

DELETE /guilds/{guild_id}/bans/{user_id}

Bir yasağı kaldırır ve gövdesiz 204 döndürür. BAN_MEMBERS gerektirir. Var olmayan bir yasağı kaldırmak da 204 döndürür.

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

İşlem bir MEMBER_BAN_REMOVE denetim girdisi kaydeder ve Guild Ban Remove gönderir. Kaldırılan üyeliği, rolleri veya silinen mesajları geri getirmez; hesap bir davetle yeniden katılabilir.

Zaman aşımları¶

Zaman aşımı, bir üyenin belirlenen bir zamana kadar sunucuda iletişim kurmasını engeller. Sunucu üyesini değiştir isteğinin communication_disabled_until alanıyla uygulanır ve kaldırılır; bu da MODERATE_MEMBERS gerektirir. Zaman aşımındaki bir üyenin yapamadıkları İletişim zaman aşımı bölümünde listelenir.