Retour à l'annuaire

API publique — Bot List

API en lecture seule pour la bot list Discord de french.gg. Authentification par clé API (Authorization: Bearer <token>), créée en self-service depuis le dashboard développeur. Chaque clé porte des permissions explicites choisies à sa création. Une clé absente, inconnue, révoquée ou mal signée renvoie toujours 401.

Rate limit : 60 requêtes/minute par clé. Les widgets ci-dessous sont publics, sans clé, 120 req/min par IP.

Spec OpenAPI brute (YAML)

Endpoints

Recherche et filtre dans l'annuaire des bots publiés.

Permission requise : botlist.bots.read ou botlist.search.read

Paramètres

  • q(query)Recherche texte (100 caractères max)
  • tag(query)Slug de tag
  • certified(query)true/false
  • sort(query)votes | servers | recent | name (défaut votes)
  • page(query)défaut 1
  • limit(query)1 à 48, défaut 24

Réponse

{ data: Bot[], pagination: { page, per_page, total, total_pages } }