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.
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"
}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}
}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
}
}
}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}
}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
curl -H "Authorization: Bearer YOUR_API_KEY" \
https://api.flitt.me/v1/servers?page=1&limit=25curl -H "Authorization: Bearer YOUR_API_KEY" \
https://api.flitt.me/v1/servers/srv_123/players?status=online&page=1&limit=15