Documentation API

Base URL : https://serveur-minecraft.fr/api

Authentification

Les endpoints protégés nécessitent un token API propre à chaque serveur.

Passe le token via le header Authorization: Bearer {TOKEN} ou en paramètre de body token.

Le token est disponible dans la page d'édition de ton serveur.

GET /server/{slug} Public

Retourne les informations publiques d'un serveur.

Paramètres de route

Nom	Type	Description
slug	string	Slug unique du serveur

Exemple de réponse 200

{
  "id": "019e37d1-...",
  "name": "My Server",
  "slug": "my-server",
  "ip": "play.example.com",
  "port": 25565,
  "is_online": true,
  "description": "...",
  "country": "FR"
}

GET /server/ping Public

Ping un serveur Minecraft et retourne son statut en temps réel.

Paramètres query

Nom	Type	Requis	Description
ip	string	Oui	IP ou hostname du serveur
port	integer	Non	Port (défaut : 25565)

Réponse 200 — En ligne

{
  "success": true,
  "server": {
    "motd": "Welcome!",
    "players": {
      "online": 12,
      "max": 100
    },
    "version": "1.21"
  }
}

Réponse 200 — Hors ligne

{
  "success": false,
  "message": "We weren't able to
connect to your server."
}

POST /server/{slug}/has-voted/ip Authentifié

Vérifie si une IP a voté pour un serveur dans les 2 dernières heures. Utile pour récompenser les joueurs depuis ton plugin Minecraft.

Body JSON

Nom	Type	Requis	Description
ip	string	Oui	IP du joueur à vérifier
token	string	Si pas de header	Token API du serveur

Exemple de requête

POST /api/server/my-server/has-voted/ip
Authorization: Bearer {TOKEN}
Content-Type: application/json

{
  "ip": "1.2.3.4"
}

Réponse 200 — A voté

{
  "has_voted": true,
  "voted_at": "2026-05-18T14:00:00+00:00",
  "next_vote_at": "2026-05-18T16:00:00+00:00"
}

Réponse 200 — N'a pas voté

{
  "has_voted": false,
  "voted_at": null,
  "next_vote_at": null
}

Erreurs

401Token manquant ou invalide

422Paramètre ip manquant

Notes

Toutes les réponses sont en JSON.
Un vote est valide pendant 2 heures — après ce délai le joueur peut revoter.
Le token API est disponible dans la page d'édition de chaque serveur.