API Publique

Utilisez cet endpoint pour vérifier quand un joueur a voté pour votre serveur pour la dernière fois et quand il pourra voter de nouveau.

Ajouter un serveur

Endpoint

Faire une simple GET request:

GET https://api.top-servers-hytale.com/api/v1/votes/<serverId>/<username>

Paramètres

<serverId>L'identifiant unique de votre serveur sur notre site.
<username>Le nom en jeu du joueur.

Quota

60 requêtes/minute par IP

Exemple de requête

Requête

GET https://api.top-servers-hytale.com/api/v1/votes/qiGVkdcdeixVR7hWwW4P9K/jhonDoe

Réponse

{
  "lastVoteAt":1768296330,
  "nextVoteAt":1768299930,
  "canVote":true,
  "totalVotes":42
}

Les timestamps sont retournés en timestamps Unix en secondes.

Idée d'utilisation

Vous pouvez appeler cet endpoint depuis votre plugin ou script pour vérifier si un joueur peut à nouveau recevoir une récompense de vote. Si l'heure actuelle est ≥ nextVoteAt, le joueur peut voter et obtenir une récompense.