API

Documentation API

L'API est en cours de déploiement et n'est pas encore disponible (ça arrive bientôt)

Intégrez TrouveTonServeur dans vos applications

GET

Vérifier les votes d'un utilisateur

Cet endpoint permet aux propriétaires de serveur de vérifier si un utilisateur spécifique (identifié par son pseudo) a voté pour leur serveur.

Requête

URL

GET https://api.trouvetonserveur.fr/api/votes/verify/{serverId}/{username}

Paramètres

serverId

integer

Requis

L'identifiant unique du serveur

username

string

Requis

Le pseudo de l'utilisateur à vérifier

Authentification

Cette requête nécessite une authentification. Vous devez être le propriétaire du serveur pour accéder à ces informations.

Header

Authorization: Bearer YOUR_API_TOKEN

Réponses

✅ 200 - Succès (l'utilisateur a voté)

JSON

{
  "hasVoted": true,
  "username": "PlayerExample",
  "lastVoteDate": "2025-12-20T10:30:00Z",
  "totalVotes": 42,
  "canVoteAgain": "2025-12-21T10:30:00Z"
}

✅ 200 - Succès (l'utilisateur n'a pas voté)

JSON

{
  "hasVoted": false,
  "username": "PlayerExample"
}

❌ 401 - Non autorisé

JSON

{
  "error": "Unauthorized",
  "message": "Vous devez être le propriétaire du serveur"
}

❌ 404 - Non trouvé

JSON

{
  "error": "Not Found",
  "message": "Serveur ou utilisateur introuvable"
}

Exemples de code

JavaScript / Fetch

JavaScript

const serverId = 123;
const username = 'PlayerExample';

fetch(`https://api.trouvetonserveur.fr/api/votes/verify/${serverId}/${username}`, {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_API_TOKEN'
  }
})
.then(response => response.json())
.then(data => {
  if (data.hasVoted) {
    console.log(`${data.username} a voté! Dernier vote: ${data.lastVoteDate}`);
  } else {
    console.log(`${data.username} n'a pas encore voté.`);
  }
})
.catch(error => console.error('Erreur:', error));

cURL

Bash

curl -X GET \
  https://api.trouvetonserveur.fr/api/votes/verify/123/PlayerExample \
  -H 'Authorization: Bearer YOUR_API_TOKEN'

Python / Requests

Python

import requests

server_id = 123
username = 'PlayerExample'
api_token = 'YOUR_API_TOKEN'

url = f'https://api.trouvetonserveur.fr/api/votes/verify/{server_id}/{username}'
headers = {'Authorization': f'Bearer {api_token}'}

response = requests.get(url, headers=headers)

if response.status_code == 200:
    data = response.json()
    if data['hasVoted']:
        print(f"{data['username']} a voté! Total: {data['totalVotes']}")
    else:
        print(f"{data['username']} n'a pas voté")
else:
    print(f'Erreur {response.status_code}: {response.text}')

Cas d'utilisation

🎁

Récompenses automatiques

Vérifiez si un joueur a voté avant de lui attribuer automatiquement des récompenses en jeu.

📊

Statistiques détaillées

Suivez quels joueurs votent régulièrement pour mieux comprendre votre communauté.

🔍

Vérification manuelle

Vérifiez manuellement le statut de vote d'un joueur en cas de réclamation.

🤖

Bot Discord

Intégrez cette API dans votre bot Discord pour vérifier et récompenser les votants.

⚡ Limitation de débit

Pour garantir un service optimal :

100 requêtes par minute par serveur
1000 requêtes par heure par serveur
Les headers de réponse incluent X-RateLimit-Remaining et X-RateLimit-Reset

💬 Besoin d'aide ?

Si vous rencontrez des problèmes ou avez des questions :

📧 Contactez-nous 💬 Rejoindre Discord