N'oluyo · Geliştirici Dokümanları · Son güncelleme: · https://noluyo.net/gelistirici

Keşfet (Bot rehberi)

Doğrulanmış ve listelenmiş botların herkese açık rehberi.

Keşfet (Bot rehberi)

Doğrulanmış ve listelenmiş botların herkese açık rehberi.

Rehberdeki doğrulanmış botları listele (listDirectoryBots)

GET https://noluyo.net/api/v1/discovery/bots (GET /discovery/bots)

Bot rehberindeki doğrulanmış herkese açık botları sunucu sayısına göre sıralayarak listeler (sayfa başına 24, offset en çok 960). Bot platformu kapalıyken boş liste döner.

  • Kimlik: Herkese açık (Authorization başlığı gerekmez)

Parametreler

AdKonumTürZorunluAçıklama
categoryquerystring-Bot kategorisine göre süz. (moderation, music, games, utility, fun, social, other)
qquerystring-Bot adına ya da açıklamasına göre ara. (<= 64)
offsetqueryinteger-Sonuç kaydırma değeri (0..960). (0–960 · = 0)

Örnek çağrılar

curl "https://noluyo.net/api/v1/discovery/bots?category=moderation"
// JavaScript (noluyo-bot)
await bot.rest.listDirectoryBots({ category: "moderation" });
# Python (noluyo_bot)
await bot.rest.list_directory_bots({"category": "moderation"})

Yanıt (200)

{
  "bots": [
    {
      "id": "21879167385600004",
      "bot_user_id": "21879171579904005",
      "name": "Kalkan Bot",
      "description": "Sunucu moderasyonu ve hızlı anket botu.",
      "listing_text": "Küfür süzgeci, zaman aşımı ve butonlu anketler.",
      "avatar": "a1b2c3d4",
      "category": "moderation",
      "guild_count": 142,
      "verified": true,
      "install_permissions": "68608",
      "support_url": "https://ornek.com/destek",
      "website_url": "https://ornek.com",
      "privacy_url": "https://ornek.com/gizlilik"
    }
  ],
  "total": 1,
  "has_more": false
}

Hata kodları

  • HTTP 400: validation_failed, invalid_body, intent_approval_required, endpoint_not_allowed, endpoint_unreachable, endpoint_bad_response, endpoint_no_signature_check
  • HTTP 429: rate_limited
  • HTTP 503: maintenance