Bienvenue sur la documentation du site Wonderbotlist.com !
L'API Wonderbotlist.com vous permet, d'une part, d'afficher sur notre site le nombre de serveurs et de shards que possède votre bot, et d'une autre part, d'avoir accès aux informations relatives à votre application et à votre propre profil.
Si vous avez besoin d'aide pour accéder à l'API Wonderbotlist.com, n'hésitez pas à en discuter dans notre serveur Discord.
Si vous recevez une réponse 503
de la part de notre serveur, cela signifie que nous avons atteint un pic inattendu du trafic d'accès à l'API et que nous serons généralement opérationnels dans les 5 prochaines minutes. Si la panne persiste ou si vous recevez une autre forme d'erreur 5XX
, veuillez nous en informer via le serveur Discord.
Pour plus d'informations sur les conditions d'utilisation et la confidentialité des API, reportez-vous à notre document de politique à l'adresse https://wonderbotlist.com/fr/tos.
Une clé API est requise pour chaque demande à l'API Wonderbotlist.com, sous la forme d'une en-tête de demande (header) X_TOKEN_DBLFR
ou api_key
Si vous ne possédez pas de Clé API, vous pouvez en obtenir une en postant votre bot sur le site Wonderbotlist.com.
Si votre clé API est manquante, mal formée ou non valide, vous recevrez un code réponse 401 Unauthorised
et la réponse JSON suvante :
{
"status": 401,
"message": "La Clé API est manquant. Vous devez posseder une clé api pour envoyer une demande."
}
Toute demande qui contient la Clé API X_TOKEN_DBLFR
ou api_key
dans le header sera acceptée.
La clé API envoyer dans le header à une priorité plus élevée si vous l'envoyez en utilisant à la fois le header et en paramètre de requête (query).
Les limites de taux d'accès à l'API sont appliquées par clé, IP et par temps. L'accès à l'API à l'aide d'une clé est limité (voir le tableau ci dessous)
De plus, chaque réponse de l'API est accompagnée de l'ensemble d'en-têtes suivants (headers) pour identifier le statut de votre consommation
Route | Requêtes autorisées par heure | Punition si dépassée |
---|---|---|
/v1/bots/* |
500 | Bloqué 1 heure |
/v1/user/* |
400 | Bloqué 1 heure |
Header | Description |
---|---|
X-RateLimit-Limit |
Le nombre maximum de demandes que l'utilisateur est autorisé à faire par minute. |
X-RateLimit-Remaining |
Le nombre de requêtes restant avant d'arriver au ratelimit |
X-RateLimit-Reset |
Heure à laquelle la limite est réinitialisée en secondes UTC |
Une fois la limite atteinte (rate limit), vous recevrez une réponse similaire au JSON suivant, avec un code de statut 429 Too Many Requests
You have exceeded the rate limit, you are banned for 1 hour
Accédez au contenu d'un bot via son identifiant (id
)
shards
)serveur
){
"status": 200,
"message": "Les stats du bots on bien été mis à jour"
}
{
"status": 400,
"message": "Aucun paramètre trouvé en paramètres ou n'est valide"
}
{
"id": 337997289484451840,
"username": "Celestia",
"owner": "193090359700619264",
"owners": [
"359767845762236436",
"160868823887511552"
],
"github": null,
"descriptcourt": "Bot de modération et de fun",
"descriptlong": "yolo je get les infos",
"descriptvideo": null,
"approuved": false,
"lib": "discord.js",
"prefix": "!",
"invitelink": "https://b.wonderbotlist.com/invite/337997289484451840",
"supportserver": null,
"siteweb": null,
"shards": 0,
"server": 0,
"vote": 0,
"avatar": "https://cdn.discordapp.com/avatars/337997289484451840/8a9696c309c80a73c02efb74e0a72862.png?size=256",
"langue": [],
"tags": [],
"changelog": [],
"date": {
"date": "2019-04-22 00:41:31.000000",
"timezone_type": 3,
"timezone": "Europe/Berlin"
},
"botstatus": "online",
"status": 200
}
Accédez au contenu d'un utilisateur via son identifiant ( id
)
{
"id": 193090359700619264,
"username": "Ten-No-Kami-Sama7777",
"bio": "",
"website": null,
"facebook": null,
"github": null,
"twitter": null,
"youtube": null,
"linkedin": null,
"avatar": "https://cdn.discordapp.com/avatars/193090359700619264/1575890721026ce092188702dd69ccd3.png?size=256",
"isProfilPublic": true,
"langue": "fr",
"roles": [
"ROLE_ADMIN",
"ROLE_USER"
],
"nitro": true
}