Retour à la documentation

API publique

L'API publique Flitt vous permet d'interroger vos propres serveurs et données de compte en toute sécurité. Disponible sur les offres Premium, Pro Edge et Entreprise.

Base URL

https://api.flitt.me/v1/public-api

Tous les endpoints sont strictement limités à votre compte. Vous ne pouvez pas accéder aux serveurs qui ne vous appartiennent pas.

Authentification

Générez une clé API depuis votre page profil et envoyez-la dans l'en-tête Authorization pour chaque requête.

En-tête Authorization

Authorization: Bearer <API_KEY>

  • Les clés sont affichées une seule fois lors de la génération.
  • La rotation a un délai de 5 minutes et invalide la clé précédente.
  • Ne partagez jamais votre clé API publiquement.

Accès selon l'offre

L'accès à l'API publique est activé pour les offres Premium, Pro Edge et Entreprise.

  • Freemium : pas d'accès API
  • Premium : API v1 activée
  • Pro Edge : API v1 activée (offre SDK uniquement)
  • Enterprise : API v1 activée

Isolation des données

Chaque requête est limitée à votre ID utilisateur côté backend. Les IDs serveurs doivent vous appartenir.

  • L'accès aux données d'autres utilisateurs est bloqué.
  • Les IDs invalides ou étrangers renvoient une réponse 404.
  • Tous les accès sont journalisés pour audit et protection contre les abus.

Limites de requêtes

Les limites de requêtes sont appliquées selon l'offre. L'utilisation restante est indiquée dans les en-têtes de réponse.

X-RateLimit-Limit

Nombre maximum de requêtes par heure pour votre offre.

X-RateLimit-Remaining

Requêtes restantes dans la fenêtre courante.

X-RateLimit-Reset

Horodatage Unix de la réinitialisation du quota.

Endpoints

Tous les endpoints renvoient du JSON. Utilisez la pagination via page et limit pour les réponses de liste.

GET/usage

Utilisation du compte

Retourne les limites d'usage et la consommation sur les 30 derniers jours.

Premium+

{
  "enabled": true,
  "plan": "PREMIUM",
  "limitPerMonth": 50000,
  "usedLast30d": 1240,
  "remaining": 48760,
  "resetAt": "2026-03-05T12:00:00.000Z"
}
GET/servers

Lister les serveurs

Retourne une liste paginée de vos serveurs avec leur statut en direct.

Premium+

page (number)

Numéro de page (défaut : 1).

limit (number)

Éléments par page (max : 100).

{
  "data": [
    {
      "id": "srv_123",
      "game": "FIVEM",
      "name": "My Server",
      "ip": "203.0.113.42",
      "port": 30120,
      "domainName": "play.example.com",
      "status": "ONLINE",
      "playersOnline": 32,
      "maxPlayers": 64,
      "rating": 4.7,
      "reviewsCount": 120,
      "verifiedBadge": true,
      "createdAt": "2025-11-01T10:12:00.000Z"
    }
  ],
  "pagination": {"page": 1, "limit": 25, "total": 1, "pages": 1}
}
GET/servers/:id

Obtenir un serveur

Retourne les métadonnées complètes d'un serveur que vous possédez ou gérez.

Premium+

id (string)required

ID du serveur.

{
  "server": {
    "id": "srv_123",
    "game": "FIVEM",
    "name": "My Server",
    "description": "Serveur RP principal",
    "language": "fr",
    "ip": "203.0.113.42",
    "port": 30120,
    "domainName": "play.example.com",
    "iconUpdatedAt": "2026-02-01T10:00:00.000Z",
    "bannerUpdatedAt": "2026-02-01T10:00:00.000Z",
    "createdAt": "2025-11-01T10:12:00.000Z",
    "bridgeConnectedAt": "2026-02-04T09:10:00.000Z",
    "bridgeLastSeenAt": "2026-02-04T09:12:00.000Z",
    "bridgeLastAddon": "2.4.1",
    "bridgeLastPlayerCount": 32,
    "bridgeLastMaxPlayers": 64,
    "bridgeLastMapName": "Los Santos",
    "bridgeLastGameVersion": "1.0.0",
    "logsEnabled": true,
    "publicEnabled": true,
    "planActive": true,
    "planDisabledReason": null,
    "verifiedBadge": true,
    "rating": 4.7,
    "reviewsCount": 120,
    "status": "ONLINE",
    "accessRole": "OWNER",
    "tags": [
      {
        "id": "tag_1",
        "name": "Roleplay",
        "category": "MODE",
        "reputation": {"score": 92, "usageCount": 150}
      }
    ],
    "links": {
      "youtube": null,
      "twitch": null,
      "x": "https://x.com/server",
      "discord": "https://discord.gg/flitt",
      "website": "https://example.com",
      "instagram": null,
      "tiktok": null,
      "facebook": null
    }
  }
}
GET/servers/:id/players

Lister les joueurs d'un serveur

Retourne les joueurs suivis pour le serveur, avec filtrage par statut.

Premium+

id (string)required

ID du serveur.

page (number)

Numéro de page (défaut : 1).

limit (number)

Éléments par page (max : 50).

status (string)

Filtrer par statut (online, offline, all).

{
  "serverId": "srv_123",
  "players": [
    {
      "playerId": "player_1",
      "externalId": "steam:110000112345678",
      "name": "PlayerOne",
      "isVpn": false,
      "country": "France",
      "countryCode": "FR",
      "isp": "Orange",
      "joinCount": 42,
      "firstJoinedAt": "2025-10-20T10:00:00.000Z",
      "lastJoinedAt": "2026-02-04T08:55:00.000Z",
      "lastSeenAt": "2026-02-04T09:12:00.000Z",
      "lastLeftAt": null,
      "lastSessionSeconds": 3600,
      "totalPlaySeconds": 18000,
      "isOnline": true,
      "sessionStartedAt": "2026-02-04T08:55:00.000Z"
    }
  ],
  "pagination": {"page": 1, "limit": 15, "total": 1, "pages": 1}
}
GET/servers/:id/players/:playerId

Obtenir un joueur

Retourne un joueur par ID interne ou identifiant externe.

Premium+

id (string)required

ID du serveur.

playerId (string)required

ID du joueur ou ID externe (ex : steam).

{
  "serverId": "srv_123",
  "player": {
    "playerId": "player_1",
    "externalId": "steam:110000112345678",
    "name": "PlayerOne",
    "isVpn": false,
    "country": "France",
    "countryCode": "FR",
    "isp": "Orange",
    "joinCount": 42,
    "firstJoinedAt": "2025-10-20T10:00:00.000Z",
    "lastJoinedAt": "2026-02-04T08:55:00.000Z",
    "lastSeenAt": "2026-02-04T09:12:00.000Z",
    "lastLeftAt": null,
    "lastSessionSeconds": 3600,
    "totalPlaySeconds": 18000,
    "isOnline": true,
    "sessionStartedAt": "2026-02-04T08:55:00.000Z"
  }
}

Erreurs courantes

401 · UNAUTHORIZED

Clé API manquante ou invalide.

Envoyez un en-tête Authorization valide.

403 · FORBIDDEN

L'offre ne permet pas l'accès à l'API.

Passez à Premium ou supérieur.

403 · RESTRICTED

Accès à l'API publique désactivé pour non respect des CGU.

Contactez le support si vous pensez qu'il s'agit d'une erreur.

404 · NOT_FOUND

Ressource introuvable.

L'ID serveur ne vous appartient pas.

429 · RATE_LIMITED

Limite de requêtes dépassée.

Attendez la réinitialisation ou changez d'offre.

Exemples

Lister les serveurscurl
curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.flitt.me/v1/servers?page=1&limit=25
Lister les joueurs d'un serveurcurl
curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.flitt.me/v1/servers/srv_123/players?status=online&page=1&limit=15