Documentation de l'API Meilleurs Serveurs

Faites évoluer votre page serveur au niveau supérieur avec l'API Meilleurs Serveurs.

Bonjour 👋 ! Bienvenue sur la documentation de l'API Meilleurs Serveurs. Vous êtes sur la version 1.0 de notre API, vouée à amélioration dans le futur.
Cette API est exclusivement réservée aux propriétaires de pages serveurs, elle permet de mettre en relation votre site internet ou autres services avec Meilleurs Serveurs.
L'utilisation d'un Token renseigné dans les paramètres de votre page serveur, rubrique APIs & Services, est nécessaire pour le bon fonctionnement de l'API.


Vérification de vote avec adresse IP

Meilleure méthode. Vérifiez si un utilisateur a bien voté pour votre page serveur dans les deux dernières heures via son adresse IP (IPv4 ou IPv6).
GET https://meilleurs-serveurs.com/api/v1/server/:token/vote/check?ip_address=:ip_address
Content-Type application/json
Exemple PHP
<?php

$apiToken = TOKEN; // Token d'API de votre page serveur
$ipAddress = ADRESSE IP; // Adresse IPv4 ou IPv6 de votre utilisateur
$api = json_decode(@file_get_contents("https://meilleurs-serveurs.com/api/v1/server/".$apiToken."/vote/check?ip_address=".$ipAddress));
if($api->status_code == 200){
// TODO : Action à effectuer lorsque un vote a bien été détecté ces deux dernières heures
echo "L'utilisateur a bien voté ces deux dernières heures.";
}else{
// En cas d'erreur ou de vote non trouvé
echo "Aucun vote n'a été trouvé.";
}

?>
Paramètres
Champ Data Type Type Description
token
string
Obligatoire Token d'API de votre page serveur
ip_address
string
Obligatoire Adresse IP (IPv4 ou IPv6) de l'utilisateur
Exemple de réponse avec succès
200 Success {"status_code":200,"status_message":"The user has successfully submitted a vote in the last 2 hours"}
Exemples de réponses avec erreur
404 ErrorToken {"status_code":404,"status_message":"Server not found"}
404 ErrorVote {"status_code":404,"status_message":"The user has not submitted a vote in the last 2 hours"}
400 BadRequest {"status_code":400,"status_message":"Bad request"}

Vérification de vote avec nom d'utilisateur

Vérifiez si un utilisateur a bien voté pour votre page serveur dans les deux dernières heures via son nom d'utilisateur renseigné dans le champ de vote.
GET https://meilleurs-serveurs.com/api/v1/server/:token/vote/check?username=:username
Content-Type application/json
Exemple PHP
<?php

$apiToken = TOKEN; // Token d'API de votre page serveur
$username = NOM D'UTILISATEUR; // Nom de l'utilisateur
$api = json_decode(@file_get_contents("https://meilleurs-serveurs.com/api/v1/server/".$apiToken."/vote/check?username=".$username));
if($api->status_code == 200){
// TODO : Action à effectuer lorsque un vote a bien été détecté ces deux dernières heures
echo "L'utilisateur a bien voté ces deux dernières heures.";
}else{
// En cas d'erreur ou de vote non trouvé
echo "Aucun vote n'a été trouvé.";
}

?>
Paramètres
Champ Data Type Type Description
token
string
Obligatoire Token d'API de votre page serveur
username
string
Obligatoire Nom de l'utilisateur
Exemple de réponse avec succès
200 Success {"status_code":200,"status_message":"The user has successfully submitted a vote in the last 2 hours"}
Exemples de réponses avec erreur
404 ErrorToken {"status_code":404,"status_message":"Server not found"}
404 ErrorVote {"status_code":404,"status_message":"The user has not submitted a vote in the last 2 hours"}
400 BadRequest {"status_code":400,"status_message":"Bad request"}

Informations générales

API développée et maintenue par Meilleurs Serveurs (https://meilleurs-serveurs.com) et uniquement réservée aux propriétaires de pages serveurs sur le Service.
Les abus d'utilisation de cette API seront sanctionnés. Vous pouvez nous contacter en cas de besoin.