Sunucu kanalları¶

Bir sunucu kanallara bölünür ve kategoriler bu kanalları gruplar. Bu sayfadaki yollar bir sunucunun kanallarını listeler, kanal ve kategori oluşturur ve bunların sırasını ve üst öğesini değiştirir. Kanal nesnesi ve kanal veya kategori değiştirme ve silme ile izin geçersiz kılmalarını ayarlama dahil kanal başına her işlem Kanallar sayfasında tanımlanı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; yalnızca kullanıcı olarak işaretlenmiş yollar bunun dışındadır (bu durumda geçerli bir bot token'ı 403 ACCESS_DENIED ile reddedilir). Sunucunun üyesi olmayan bir çağıran 403 FORBIDDEN alır. Hata gövdeleri Hatalar sayfasındaki biçime uyar.

Sunucu kanalı türleri¶

Bunlar bir sunucunun içinde bulunan kanal türleri ve Sunucu kanalı oluştur isteğinin type alanında kabul ettiği değerlerdir.

Kategori, türü 4 olan bir kanal satırıdır. Adı, konumu ve izin geçersiz kılmaları vardır; diğer kanallar ona parent_id ile işaret eder. Kategoriler iç içe olamaz.

İzin geçersiz kılma oluşturma nesnesi¶

Bir kanalın oluşturulurken alabileceği ilk geçersiz kılmalar. Saklanan biçim izin geçersiz kılma nesnesidir.

Aynı bitin hem allow hem de deny içinde bulunması 400 BAD_REQUEST döndürür. Tanımlı hiçbir izni adlandırmayan bitler atılır.

{
  "id": "1489002177550843904",
  "type": 0,
  "allow": "0",
  "deny": "1024"
}

Kanal konumu nesnesi¶

Sunucu kanalı konumlarını değiştir isteğinin bir girdisi.

Kardeşler kova başına sayılır: kategoriler diğer kategoriler arasında, diğer her kanal ise aynı üst öğeye sahip kanallar arasında (veya en üst düzey kanallar arasında) sıralanır. Bir girdide ne position ne de preceding_sibling_id varsa, ses kanalı en sona, diğer kanallar ise ilk ses kardeşinin hemen önüne yerleştirilir.

{
  "id": "1501314428688998182",
  "parent_id": "1501314428688998100",
  "preceding_sibling_id": null,
  "lock_permissions": true
}

Sunucu kanallarını listele¶

GET /guilds/{guild_id}/channels

Sunucu için position ve ardından kimliğe göre sıralanmış bir kanal nesneleri dizisi döndürür. Bir kanal veya kategori yalnızca çağıran onda VIEW_CHANNEL iznine sahipse dahil edilir. Üyelik gerektirir. Yolun sayfalaması yoktur.

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

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

Sunucu kanalı oluştur¶

POST /guilds/{guild_id}/channels

Bir kanal veya kategori oluşturur ve kanal nesnesini 201 durumuyla döndürür. MANAGE_CHANNELS gerektirir. Sunucu Channel Create alır.

Kategori oluşturmak (type 4) yalnızca kullanıcıya yöneliktir. Diğer türleri oluşturmak bot token'ını da kabul eder.

Hız sınırı: guild:channel:create, hesap ve sunucu başına 60 saniyede 10 (metin, ses ve bağlantı kanalları; kategori oluşturmanın yol kovası yoktur).

JSON gövdesi¶

Kategori için yalnızca name ve permission_overwrites kullanılır.

İzin geçersiz kılmaları. permission_overwrites gönderilmezse bir kategorinin içinde oluşturulan kanal o kategorinin geçersiz kılmalarını kopyalar. Gönderilirse (boş dizi dahil) bu devralmanın yerini tamamen alır. Bu alanı göndermek ayrıca MANAGE_ROLES gerektirir ve bir geçersiz kılmanın izin verdiği her bit, çağıranın üst kategoride (üst öğe yoksa sunucuda) sahip olduğu bir bit olmalıdır; aksi hâlde istek hiçbir şey oluşturulmadan 403 FORBIDDEN ile başarısız olur. Bkz. Rol hiyerarşisi.

Bit hızı. Yeni bir ses kanalının varsayılanı 64000'dir (64 kbps). Kabul edilen en düşük değer 8000'dir (8 kbps). Çağıranın ayarlayabileceği en yüksek bit hızı, kendi hakkı ile sunucunun takviye hakkından büyük olanıdır:

Daha yüksek bir değer 403 BITRATE_REQUIRES_UPGRADE, üst sınır zaten 384 kbps ise 400 BITRATE_EXCEEDS_LIMIT döndürür.

Konum. Yeni bir kanal, aynı üst öğeye sahip kanallar arasındaki en yüksek konumun arkasına yerleştirilir. Yeni bir kategori son kategorinin arkasına yerleştirilir.

Metin, ses veya bağlantı kanalı oluşturmak bir CHANNEL_CREATE denetim kaydı girdisi kaydeder.

curl -X POST https://tebhos.com/api/v1/guilds/1489002177550843904/channels \
  -H "Authorization: Bot $TEBHOS_BOT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "announcements",
    "type": 0,
    "parent_id": "1501314428688998100",
    "permission_overwrites": [
      {"id": "1489002177550843904", "type": 0, "deny": "2048"}
    ]
  }'

Sunucu kanalı konumlarını değiştir¶

PATCH /guilds/{guild_id}/channels

Kanalları ve kategorileri taşır ve yeniden sıralar; gövdesiz 204 döndürür. Gövde, kanal konumu nesnelerinden oluşan bir JSON dizisidir. MANAGE_CHANNELS gerektirir.

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

Girdiler dizi sırasıyla, her biri bir öncekinin sonucuna uygulanır. Hiçbir şey yazılmadan önce isteğin tamamı doğrulanır; bu yüzden geçersiz bir girdi tüm kanalları değiştirmeden bırakır:

Etkilenen her kovada konumlar, ortaya çıkan sıraya göre 0'dan başlayarak yeniden numaralandırılır. Bir kategoriyi taşımak yalnızca onun kategoriler arasındaki yerini değiştirir; kanalları üst öğelerini korur. Yalnızca konumu, üst öğesi veya geçersiz kılmaları gerçekten değişen satırlar yazılır.

lock_permissions yalnızca girdi kanalı farklı bir kategoriye taşıdığında etkili olur. Kategorinin geçersiz kılmalarını kanala kopyalar ve taşınan kanalda MANAGE_ROLES gerektirir; kopyanın izin verdiği her bit ve reddetmeyi bıraktığı her bit, çağıranın orada sahip olduğu bir bit olmalıdır.

En az bir kanal değiştiğinde sunucu, değişiklikten sonra saklandığı hâliyle sunucunun kanallarını taşıyan tek bir Channel Update Bulk olayı alır. İşlem hiçbir denetim kaydı girdisi kaydetmez.

curl -X PATCH https://tebhos.com/api/v1/guilds/1489002177550843904/channels \
  -H "Authorization: Bot $TEBHOS_BOT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '[{"id": "1501314428688998182", "parent_id": "1501314428688998100", "preceding_sibling_id": null}]'

Kategoriler¶

Kategori, Sunucu kanalı oluştur ile type 4 kullanılarak oluşturulur ve Sunucu kanalı konumlarını değiştir ile taşınır. Bir kategoriyi yeniden adlandırmak, geçersiz kılmalarını değiştirmek ve silmek kanal yollarını kullanır: Kanalı değiştir, Kanal izin geçersiz kılmasını ayarla ve Kanalı sil. Kanal izinlerini kategoriyle eşitle, bir kategorinin geçersiz kılmalarını kanallarından birine kopyalar.