📡 API Publique

Accède aux données Agora Retake via notre API REST

Informations générales

Base URLhttps://agora-retake.fr/api/v1/
FormatJSON
AuthentificationOptionnelle — clé API via header X-API-Key ou query ?api_key=
Rate limit (sans clé)60 requêtes / minute par IP
Rate limit (avec clé)Jusqu'à 300 req/min (configurable)

Format de réponse

{
  "status": "ok",
  "data": { ... },
  "meta": {
    "timestamp": "2026-04-10T14:30:00+02:00",
    "rate_limit": {
      "remaining": 58,
      "limit": 60
    }
  }
}

En cas d'erreur : "status": "error" + champ "error" avec un message descriptif.

Endpoints

GET /api/v1/players.php?steamid={STEAM_ID}

Récupère les statistiques publiques d'un joueur.

Paramètres

ParamTypeRequisDescription
steamidstringOuiSteamID64 du joueur (ex: 76561198012345678)

Réponse

{
  "status": "ok",
  "data": {
    "name": "PlayerName",
    "steamid": "76561198012345678",
    "kills": 1234,
    "deaths": 567,
    "kd": 2.18,
    "headshots": 456,
    "hs_rate": 36.95,
    "rounds": 890,
    "playtime_hours": 42.5,
    "last_seen": "2026-04-10 18:30:00"
  }
}
GET /api/v1/leaderboard.php

Récupère le classement des joueurs.

Paramètres

ParamTypeRequisDescription
limitintNonNombre de résultats (1–100, défaut : 20)
sortstringNonkills | kd | headshots | rounds (défaut : kills)

Réponse

{
  "status": "ok",
  "data": [
    { "rank": 1, "name": "TopPlayer", "steamid": "765...", "kills": 5000, "deaths": 2000, "kd": 2.50, "headshots": 1800 },
    ...
  ]
}
GET /api/v1/server.php

Statut actuel du serveur Agora Retake.

Réponse

{
  "status": "ok",
  "data": {
    "status": "online",
    "player_count": 8,
    "max_players": 12,
    "map": "de_dust2",
    "name": "Agora Retake FR"
  }
}
GET /api/v1/stats.php

Statistiques agrégées de la communauté.

Réponse

{
  "status": "ok",
  "data": {
    "total_players": 342,
    "total_kills": 128456,
    "total_deaths": 98712,
    "avg_kd": 1.30,
    "total_rounds": 45000,
    "total_playtime_hours": 5200
  }
}

Codes d'erreur

Code HTTPSignification
400Paramètre manquant ou invalide
404Ressource non trouvée (joueur, etc.)
429Rate limit dépassé — réessayez dans 60 secondes
500Erreur interne du serveur

Obtenir une clé API

Pour des limites de requêtes plus élevées, contactez-nous sur Discord ou par email à contact@agora-retake.fr.