Classement

Renvoie le classement d'un serveur, avec le rang déjà calculé.

Résultat mis en cache 30 secondes.

GET /api/coinsbot/users/top

---

🔧 Paramètres

Paramètre	Requis	Défaut	Description
GuildId	✅	—	ID du serveur
apiKey	✅	—	Clé API du serveur
sortBy	❌	total	Critère de classement — voir /users/all
order	❌	desc	desc (défaut) ou asc
limit	❌	10	Nombre de joueurs (max 100)

---

💡 Exemple

Top 5 par coins en banque :

GET /api/coinsbot/users/top?GuildId=123&apiKey=CLE&sortBy=bank&limit=5

---

✅ Réponse 200

{
  "GuildId": "123",
  "sortBy": "bank",
  "order": "desc",
  "count": 5,
  "top": [
    { "rank": 1, "UserId": "111", "Coins": 50, "Bank": 99000, "Total": 99050 },
    { "rank": 2, "UserId": "222", "Coins": 10, "Bank": 42000, "Total": 42010 }
  ]
}

---

❌ Erreurs

Code	Cause
400	GuildId manquant, sortBy/order invalide
401	Clé API invalide
500	Erreur interne