Votre navigateur ne supporte pas le JavaScript !

Introduction

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.

Support

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.

Conditions d'utilisation

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.

Authentification

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.

Clé API message d'erreur

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."
}
                
            

Utilisation de la clé API comme paramètre de requête

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).

Rate Limits

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

Bots

Accédez au contenu d'un bot via son identifiant (id)

POST STATS

https://api.wonderbotlist.com/v1/bot/:id
HEADERS

Authorization
Authorization_token (Optionnel si api-key ou X-TOKEN-WBL renseigné)
X-TOKEN-DBLFR
Authorization_token (Optionnel si api-key ou X-TOKEN-WBL renseigné)
api-key
Authorization_token (Optionnel si api-key ou X-TOKEN-WBL renseigné)
Content-Type
application/x-www-form-urlencoded
PARAMS

shard
Nombre de shards que le bot possède actuellement (Vous pouvez utiliser shards)
serveurs
Nombre de serveurs que le bot possède actuellement (Vous pouvez utiliser serveur)
STATS OK
{
  "status": 200,
  "message": "Les stats du bots on bien été mis à jour"
}

STATS ERROR
{
  "status": 400,
  "message": "Aucun paramètre trouvé en paramètres ou n'est valide"
}

GET STATS

https://api.wonderbotlist.com/v1/bot/:BOTID
HEADERS

Authorization
Authorization_token (Optionnel si api-key ou X-TOKEN-WBL renseigné)
X-TOKEN-DBLFR
Authorization_token (Optionnel si api-key ou X-TOKEN-WBL renseigné)
api-key
Authorization_token (Optionnel si api-key ou X-TOKEN-WBL renseigné)
Content-Type
application/x-www-form-urlencoded
{
    "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
}
                

Utilisateur

Accédez au contenu d'un utilisateur via son identifiant ( id )

GET STATS

https://api.wonderbotlist.com/v1/user/:USERID
HEADERS

Authorization
Authorization_token (Optionnel si api-key ou X-TOKEN-WBL renseigné)
X-TOKEN-DBLFR
Authorization_token (Optionnel si api-key ou X-TOKEN-WBL renseigné)
api-key
Authorization_token (Optionnel si api-key ou X-TOKEN-WBL renseigné)
Content-Type
application/x-www-form-urlencoded
{
    "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
}