API

Notre API vous permet de récupérer des informations sur votre serveur ainsi que les informations de votes afin de les exploiter sur votre site internet.

ID de votre serveur :

Pour connaître votre ID, référez-vous au lien de vote qui vous a été donné lors de votre inscription,
exemple : https://www.serveurs-minecraft.org/vote.php?id=XX où XX est votre ID.


Chaque API peut retourner son résultat sous 4 formats :
- texte: la valeur est retournée sous forme de texte simple (utile pour inclure la valeur dans un script)
- json: la valeur est retournée sous forme de code json (permet de l'inclure dans un script php par exemple)
- ajax: la valeur est retournée au format json et peut être lue depuis un script javascript (en ajax par exemple)
- jsonp: permet d'utiliser l'API en javascript depuis votre site, sans restriction XSS.

Il est possible de choisir le format de retour de l'api en ajoutant le paramètre "format" avec une des valeurs suivantes : text, json, ajax, jsonp.

Etat du serveur

Nombre de joueurs

Nombre de slots

Version

Icone

Présentation du serveur (MOTD)

Toutes les infos

Nombre de votes

Vérifier un vote

Quota et Limitation: Afin de ne pas saturer nos serveurs vous devez vous limiter à une moyenne de 1 requête par seconde. En cas de dépassement de ce quota votre IP sera automatiquement bloqué (blacklist) pendant une durée de 24h. Ceci est une moyenne, vous pouvez, si vous le souhaitez, envoyer 50 requetes en 3 secondes a condition de ne plus en envoyer aucune pendant une minute ensuite. Attention malgré tout de ne pas abuser, si vous envoyez 300 requetes en 10 secondes vous seriez quand même blacklisté immédiatement. Pensez donc à mettre en place un système de cache pour éviter tout problème.

Retour au classement des serveurs.