Vai al contenuto

Usare l'API

L'API è gratuita e di sola lettura. Niente chiave e niente registrazione. Ogni risposta è in JSON.

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

Descrizione OpenAPI

La descrizione completa, leggibile dalle macchine, di ogni rotta, parametro e risposta è pubblicata a ogni rilascio all'indirizzo api.thebgdb.org/v1/openapi.json. Caricala in un qualsiasi strumento OpenAPI per esplorare l'API o generare un client. Copre anche account, foto e liste.

La stessa descrizione si può leggere come pagina: il riferimento dell'API.

Le richieste principali

RichiestaRestituisce
GET /v1/search?q=catanI giochi il cui nome contiene tutte le parole di q. Ignora maiuscole e accenti; non corregge gli errori di battitura. q deve avere almeno due caratteri.
GET /v1/games/{id}Un gioco, tramite l'id presente in ogni oggetto gioco: descrizione, giocatori, durata, crediti e foto.
GET /v1/games?limit=50Il catalogo, una pagina alla volta. Passa il nextCursor che hai ricevuto come cursor per avere la pagina successiva.
GET /v1/healthSe l'API è attiva.

Collegare un assistente AI (MCP)

Gli assistenti che parlano il Model Context Protocol possono usare il catalogo direttamente. Aggiungi al tuo assistente l'indirizzo di questo server:

https://mcp.thebgdb.org/mcp

Non richiede l'accesso. Per permettere a un assistente di vedere e modificare le tue liste, usa invece https://mcp.thebgdb.org/member: prima ti chiede di accedere e di dare il consenso. Sul primo indirizzo funziona anche un token API creato dalla pagina del tuo account.

Limiti

Senza token: 300 richieste al minuto per indirizzo. Con un token API creato dalla pagina del tuo account: 1200 al minuto, oppure 6000 con il piano a pagamento. Oltre il limite l'API risponde 429; aspetta un minuto e riprendi. Le risposte restano in cache fino a cinque minuti, quindi una modifica può metterci altrettanto a comparire.