marcioos / bgg-client

BoardGameGeek XML API 2 client for Java and Android apps

bgg-client

BoardGameGeek API 2 client for Java and Android apps

Adding the library as a dependency

Gradle

implementation 'com.github.marcioos:bgg-client:1.0'

Maven

<dependency>
    <groupId>com.github.marcioos</groupId>
    <artifactId>bgg-client</artifactId>
    <version>1.0</version>
</dependency>

Javadocs

http://marcioos.github.io/bgg-client/

Using the library

There's a single class called BGG that exposes the 3 main client operations as static methods: search, fetch and fetchCollection.

Search

Use BGG.search for searching items based on a free text search term and an optional list of ThingType (var-arg).

SearchOutput searchResult = BGG.search("dominion", ThingType.BOARDGAME);

SearchOutput contains a list of SearchItem along with summary information on the search result. See SearchOutput and SearchItem.

Fetch

Use BGG.fetch to retrieve more detailed information about specific items, looking up by their BoardGameGeek database IDs, which can be found with the BGG.search method above.

int agricolaXDeckId = 38733;
int dieMacherId = 1;

Collection<FetchItem> item = BGG.fetch(Arrays.asList(agricolaXDeckId, dieMacherId));

FetchItem contains most of the data available on BoardGameGeek related to an item. See FetchItem.

Fetch collection

Use BGG.fetchCollection for retrieving an user's collection by their username on BoardGameGeek.

String username = "marcio_os";

UserCollection myCollection = BGG.fetchCollection(username);

See UserCollection.