🔌 Développeurs

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é

  1. Ouvre le dashboardChoisis ton serveur puis va dans Paramètres.
  2. 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.
  3. 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

GET/v1/guild

Infos du serveur : nom, icône, nombre de membres, membres en ligne et plan.

{ "id": "123…", "name": "Mon serveur", "members": 1520, "online": 312, "plan": "plus" }
GET/v1/stats

Les statistiques du serveur envoyées par le bot (messages, membres actifs…).

{ "stats": { … }, "updated": 1763100000000 }
GET/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 }
GET/v1/leaderboard?type=xp

Le top 50 du serveur. type = xp, coins ou messages.

{ "type": "xp", "top": [ { "id": "456…", "level": 12, "xp": 5400 }, … ] }
POST/v1/messages

Fait 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

Gratuit

30 requêtes par minute.

Hydro Plus 💎

120 requêtes par minute.

Hydro Pro 👑

600 requêtes par minute.

Réponses

Chaque réponse indique x-ratelimit-remaining. Au-delà : code 429 avec retry_after en secondes.

Erreurs possibles

401

Clé manquante ou invalide (supprimée ou régénérée).

403

Le salon n'appartient pas à ton serveur.

404

Route ou membre introuvable.

429

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.