L'API Hydro Bot
Affiche le classement de ton serveur sur ton site, crée un panel pour ton staff ou fais publier des messages par le bot depuis tes propres outils. Une clé par serveur, gratuite.
1. Créer ta clé
- Ouvre le dashboardChoisis ton serveur puis va dans Paramètres.
- Carte « API développeur »Clique sur « Créer une clé ». Elle n'est affichée qu'une seule fois : copie-la et garde-la secrète.
- Utilise-laEnvoie-la dans l'en-tête
Authorization: Bearer hydro_…de chaque requête.
2. Exemple
curl https://hydroworker.bottdiscord.workers.dev/v1/leaderboard?type=xp \ -H "Authorization: Bearer hydro_ta_cle_secrete"
// JavaScript
const r = await fetch("https://hydroworker.bottdiscord.workers.dev/v1/members/123456789012345678", {
headers: { Authorization: "Bearer " + process.env.HYDRO_KEY }
});
console.log(await r.json()); // { level: 12, xp: 5400, coins: 2300, … }
⚠️ Ne mets jamais ta clé dans le code d'une page web visible par tout le monde : utilise-la depuis un serveur (ton backend, un bot, un script). Si elle fuite, régénère-la dans le dashboard.
3. Les routes
Adresse de base : https://hydroworker.bottdiscord.workers.dev
/v1/guildInfos du serveur : nom, icône, nombre de membres, membres en ligne et plan.
{ "id": "123…", "name": "Mon serveur", "members": 1520, "online": 312, "plan": "plus" }/v1/statsLes statistiques du serveur envoyées par le bot (messages, membres actifs…).
{ "stats": { … }, "updated": 1763100000000 }/v1/members/{id}Le niveau, l'XP, l'argent, les messages et les avertissements d'un membre.
{ "id": "456…", "level": 12, "xp": 5400, "coins": 2300, "messages": 870, "warns": 0 }/v1/leaderboard?type=xpLe top 50 du serveur. type = xp, coins ou messages.
{ "type": "xp", "top": [ { "id": "456…", "level": 12, "xp": 5400 }, … ] }/v1/messagesFait publier un message par le bot dans un salon de ton serveur (texte et/ou embed).
{ "channelId": "789…", "content": "Bonjour !", "embed": { "title": "Annonce", "description": "…", "color": "#1d6bff" } }4. Limites
30 requêtes par minute.
120 requêtes par minute.
600 requêtes par minute.
Chaque réponse indique x-ratelimit-remaining. Au-delà : code 429 avec retry_after en secondes.
Erreurs possibles
Clé manquante ou invalide (supprimée ou régénérée).
Le salon n'appartient pas à ton serveur.
Route ou membre introuvable.
Trop de requêtes : attends un peu.

Besoin de plus de requêtes ?
Avec Hydro Pro, ton API passe à 600 requêtes par minute, et tu as ton propre bot.