Afficher la liste des top voteurs sur votre site (API)

Grâce à l’API officielle de Serveur Privé, vous pouvez afficher en temps réel le classement des utilisateurs ayant le plus voté pour votre serveur. Un excellent moyen de récompenser les plus fidèles de votre communauté et de stimuler l'engagement !

🔐 Où trouver votre token API ?

Pour accéder à l’API, vous devez posséder un serveur inscrit sur Serveur Privé. Voici comment obtenir votre clé d’accès :

1. Connectez-vous à votre compte sur serveur-prive.net.
2. Dans le menu de gauche, cliquez sur “Serveurs”.
3. À droite de votre serveur, cliquez sur “Paramètres”.
4. Faites défiler jusqu’à la section “Clé API” et copiez le Token.

Important : l’API impose une limite de requêtes par token. Il est donc vivement conseillé d’utiliser un système de cache (fichier temporaire, base de données, mémoire) pour ne pas envoyer une requête à chaque chargement de page.

Dans notre exemple, nous utilisons un système de cache basé sur un fichier texte, qui se mettra à jour automatiquement toutes les 5 minutes.

💻 Exemple de code PHP avec tableau HTML

<?php
$server_token = "VOTRE_TOKEN_ICI";
$cache_file = 'cache_voteurs.json';
$cache_duration = 300; // 5 minutes

// Vérifier si le cache est valide
if (file_exists($cache_file) && time() - filemtime($cache_file) < $cache_duration) {
    $json = file_get_contents($cache_file);
} else {
    $json = file_get_contents("https://serveur-prive.net/api/v1/servers/$server_token/voters");
    file_put_contents($cache_file, $json); // enregistrer le cache
}

$json_data = json_decode($json);

if ($json_data->success) {
    echo '<div class="table-wrapper">';
    echo '<table border="1" cellpadding="10" cellspacing="0" style="border-collapse: collapse; width: 100%;">';
    echo '<thead><tr style="background-color: #f2f2f2;">
            <th>Avatar</th>
            <th>Pseudo</th>
            <th>Votes</th>
            <th>Profil public</th>
          </tr></thead><tbody>';
    foreach ($json_data->data as $data) {
        echo '<tr>';
        echo '<td><img src="' . $data->avatar . '" alt="avatar" width="32" height="32" style="border-radius: 50%;"></td>';
        echo '<td>' . htmlspecialchars($data->username) . '</td>';
        echo '<td>' . $data->votes . '</td>';
        echo '<td><a href="' . $data->public_profile . '" target="_blank" rel="noopener">Voir le profil</a></td>';
        echo '</tr>';
    }
    echo '</tbody></table>';
    echo '</div>';
} else {
    echo '<p style="color: red;">Erreur : le token API est invalide ou le serveur est introuvable.</p>';
}
?>

📋 Exemple de rendu du tableau

Avatar	Pseudo	Votes	Profil public
	TrevorRP	42	Voir le profil
	LunaQueen	38	Voir le profil
	PixelNico	35	Voir le profil
	DarkWolf	30	Voir le profil
	RP_Master	27	Voir le profil

📚 Aller plus loin avec l'API Serveur Privé

La documentation complète de l’API est disponible ici : serveur-prive.net/documentation.

En plus du classement des voteurs, d'autres points d'accès API sont disponibles pour aller plus loin :

• ✅ Vérification de vote : pour savoir si un joueur a voté
• 📈 Statistiques du serveur : nombre de votes, abonnés, vues, etc.
• 💎 Liste des donateurs : pour afficher les utilisateurs ayant soutenu votre serveur
• ⭐ Utilisateurs abonnés : permet d’identifier les abonnés actifs depuis la page de vote

Ces APIs vous permettent de créer des systèmes personnalisés de récompenses, de badges ou d’intégrations avec Discord ou votre site web.

Rendez-vous sur la documentation officielle pour découvrir toutes les possibilités !