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=azulDescrizione 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
| Richiesta | Restituisce |
|---|---|
GET /v1/search?q=catan | I 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=50 | Il catalogo, una pagina alla volta. Passa il nextCursor che hai ricevuto come cursor per avere la pagina successiva. |
GET /v1/health | Se 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/mcpNon 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.