Documentation développeur

{
  "ok": true,
  "hasVoted": true,
  "username": "Notch",
  "votedAt": "2026-07-16T14:30:00+00:00"
}

{
  "ok": true,
  "hasVoted": false,
  "username": "Notch"
}

{ "ok": false, "message": "Missing required param: server (server slug)." }

{ "ok": false, "message": "Invalid username format. Must be 3–16 characters: letters, digits, underscore." }

{ "ok": false, "message": "Server not found: mon-serveur-survie" }

{ "ok": false, "message": "Only GET is supported." }

{ "ok": false, "message": "Internal server error." }

curl "https://liste-serveurs.fr/api_vote_check.php?server=mon-serveur-survie&username=Notch"

async function verifierVote(serverSlug, username) {
  const url = new URL('https://liste-serveurs.fr/api_vote_check.php');
  url.searchParams.set('server', serverSlug);
  url.searchParams.set('username', username);

  const response = await fetch(url);
  const data = await response.json();

  if (!data.ok) {
    throw new Error(data.message);
  }

  return data; // { hasVoted: boolean, username: string, votedAt?: string }
}

// Utilisation
const result = await verifierVote('mon-serveur-survie', 'Notch');

if (result.hasVoted) {
  console.log(`${result.username} a voté le ${result.votedAt}`);
} else {
  console.log(`${result.username} n'a pas encore voté.`);
}

import java.net.URI;
import java.net.URLEncoder;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.nio.charset.StandardCharsets;
import java.time.Duration;
import java.util.concurrent.CompletableFuture;

public class VoteChecker {

    private static final String API_URL =
        "https://liste-serveurs.fr/api_vote_check.php";

    private final HttpClient client = HttpClient.newBuilder()
        .connectTimeout(Duration.ofSeconds(5))
        .build();

    /**
     * Retourne true si le joueur a voté pour ce serveur
     * dans les 3 dernières heures. Retourne false en cas d'erreur (fail-safe).
     */
    public CompletableFuture<Boolean> aVote(String username, String serverSlug) {
        return CompletableFuture.supplyAsync(() -> {
            try {
                String u = URLEncoder.encode(username,   StandardCharsets.UTF_8);
                String s = URLEncoder.encode(serverSlug, StandardCharsets.UTF_8);

                HttpRequest request = HttpRequest.newBuilder()
                    .uri(URI.create(API_URL + "?server=" + s + "&username=" + u))
                    .GET()
                    .timeout(Duration.ofSeconds(5))
                    .build();

                HttpResponse<String> response =
                    client.send(request, HttpResponse.BodyHandlers.ofString());

                // Désérialiser avec Gson, Jackson, ou toute autre bibliothèque JSON.
                // Exemple avec Gson :
                //   JsonObject json = JsonParser.parseString(response.body()).getAsJsonObject();
                //   return json.get("ok").getAsBoolean()
                //       && json.get("hasVoted").getAsBoolean();

                return response.statusCode() == 200
                    && response.body().contains("\"hasVoted\":true");

            } catch (Exception e) {
                getLogger().warning("[VoteChecker] Erreur : " + e.getMessage());
                return false; // fail-safe — ne jamais bloquer le joueur
            }
        });
    }
}

// --- Utilisation dans un CommandExecutor ---
voteChecker.aVote(player.getName(), "mon-serveur-survie")
    .thenAccept(vote -> {
        Bukkit.getScheduler().runTask(plugin, () -> {
            if (vote) {
                attribuerRecompense(player);
                player.sendMessage("§aMerci pour votre vote ! Récompense accordée.");
            } else {
                player.sendMessage("§cAucun vote trouvé. Votez sur liste-serveurs.fr et réessayez.");
            }
        });
    });

const SERVER_SLUG = 'mon-serveur-survie';
const votesRecompenses = new Set(); // évite les doublons

async function verifierEtRecompenser(joueursConnectes) {
  for (const pseudo of joueursConnectes) {
    try {
      const url = 'https://liste-serveurs.fr/api_vote_check.php'
                + '?server=' + encodeURIComponent(SERVER_SLUG)
                + '&username=' + encodeURIComponent(pseudo);

      const res  = await fetch(url);
      const data = await res.json();

      if (data.ok && data.hasVoted) {
        // Clé unique : pseudo + horodatage du vote
        const cle = `${pseudo}:${data.votedAt}`;
        if (!votesRecompenses.has(cle)) {
          votesRecompenses.add(cle);
          await attribuerRecompense(pseudo);
        }
      }
    } catch (err) {
      console.error(`[Vote] Erreur pour ${pseudo} :`, err.message);
    }
  }
}