API publique — Servix

API publique Servix

Accédez aux données publiques de Servix en JSON : serveurs, statistiques, catégories, tags et classement mensuel.

Démarrage rapide

Aucune authentification n'est nécessaire pour lire les données publiques. Sans clé, la limite est de 60 requêtes par minute et par IP.

curl https://servix.botix.fr/api/v1/servers?limit=5

Besoin d'un quota plus élevé pour un projet ? Demandez une clé d'API à l'équipe Servix via le formulaire de contact. Elle s'utilise ainsi :

curl -H "Authorization: Bearer svx_pub_xxxxxxxx" \
     https://servix.botix.fr/api/v1/servers

Endpoints

Endpoint	Description
GET /api/v1/stats	Statistiques globales de la plateforme.
GET /api/v1/servers	Liste paginée des serveurs approuvés.
GET /api/v1/server/{id}	Fiche d'un serveur — accepte l'ID Servix, l'ID de guilde Discord ou le slug.
GET /api/v1/categories	Catégories avec le nombre de serveurs.
GET /api/v1/tags	Tags les plus utilisés.
GET /api/v1/leaderboard	Classement des votes (mois en cours ou `?period=YYYY-MM`).

Paramètres de `/api/v1/servers`

pageNuméro de page (défaut 1)

limitRésultats par page, 1 à 50 (défaut 20)

sortbump · votes · top · members · new · popular

qRecherche textuelle

categorySlug de catégorie (ex. gaming)

tagSlug de tag

languageCode langue (fr, en, es…)

Exemple de réponse

{
  "ok": true,
  "data": [
    {
      "id": 42,
      "guild_id": "123456789012345678",
      "slug": "ma-communaute",
      "name": "Ma Communauté",
      "summary": "Un serveur francophone chaleureux.",
      "icon_url": "https://cdn.discordapp.com/icons/...",
      "invite_url": "https://discord.gg/xxxxxxx",
      "category": "Communauté",
      "tags": ["francais", "chill"],
      "language": "fr",
      "member_count": 1240,
      "votes": { "total": 312, "month": 48 },
      "bumps_total": 96,
      "last_bump_at": "2026-08-16 14:02:11",
      "bot_present": true,
      "url": "https://servix.botix.fr/server/ma-communaute"
    }
  ],
  "meta": { "page": 1, "per_page": 20, "total": 137, "total_pages": 7 }
}

Limites et codes d'erreur

Chaque réponse expose les en-têtes X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset.

401Clé d'API invalide ou révoquée

404Ressource introuvable ou non publique

422Paramètre invalide

429Quota dépassé — voir Retry-After

503API désactivée ou maintenance