Note: Development is behind Riot's updates due to a busy end of the semester.
A powerful and easy-to-use wrapper for the Riot Developer API.
Requires Java 7 or higher.
- Request rate limiting: requests are limited based on the requests per 10 seconds value. If you only have 10 requests per 10 seconds, requests will be limited to 1 request every second.
- Request caching: requests are cached using LRU replacement. This means the most frequent requests will be stored and not requested from the server. Caching can be bypassed.
- Two distinct styles of API usage: follow the API style and call individual methods and operations, or take advantage of object-oriented principles and make requests directly from an object (such as a champion or summoner).
###Style 1: API Style
This style is most similar to the layout of the API its documentation. Requests are handled through methods and their operations.
RiotApi api = new RiotApi(apiKey, userAgent);
//Make one request to get my summoner ID
Summoner me = api.getSummonerMethod().getSummonerByName(Region.NA, "TheEnigmaBlade");
//Make another request to get my match history
List<Game> myMatchHistory = api.getGameMethd().getMatchHistory(Region.NA, me.getId());###Style 2: Object-oriented Style
This style utilizes object-oriented design to create an easy-to-use API interface. Requests are handled through convenience methods provided in the wrapper's structures.
RiotApi api = new RiotApi(apiKey, userAgent);
//Make one request to get my summoner ID
Summoner me = api.getSummoner(Region.NA, "TheEnigmaBlade");
//Make another request to get my match history
List<Game> myMatchHistory = me.getMatchHistory();###API Specifications
| Method | Operation | Supported |
|---|---|---|
| champion-v1.2 | / | Yes |
| game-v1.3 | /by-summoner/{summoner_id}/recent | Yes |
| league-v2.5 | /challenger | Yes |
| /by-summoner/{summoner_id} | Yes | |
| /by-summoner/{summoner_id}/entry | Yes | |
| /by-team/{team_id} | Yes | |
| /by-team/{team_id}/entry | Yes | |
| lol-static-data-v1.2 | /champion | Yes |
| /champion/{champion_id} | Yes | |
| /item | No | |
| /item/{item_id} | No | |
| /mastery | WIP | |
| /mastery/{mastery_id} | WIP | |
| /realm | Yes | |
| /rune | No | |
| /rune/{rune_id} | No | |
| /summoner_spell | No | |
| /summoner_spell/{summoner_spell_id} | No | |
| /versions | Yes | |
| lol-status-v1.0 | /shards | Yes |
| /shards/{region} | Yes | |
| match-v2.2 | /{matchId} | WIP |
| matchhistory-v2.2 | /{summonerId} | No |
| stats-v1.3 | /by-summoner/{summoner_id}/summary | Yes |
| /by-summoner/{summoner_id}/ranked | Yes | |
| summoner-v1.4 | /by-name/{summoner_names} | Yes |
| /{summoner_ids} | Yes | |
| /{summoner_ids}/name | Yes | |
| /{summoner_ids}/masteries | Yes | |
| /{summoner_ids}/runes | Yes | |
| team-v2.4 | /{team_ids} | Yes |
| /by-summoner/{summoner_id} | Yes |
Copyright EnigmaBlade.net, 2014
Distributed under the Boost Software License, Version 1.0
See LICENSE.txt or at http://www.boost.org/LICENSE_1_0.txt
Uses JSONic (also created by me), which has the same license as above.
This product is not endorsed, certified or otherwise approved in any way by Riot Games, Inc. or any of its affiliates.