Sunucular¶

Sunucu (guild), kendi kanalları, rolleri, üyeleri, ifadeleri ve ayarları olan bir topluluktur. Bu sayfa sunucu nesnesini ve sunucu düzeyindeki işlemleri kapsar. İlgili kaynaklar kendi sayfalarında yer alır:

• Sunucu kanalları: kanalları ve kategorileri listeleme, oluşturma ve sıralama
• Sunucu üyeleri: üyeler, takma adlar, zaman aşımları, üye rolleri ve sahiplik devri
• Sunucu moderasyonu: yasaklamalar
• Roller ve izinler: rol nesnesi, rol yolları ve izin bitleri
• Sunucu emojileri, Sunucu çıkartmaları ve Sunucu denetim kayıtları

Tüm yollar https://tebhos.com/api/v1 adresine görelidir ve kimlik doğrulama gerektirir. Yalnız kullanıcı olarak işaretlenen yollar yalnız kullanıcı oturumu kabul eder; geçerli bir Bot <token> kimlik bilgisi 403 ACCESS_DENIED ile reddedilir. Bu sayfadaki diğer her yol bot token'ı da kabul eder. Geçerli kullanıcının sunucularını listele ve Sunucuyu al ayrıca guilds kapsamlı bir OAuth2 erişim token'ını da kabul eder; diğer her yol geçerli bir erişim token'ını 403 ACCESS_DENIED ile yanıtlar. Hata gövdeleri Hatalar sayfasındaki biçime uyar.

Sunucunun üyesi olmayan bir çağıran 403 FORBIDDEN alır. Üyelik önce denetlendiği için, üye kapsamlı yollarda var olmayan bir sunucu kimliği de 403 döndürür.

Sunucu nesnesi¶

Sunucu nesnesi Sunucuyu al, Sunucuyu değiştir, Sunucu oluştur ve Geçerli kullanıcının sunucularını listele tarafından döndürülür; ayrıca Gateway Guild Update olayının yüküdür. Ready yükü her sunucu için aynı alanları taşır.

Yapı¶

member_count, Sunucuyu al yolunda canlı bir sayıdır (sayı okunamazsa null). Sunucuyu değiştir yolunda ve Gateway olaylarında en fazla 30 saniye eski olabilir. Geçerli kullanıcının sunucularını listele bunu içermez; istendiğinde bunun yerine approximate_member_count döndürür.

Görsel hash'leri https://tebhos.com/api/v1/server-icons/{guild_id}/{hash}.webp biçimindeki URL'lere çözümlenir (diğer görseller için server-banners, server-invite-bg, server-embed-bg). Çözümlenmiş *_url alanları tam URL'yi zaten içerir. Bkz. Medya vekili yolları.

TEBHOS sunucu ekleri nesnesi¶

Ready yükünde bu nesne properties.tebhos konumunda bulunur; diğer her yerde en üst düzeydeki tebhos alanıdır.

Örnek¶

{
  "id": "1489002177550843904",
  "name": "Ada's Workshop",
  "icon": "a_9f2c1d4e7b",
  "banner": null,
  "banner_width": null,
  "banner_height": null,
  "splash": null,
  "splash_width": null,
  "splash_height": null,
  "embed_splash": null,
  "embed_splash_width": null,
  "embed_splash_height": null,
  "splash_card_alignment": 0,
  "vanity_url_code": "workshop",
  "owner_id": "1489002177550843905",
  "system_channel_id": "1489002177550843907",
  "system_channel_flags": 0,
  "rules_channel_id": null,
  "afk_channel_id": null,
  "afk_timeout": 300,
  "features": ["ANIMATED_BANNER", "ANIMATED_ICON", "BANNER", "INVITE_SPLASH", "VANITY_URL"],
  "verification_level": 1,
  "mfa_level": 0,
  "explicit_content_filter": 0,
  "default_message_notifications": 1,
  "disabled_operations": 0,
  "message_history_cutoff": null,
  "nsfw": false,
  "nsfw_level": 0,
  "content_warning_level": 0,
  "content_warning_text": null,
  "member_count": 128,
  "image_url": "https://tebhos.com/api/v1/server-icons/1489002177550843904/a_9f2c1d4e7b.webp",
  "banner_url": null,
  "splash_url": null,
  "embed_splash_url": null,
  "tebhos": {
    "boost_count": 27,
    "boost_goal": 25,
    "boost_bar_enabled": true,
    "banner_separated": false,
    "description": "A place to build things",
    "region": "europe",
    "max_members": 0,
    "is_public": false,
    "invites_disabled": false
  }
}

Sunucu özellikleri¶

features, etkin özellik kümesidir. TEBHOS bunu üç kaynaktan oluşturur.

Sunucunun takviye düzeyinden türetilenler. Bunlar hiç saklanmaz; sunucunun takviye düzeyi yeterince yüksek olduğu sürece görünür. Etkin bir İş Sınıfı aboneliği olan sunucu düzey 2 sayılır.

Sunucu tarafından açılıp kapatılabilenler. MANAGE_GUILD iznine sahip bir üye bunları Sunucuyu değiştir veya özellik açma/kapama yolları ile ekler ya da kaldırır.

Örnek tarafından ayarlananlar. DISCOVERABLE, sunucunun keşif başvurusu onaylı olduğu sürece görünür. Örnek yöneticileri başka özellikler de ayarlayabilir. Gateway; UNAVAILABLE_FOR_EVERYONE, UNAVAILABLE_FOR_EVERYONE_BUT_STAFF ve UNAVAILABLE_HIDDEN (sunucu kullanılamaz olarak bildirilir), LARGE_GUILD_OVERRIDE (bildirimler için büyük sunucu işleme) ve VOICE_E2EE özelliklerine göre davranır.

Doğrulama düzeyleri¶

TEBHOS'ta telefon doğrulaması yoktur; bu yüzden telefona dayalı 4 düzeyi yoktur. Eski istemciler için 4 içeren istek kabul edilir ve 3 (HIGH) olarak saklanır; hâlâ 4 tutan bir sunucu her zaman 3 olarak döndürülür.

TEBHOS düzeyi saklar ve döndürür, uygulamalar da bunu sunucu ayarlarında gösterir; ancak API şu an mesajları veya katılımları buna göre kısıtlamaz. Keşifte listelenen bir sunucu düzeyi LOW'un altına indiremez; böyle bir istek 400 INVALID_FORM_BODY ile başarısız olur.

MFA düzeyleri¶

TEBHOS'ta sunucu düzeyinde çok adımlı doğrulama zorunluluğu yoktur. mfa_level uyumluluk için sunucu nesnesinde kalır ve her zaman 0 (NONE) değerindedir; kimsenin izinlerini kaldırmaz. Hesap düzeyindeki çok adımlı doğrulama bundan etkilenmez.

Varsayılan mesaj bildirim düzeyleri¶

Sistem kanalı bayrakları¶

Bayrak ayarlı değilken system_channel_id ayarlıysa TEBHOS, davetle katılan her üye için sistem kanalına bir katılma mesajı (mesaj türü 7) gönderir.

Davet kartı hizalamaları¶

Sunucu oluştur¶

POST /guilds

Sahibi çağıran olan bir sunucu oluşturur ve sunucu nesnesini 200 durumuyla döndürür. Sahibin diğer oturumları yeni sunucuyu Gateway üzerinden alır.

Bir bot kimlik bilgisinin kimliği doğrulanır, ancak 400 BOTS_CANNOT_CREATE_GUILDS ile reddedilir.

Hız sınırı: guild:create, hesap başına 60 saniyede 10.

JSON gövdesi¶

Hareketli bir simge takviye düzeyi 2 gerektirir ve yeni bir sunucu hiçbir zaman bu düzeyde olmaz; bu yüzden hareketli bir icon 403 FORBIDDEN döndürür. Hareketli simge daha sonra Sunucuyu değiştir ile yüklenir.

Yeni bir sunucu; genel adlı bir metin kanalı ile Genel adlı bir ses kanalını içeren Genel adlı bir kategori ve varsayılan izin kümesine sahip bir @everyone rolü alır. Ses kanalının bit hızı 64000'dir (64 kbps). Sistem kanalı ayarlanmaz.

curl -X POST https://tebhos.com/api/v1/guilds \
  -H "Authorization: Bearer $TEBHOS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "Ada'\''s Workshop"}'

Geçerli kullanıcının sunucularını listele¶

GET /users/@me/guilds

Çağıranın üyesi olduğu her sunucu için bir tane olmak üzere, artan sunucu kimliğine göre sıralanmış bir sunucu nesneleri dizisi döndürür. Her nesne, çağıranın sunucu düzeyindeki maskesi olan permissions alanını içerir. roles, emojis, stickers ve channels dahil edilmez.

guilds kapsamlı bir OAuth2 erişim token'ını da kabul eder; bu kapsamı olmayan bir token 403 MISSING_OAUTH_SCOPE alır.

Hız sınırı: guild:list, hesap başına 10 saniyede 40.

Sorgu parametreleri¶

Çağıranın içinde bulunmadığı bir sunucuyu belirten imleç yok sayılır. Verisi okunamayan bir sunucu isteği başarısız kılmak yerine atlanır; izinleri hesaplanamayan bir sunucu için permissions dahil edilmez. 1-200 aralığı dışındaki limit 400 INVALID_FORM_BODY döndürür.

curl "https://tebhos.com/api/v1/users/@me/guilds?with_counts=true" \
  -H "Authorization: Bot $TEBHOS_BOT_TOKEN"

Sunucuyu al¶

GET /guilds/{guild_id}

Sunucu nesnesini roles (azalan konuma göre sıralı), emojis, stickers, channels ve canlı member_count ile birlikte döndürür. Üyelik gerektirir.

guilds kapsamlı bir OAuth2 erişim token'ını da kabul eder; bu kapsamı olmayan bir token 403 MISSING_OAUTH_SCOPE alır.

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

Sunucuyu değiştir¶

PATCH /guilds/{guild_id}

Sunucu ayarlarını günceller ve güncellenmiş sunucu nesnesini döndürür. MANAGE_GUILD gerektirir. Her başarılı istek sunucuya Guild Update gönderir ve bir GUILD_UPDATE denetim kaydı girdisi oluşturur.

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

JSON gövdesi¶

Her alan isteğe bağlıdır. Atlanan alan değerini korur. ? türündeki alanlarda açık bir null değeri temizler.

nsfw, nsfw_level, content_warning_level ve content_warning_text uyumluluk için kabul edilir ve yok sayılır. Sudo alanları (password, mfa_code vb.) da kabul edilir ve yok sayılır.

Görseller; ham base64 ya da data: URL'si olarak gönderilen, çözüldükten sonra en fazla 10 MiB PNG, JPEG, GIF ve WebP kabul eder. Varlık kuralları sunucunun takviye düzeyine bağlıdır:

Eksik düzey 403 FORBIDDEN döndürür. Simgeyi değiştirmek eski simge dosyasını silinmek üzere zamanlar.

features bir fark değil, sunucunun sahip olması istenen kümenin tamamıdır. Sunucu nesnesindeki dizi, değişiklikler uygulanmış olarak geri gönderilir:

• Dizide olup sunucuda olmayan bir açılıp kapatılabilen özellik eklenir; sunucuda olup dizide olmayan kaldırılır.
• Sunucunun etkin kümesinde zaten bulunan bir özellik (BANNER gibi türetilmiş özellikler dahil) kabul edilir ve olduğu gibi bırakılır.
• Başka herhangi bir özelliği eklemek 400 BAD_REQUEST döndürür.

system_channel_id ve afk_channel_id verildiği gibi saklanır; yol, kanalın var olup olmadığını veya doğru türde olup olmadığını denetlemez.

Keşifte listelenen bir sunucuda verification_level 0 400 INVALID_FORM_BODY döndürür.

curl -X PATCH https://tebhos.com/api/v1/guilds/1489002177550843904 \
  -H "Authorization: Bot $TEBHOS_BOT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "Ada'\''s Lab", "afk_timeout": 600, "system_channel_flags": 1}'

Yalnız TEBHOS'a özgü ayarlar¶

description, region, boost_goal ve boost_bar_enabled (TEBHOS sunucu ekleri) alanlarının bu yolda karşılığı yoktur. Bunlar MANAGE_GUILD gerektiren, guild:update kovasını paylaşan ve {"message": "..."} döndüren PATCH /servers/{guild_id} ile ayarlanır:

Değişiklik Guild Update olarak gönderilir.

Sunucu özelliğini aç/kapat¶

Bu yolların her biri bir açılıp kapatılabilen özelliği ekler veya kaldırır ve güncellenmiş sunucu nesnesini döndürür. MANAGE_GUILD gerektirir ve yalnız kullanıcı içindir. Her biri Guild Update gönderir.

Eksik veya boolean olmayan bir gövde alanı 400 BAD_REQUEST döndürür.

Sunucuyu sil¶

POST /guilds/{guild_id}/delete

Sunucuyu kalıcı olarak siler ve 204 döndürür. Yalnız kullanıcı. Sunucuyu yalnız sahibi silebilir; diğer herkes 403 FORBIDDEN alır.

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

İstek gövdesi yok sayılır; {} gönderilebilir. Parola veya sudo kanıtı gerekmez.

Her üye Guild Delete alır, sunucunun ses kanallarındaki üyelerin bağlantısı kesilir ve sunucu aramadan kaldırılır.

Sunucudan ayrıl¶

DELETE /users/@me/guilds/{guild_id}

Çağıranı sunucudan çıkarır ve 204 döndürür. Çağıranın diğer oturumları Guild Delete, kalan üyeler ise Guild Member Remove alır. Sunucu, çağıranın sunucu klasörlerinden kaldırılır.

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

Sorgu parametreleri¶

Mesaj silme en iyi çaba esasına göre yapılır: başarısız olursa çağıran yine de sunucudan ayrılır.

Geçerli kullanıcının sunucu mesajlarını toplu sil¶

POST /users/@me/guilds/{guild_id}/messages/bulk-delete-mine

Çağıranın sunucunun kanallarında yazdığı her mesajı siler ve gövdesiz 202 döndürür. Çağıran üye olarak kalır. Üyelik ve sudo kipi gerektirir; bir bot token'ı kendi hesabı için sudo kipini karşılar. Etkilenen her kanal bir Message Delete Bulk olayı alır.

Hız sınırı: guild:leave, hesap ve sunucu başına 10 saniyede 10 (Sunucudan ayrıl ile paylaşılır).

Üye olmayan biri 404 NOT_FOUND, sudo yetkisi olmayan bir kullanıcı oturumu 403 SUDO_MODE_REQUIRED alır.

Özel davet URL'si¶

Takviye düzeyi 2 olan bir sunucu özel bir davet kodu (vanity kodu) alabilir. https://tebhos.com/vanity/{code} ve Daveti al bunu çözümler; bkz. Özel davet URL'leri.

Özel davet URL'si nesnesi¶

Sunucunun özel davet URL'sini al¶

GET /guilds/{guild_id}/vanity-url

Özel davet URL'si nesnesini döndürür. MANAGE_GUILD gerektirir. Yalnız kullanıcı.

Hız sınırı: guild:vanity_url:get, hesap ve sunucu başına 10 saniyede 100.

Sunucunun özel davet URL'sini değiştir¶

PATCH /guilds/{guild_id}/vanity-url

Özel davet kodunu ayarlar veya kaldırır ve şu an tutulan kodla {"code": "..."} döndürür (kaldırmadan sonra null). MANAGE_GUILD gerektirir. Yalnız kullanıcı. Guild Update gönderir.

Hız sınırı: guild:vanity_url:patch, istemci ve sunucu başına 60 saniyede 10.

Kod kırpılır ve ASCII harfler, rakamlar, - ve _ karakterlerinden oluşan 2-32 karakter olmalıdır. Kodlar büyük/küçük harften bağımsız olarak benzersizdir ve ayrılmış sözcüklerden oluşan bir liste (admin, api, login, invite, settings gibi) alınamaz. Kodu kaldırmak uses değerini 0'a sıfırlar.

curl -X PATCH https://tebhos.com/api/v1/guilds/1489002177550843904/vanity-url \
  -H "Authorization: Bearer $TEBHOS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"code": "workshop"}'

Özel davet kodunu çözümle¶

GET /vanity/{code}/resolve

Özel bir davet kodunu kimlik doğrulama olmadan çözümler. Büyük/küçük harf yok sayılır. Her çağrı kodun uses değerini artırır. camelCase bir nesne döndürür:

Bilinmeyen bir kod 404 NOT_FOUND döndürür.

Sunucu görselleri¶

Sunucuyu değiştir görselleri satır içinde base64 olarak kabul eder. Web uygulaması ise büyük JSON gövdelerinden kaçınmak için bunları iki adımda doğrudan depolamaya yükler. İki adım da yalnız kullanıcı içindir ve MANAGE_GUILD gerektirir (sahip her zaman geçer).

1. {"filename": string, "content_type": string, "size": integer} ile POST /servers/{guild_id}/{kind}/upload-url. upload_url (300 saniye geçerli, önceden imzalanmış URL), storage_key, url ve expires_in döndürür. 8 MiB'a kadar PNG, JPEG, GIF ve WebP kabul edilir.
2. Baytlar PUT ile upload_url adresine yüklenir, ardından {"storage_key": string} ile POST /servers/{guild_id}/{kind}/confirm çağrılır.

{kind} değeri icon, banner, invite-bg (davet arka planı, splash) veya embed-bg (embed_splash) olur. Sunucuyu değiştir yolunda olduğu gibi afiş takviye düzeyi 2, davet arka planı düzey 1, hareketli simge veya afiş ise düzey 2 gerektirir. Onaylama Guild Update gönderir. Simge onayı {"icon_hash": string, "image_url": string} döndürür.

Sunucu takviyeleri¶

Bir sunucunun takviye düzeyi (0, 1 veya 2) etkin takviye sayısından gelir; türetilmiş sunucu özelliklerini, ses bit hızı üst sınırlarını, yükleme sınırlarını ve hareketli emojileri denetler. Takviye yapma, takviye listesi ve fiyatlandırma Sunucu takviyeleri altında belgelenmiştir. Sunucu nesnesindeki tebhos.boost_count geçerli takviye sayısını tutar.

Roller¶

Rol yolları Roller ve izinler sayfasında belgelenmiştir:

Bir üyeye tek bir rol ekleme ve kaldırma Sunucu üyeleri sayfasında ele alınır.