Magic: The Gathering Java SDK
Java SDK for using the magicthegathering.io APIs.
Note that API use is free and does not require authentication or registration, but some rate limits apply. Read the official API website for more information.
Add the dependency to your project and you're good to go! If you are on Android make sure you call on a seperate thread than the main.
- Java JDK 7 or higher
<dependency> <groupId>io.magicthegathering</groupId> <artifactId>javasdk</artifactId> <version>0.0.18</version> </dependency>
<dependency org="io.magicthegathering" name="javasdk" rev="0.0.18"/>
Get a Card
int multiverseId = 1; Card card = CardAPI.getCard(multiverseId);
Get all Cards
List<Card> cards = CardAPI.getAllCards();
Get a Set
String setCode = "KLD"; MtgSet set = SetAPI.getSet(setCode);
Get all Sets
This does not populate the card lists by default. This is to improve perfomance if all you need is a set list. Filter also does not currently load set lists. Will be adding in a future release.
List<MtgSet> sets = SetAPI.getAllSets();
Get all Sets with card lists loaded.
List<MtgSet> sets = SetAPI.getAllSetsWithCards();
Generate a Booster
String setCode = "KLD"; List<Card> booster = SetAPI.getBooster(setCode);
Change the connection timeout values that are used by the OkHttpClient
MTGAPI.setConnectionTimeout(60); MTGAPI.setReadTimeout(60); MTGAPI.setWriteTimeout(60);
This project is licensed under MIT license.