Keşif¶

Keşif, herhangi bir hesabın göz atıp katılabileceği herkese açık sunucu dizinidir. Bir sunucu yöneticisi sunucusunun listelenmesi için başvurur ve TEBHOS ekibi başvuruyu inceler. Onaylanan sunucular TEBHOS arama altyapısında (Elasticsearch) dizinlenir ve Keşif sunucularında ara sonuçlarında görünür.

Bu sayfadaki her yol bir kullanıcı oturumu gerektirir (Authorization: Bearer <token>, bkz. Kimlik doğrulama). Geçerli bir bot token'ı 403 ACCESS_DENIED ile reddedilir.

Başvuru yolları /guilds/{guild_id}/discovery altında bulunur. Aynı işleyiciler /servers/{guild_id}/discovery altına da bağlanmıştır; iki yol da aynı şekilde davranır. MANAGE_GUILD iznini gerektirirler (sunucu sahibi her zaman geçer). Sunucunun üyesi olmayan veya izne sahip olmayan bir çağıran 403 FORBIDDEN alır.

Keşif sunucusu nesnesi¶

Keşif sunucularında ara tarafından döndürülen, herkese açık tek bir sunucu kaydı.

Yapı¶

member_count ve online_count, döndürülen sayfa için gateway'den yenilenir. Canlı sayılar kullanılamadığında member_count eski olabilir; online_count ise ilk 2000 üyenin durum (presence) bilgisinden yaklaşık olarak hesaplanır (veya 0 olur).

Örnek¶

{
  "id": "1489002177550843904",
  "name": "Example guild",
  "icon": "a_9f1c2d3e4b5a60718293a4b5c6d7e8f9",
  "banner": null,
  "description": "A place to talk about the example project.",
  "category_type": 4,
  "primary_language": "en-US",
  "custom_tags": ["open source", "rust"],
  "member_count": 4120,
  "online_count": 318,
  "features": ["DISCOVERABLE"],
  "verification_level": 1,
  "boost_level": 2
}

Keşif arama sonucu nesnesi¶

Eşleşen kayıtlardan oluşan bir sayfa.

Yapı¶

İstemci, offset değeri total değerine ulaşana kadar offset ile sayfalama yapar.

Keşif başvurusu nesnesi¶

Bir sunucunun keşif kaydı ve inceleme durumu. Bir sunucunun en fazla bir başvurusu olur. Reddedilmiş veya kaldırılmış bir başvuru, sunucu yeniden başvurana veya başvuruyu geri çekene kadar sonucu ve gerekçesiyle birlikte okunabilir kalır.

Yapı¶

Örnek¶

{
  "guild_id": "1489002177550843904",
  "status": "pending",
  "description": "A place to talk about the example project.",
  "category_type": 4,
  "primary_language": "en-US",
  "custom_tags": ["open source", "rust"],
  "applied_at": "2026-08-04T11:22:19.000000+00:00",
  "reviewed_at": null,
  "review_reason": null,
  "removed_at": null,
  "removal_reason": null
}

Keşif durumu nesnesi¶

Bir sunucunun başvuru durumu ve başvuru yapmaya şu anki uygunluğu.

Yapı¶

Örnek¶

{
  "application": null,
  "eligible": true,
  "min_member_count": 1
}

Keşif kategorisi nesnesi¶

Keşif kategorileri¶

Küme sabittir.

0 ile 8 aralığının dışındaki bir category_type 400 BAD_REQUEST ile reddedilir. Arama sorgularında aralık dışındaki bir category yok sayılır (kategori filtresi uygulanmaz).

Görünen adlar yerelleştirilmez; çevrilmiş etiketler isteyen bir istemci, id değerine göre kendi etiketlerini sağlar.

Keşif başvurusu durumları¶

pending veya approved durumunda bir başvurusu olan sunucu yeni bir başvuru gönderemez. Ret veya kaldırmadan sonra yapılan yeni bir başvuru önceki kaydın yerine geçer.

Birincil dil¶

Her kayıt bir birincil dil kodu saklar (örneğin en-US veya tr). Değer kırpılır; gönderilmemiş veya boş bir değer en-US olarak saklanır. Arama, saklanan kodun birebir aynısına göre filtreler.

Özel etiketler¶

Bir kaydın en fazla on özel etiketi olur. TEBHOS her etiketi kırpar ve yalnızca kırpıldıktan sonra 2 ile 30 karakter uzunluğundaki etiketleri tutar; daha kısa veya daha uzun etiketler reddedilmek yerine sessizce atılır. Kalan etiketlerden en fazla ilk on tanesi saklanır.

Keşif sunucularında ara¶

GET /discovery/guilds

Keşif dizininde arama yapar ve bir keşif arama sonucu nesnesi döndürür. Çağıranın herhangi bir izne veya eşleşen sunucularla herhangi bir ilişkiye ihtiyacı yoktur.

Sorgu parametreleri¶

query olmadan sonuçlar üye sayısına göre (azalan) sıralanır. query verildiğinde sonuçlar en yeni sunucu başta olacak şekilde sıralanır. tag ve sort_by parametreleri kabul edilir ancak yok sayılır.

Yanıt¶

Hız sınırı¶

discovery:search kovasında, istemci başına 10 saniyede 30 istek.

Hızlı sunucu araması¶

GET /discovery/search

İstemcinin arama kutusunun kullandığı hafif bir arama. Keşfedilebilir sunucu dizin belgelerinden oluşan bir dizi döndürür (sayfalama zarfı ve canlı çevrim içi sayılar yoktur).

Keşif kategorilerini listele¶

GET /discovery/categories

Artan id sırasıyla tüm keşif kategorisi nesnelerinin bir dizisini döndürür.

[
  { "id": 0, "name": "Gaming" },
  { "id": 1, "name": "Music" }
]

Hız sınırı¶

discovery:categories kovasında, istemci başına 10 saniyede 60 istek.

Keşif botlarını listele¶

GET /discovery/bots

Keşif ekranının "Botlar" rafı için, sahibinin herkese açık olarak işaretlediği en fazla 50 bot uygulamasını döndürür. Okunabilir bir bot kullanıcısı olmayan botlar atlanır.

Yanıt¶

{
  "bots": [
    {
      "id": "1489002177550843905",
      "client_id": "1489002177550843905",
      "bot_user_id": "1489002177550843906",
      "name": "Example Bot",
      "description": "Plays music in voice channels.",
      "avatar": "9f1c2d3e4b5a60718293a4b5c6d7e8f9",
      "banner": null,
      "default_permissions": "12371"
    }
  ]
}

Keşif sunucusuna katıl¶

POST /discovery/guilds/{guild_id}/join

Kimliği doğrulanmış hesabı keşfedilebilir bir sunucuya ekler ve boş gövdeyle 204 döndürür. Davet gerekmez ve hiçbir davet kullanım hakkı tüketilmez.

Bir sunucuya bu yolla, approved bir başvurusu olduğunda, DISCOVERABLE özelliğine sahip olduğunda veya BUSINESS_CLASS özelliğine sahip olduğunda katılınabilir (böylece İş rozetindeki "Katıl" düğmesi listelenmemiş İş sunucuları için bile çalışır).

Yanıt¶

Yan etkiler¶

Yeni bir üye için katılım, sunucuya Guild Member Add gönderir ve katılan hesabın açık oturumlarını sunucuya bağlar (oturumlar Guild Create alır). Hesapta "yeni sunuculardan gelen DM'leri kısıtla" seçeneği etkinse sunucu, hesabın kısıtlı listesine eklenir. Katılım sistem mesajı gönderilmez.

Hız sınırı¶

discovery:join kovasında, kullanıcı başına dakikada 10 istek (sunucuya göre bölümlenmez).

Keşif durumunu getir¶

GET /guilds/{guild_id}/discovery

Hiç başvurmamış bir sunucu da dahil olmak üzere bir sunucunun keşif durumu nesnesini döndürür. MANAGE_GUILD gerektirir.

Hız sınırı¶

discovery:status kovasında, kullanıcı ve sunucu başına 10 saniyede 30 istek.

Keşfe başvur¶

POST /guilds/{guild_id}/discovery

Bir sunucunun keşif başvurusunu gönderir ve pending durumundaki sonuç keşif başvurusu nesnesini döndürür. MANAGE_GUILD gerektirir. Her başvuru ekibin kararını bekler; otomatik onay yoktur.

JSON gövdesi¶

Yanıt¶

Yan etkiler¶

Sunucunun etkin özellikleri değişebileceği için sunucu yeniden dizinlenir ve bir Guild Update gönderilir.

Hız sınırı¶

discovery:apply kovasında, kullanıcı ve sunucu başına dakikada 5 istek; Keşif başvurusunu düzenle ve Keşif başvurusunu geri çek ile paylaşılır.

Örnek¶

curl -X POST "https://tebhos.com/api/v1/guilds/1489002177550843904/discovery" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"description":"A place to talk about the example project.","category_type":4,"primary_language":"en-US","custom_tags":["open source","rust"]}'

Keşif başvurusunu düzenle¶

PATCH /guilds/{guild_id}/discovery

Saklanan kaydı günceller ve güncellenmiş keşif başvurusu nesnesini döndürür. MANAGE_GUILD gerektirir. Durum ve inceleme ayrıntıları korunur.

JSON gövdesi¶

Her alan isteğe bağlıdır; gönderilmeyen alan saklanan değeri korur.

Yanıt¶

Onaylanmış bir kayıttaki değişiklikler arama dizinine gönderilir ve bir Guild Update gönderilir.

Hız sınırı¶

discovery:apply kovasını paylaşır (kullanıcı ve sunucu başına dakikada 5 istek).

Keşif başvurusunu geri çek¶

DELETE /guilds/{guild_id}/discovery

Bir sunucunun başvuru kaydını siler ve boş gövdeyle 204 döndürür. MANAGE_GUILD gerektirir.

Yanıt¶

Yan etkiler¶

approved durumundaki bir başvuruyu geri çekmek DISCOVERABLE sunucu özelliğini de kaldırır. Sunucu yeniden dizinlenir ve bir Guild Update gönderilir. Mevcut üyeler etkilenmez.

Hız sınırı¶

discovery:apply kovasını paylaşır (kullanıcı ve sunucu başına dakikada 5 istek).