Die API nutzen
Die API ist kostenlos und nur zum Lesen. Es gibt keinen Schlüssel und keine Registrierung. Jede Antwort ist JSON.
curl https://api.thebgdb.org/v1/search?q=azulOpenAPI-Beschreibung
Die vollständige, maschinenlesbare Beschreibung aller Routen, Parameter und Antworten wird mit jeder Version unter api.thebgdb.org/v1/openapi.json veröffentlicht. Lade sie in ein beliebiges OpenAPI-Werkzeug, um die API zu erkunden oder einen Client zu erzeugen. Sie umfasst auch Konten, Fotos und Listen.
Dieselbe Beschreibung gibt es auch als lesbare Seite: die API-Referenz.
Die wichtigsten Anfragen
| Anfrage | Antwort |
|---|---|
GET /v1/search?q=catan | Spiele, deren Name jedes Wort aus q enthält. Groß- und Kleinschreibung und Akzente spielen keine Rolle; Tippfehler werden nicht korrigiert. q braucht mindestens zwei Zeichen. |
GET /v1/games/{id} | Ein Spiel, über die id, die jedes Spielobjekt trägt: Beschreibung, Spielerzahl, Spieldauer, Mitwirkende und Fotos. |
GET /v1/games?limit=50 | Der Katalog, Seite für Seite. Gib den erhaltenen nextCursor als cursor an, um die nächste Seite zu bekommen. |
GET /v1/health | Ob die API erreichbar ist. |
Einen KI-Assistenten verbinden (MCP)
Assistenten, die das Model Context Protocol sprechen, können den Katalog direkt nutzen. Trag diese Serveradresse in deinem Assistenten ein:
https://mcp.thebgdb.org/mcpEine Anmeldung ist nicht nötig. Soll ein Assistent deine Listen sehen und bearbeiten können, nimm stattdessen https://mcp.thebgdb.org/member: Dort meldest du dich zuerst an und stimmst zu. Ein API-Token von deiner Kontoseite funktioniert auch mit der ersten Adresse.
Limits
Ohne Token: 300 Anfragen pro Minute und Adresse. Mit einem API-Token von deiner Kontoseite: 1.200 pro Minute, im bezahlten Tarif 6.000. Über dem Limit antwortet die API mit 429; warte eine Minute und mach dann weiter. Antworten werden bis zu fünf Minuten zwischengespeichert, eine Änderung kann also so lange brauchen, bis sie sichtbar ist.