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. Contactez-nous ou rejoignez notre serveur Discord en cas de besoin.