Aller au contenu

Utiliser l’API

L’API est gratuite et en lecture seule. Pas de clé, pas d’inscription. Toutes les réponses sont en JSON.

curl https://api.thebgdb.org/v1/search?q=azul

Description OpenAPI

La description complète, lisible par une machine, de chaque route, de chaque paramètre et de chaque réponse est publiée avec chaque version à l’adresse api.thebgdb.org/v1/openapi.json. Chargez-la dans n’importe quel outil OpenAPI pour parcourir l’API ou générer un client. Elle couvre aussi les comptes, les photos et les listes.

La même description se lit aussi comme une page : la référence de l’API.

Les principales requêtes

RequêteRenvoie
GET /v1/search?q=catanLes jeux dont le nom contient tous les mots de q. Ignore la casse et les accents ; ne corrige pas les fautes de frappe. q doit compter au moins deux caractères.
GET /v1/games/{id}Un jeu, par l’id que porte chaque objet jeu : description, joueurs, durée, crédits et photos.
GET /v1/games?limit=50Le catalogue, une page à la fois. Passez le nextCursor reçu dans cursor pour obtenir la page suivante.
GET /v1/healthSi l’API fonctionne.

Connecter un assistant IA (MCP)

Les assistants qui parlent le Model Context Protocol peuvent utiliser le catalogue directement. Ajoutez l’adresse de ce serveur à votre assistant :

https://mcp.thebgdb.org/mcp

Aucune connexion n’est nécessaire. Pour qu’un assistant puisse voir et modifier vos listes, utilisez plutôt https://mcp.thebgdb.org/member : il vous demande d’abord de vous connecter et de donner votre accord. Un jeton d’API créé sur la page de votre compte fonctionne aussi avec la première adresse.

Limites

Sans jeton : 300 requêtes par minute et par adresse. Avec un jeton d’API créé sur la page de votre compte : 1 200 par minute, ou 6 000 avec la formule payante. Au-delà de la limite, l’API répond 429 ; attendez une minute et reprenez. Les réponses sont gardées en cache jusqu’à cinq minutes : un changement peut donc mettre ce temps à apparaître.