Sunucu üyesi arama¶

Üye arama, bir sunucunun üyelerini ada, role, katılma zamanına ve hesap türüne göre filtreler, sıralar ve sayfalar. Sunucu ayarlarındaki Üyeler sayfası bu özelliği kullanır. Her eşleşme bir sunucu üyesi arama sonucudur.

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.

Katılma kaynağı türleri¶

Arama sonucu ve join_source_type filtresi bu değerleri kullanır.

Sunucu üyesi arama sonucu nesnesi¶

Eşleşen bir üyelik. Hesap alanları user altında değil, en üst düzeydedir.

{
  "id": "1489002177550843904:1489002177550843906",
  "guild_id": "1489002177550843904",
  "user_id": "1489002177550843906",
  "username": "ada",
  "discriminator": "0042",
  "global_name": "Ada",
  "nickname": null,
  "role_ids": ["1489002177550843910"],
  "joined_at": 1755158400,
  "supplemental": {"join_source_type": null, "source_invite_code": "a1b2c3d4", "inviter_id": "1489002177550843905"},
  "is_bot": false
}

Sonuçta avatar, zaman aşımı veya ses alanları yoktur. Üyeliğin tamamı için Sunucu üyesini al kullanılır.

Sunucu üyesi arama ek bilgi nesnesi¶

Çağıran sunucu sahibi değilse veya MANAGE_GUILD (ya da ADMINISTRATOR) iznine sahip değilse her alan null olur. Bu nedenle null bir değer, verinin var olup olmadığını göstermez.

Sunucu üyesi arama yanıt nesnesi¶

Sunucu üyelerini ara¶

POST /guilds/{guild_id}/members-search

Bir sunucu üyesi arama yanıtı döndürür. Çağıran üye olmalı; ayrıca sahip olmalı ya da MANAGE_GUILD, MANAGE_ROLES, MANAGE_NICKNAMES, BAN_MEMBERS, MODERATE_MEMBERS, KICK_MEMBERS veya ADMINISTRATOR izinlerinden en az birine sahip olmalıdır.

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

JSON gövdesi¶

Her alan isteğe bağlıdır; boş bir {} nesnesi tüm üyelerin ilk sayfasını döndürür.

Metin eşleştirme. Arama motoru olmadan query; üyenin takma adı, görünen adı veya kullanıcı adıyla eşleşir (büyük/küçük harfe duyarsız: önce tam eşleşme, sonra önek, sonra alt dize) ya da kullanıcı kimliğine birebir eşittir. Motor varken hangi üyelerin hangi sırayla eşleşeceğine motor karar verir; yukarıdaki filtreler motorun eşleşmelerine yine uygulanır.

Sıralama. query verilip sort_by verilmediğinde ya da sort_by değeri relevance olduğunda sonuçlar önce alakaya, ardından katılma zamanına göre sıralanır. Aksi halde katılma zamanına göre en eskiden başlayarak ya da sort_order desc ile en yeniden başlayarak sıralanır. Eşitlikler kullanıcı kimliğiyle çözülür.

curl -X POST https://tebhos.com/api/v1/guilds/1489002177550843904/members-search \
  -H "Authorization: Bearer $TEBHOS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"query": "ada", "role_ids": ["1489002177550843910"], "limit": 50}'