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 |
|
|
Obligatoire | Token d'API de votre page serveur |
|
|
Obligatoire | Adresse IP (IPv4 ou IPv6) de l'utilisateur |
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 |
|
|
Obligatoire | Token d'API de votre page serveur |
|
|
Obligatoire | Nom de l'utilisateur |
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
Les abus d'utilisation de cette API seront sanctionnés. Contactez-nous ou rejoignez notre serveur Discord en cas de besoin.