Anton3 / jcrapi

Java Clash Royal Api (CR-Api) Connector

Java CR-API Connector

Actual version: v10.6.18-RC1

Simplest Usage

// connect to api
Api api = new Api("http://api.royaleapi.com/", "my-developer-key"); // standard auth mode
Api api = new Api("http://api.royaleapi.com/", "my-developer-key", AuthMode.BEARER);

// get version
String version = api.getVersion();

// get profile
Profile profile = api.getProfile(ProfileRequest.builder("2PGGCJJL")
    .keys(Arrays.asList("name", "clan", "tag"))
    .excludes(Arrays.asList("battles"))
    .build()
);

// get profiles
List<Profile> profiles = api.getProfiles(ProfilesRequest.builder(Arrays.asList("L88P2282", "9CQ2U8QJ", "8L9L9GL"))
    .keys(Arrays.asList("name", "clan", "tag"))
    .excludes(Arrays.asList("battles"))
    .limit(10)
    .build()
);

// get clan
Clan clan = api.getClan(ClanRequestBuilder.builder("RP88QQG")
    .keys(Arrays.asList("name", "clan", "tag"))
    .excludes(Arrays.asList("battles"))
    .build());

// get list of clans
List<Clan> clans = api.getClans(ClanRequestBuilder.builder(Arrays.asList("RP88QQG", "2CCCP"))
    .keys(Arrays.asList("name", "clan", "tag"))
    .excludes(Arrays.asList("battles"))
    .limit(10)
    .build());

// clan search
List<Clan> clans = api.getClanSearch(ClanSearchRequest.builder()
    .setName("abc")
    .setScore(500)
    .setMinMembers(10)
    .setMaxMembers(25)
    .keys(Arrays.asList("name", "clan", "tag"))
    .excludes(Arrays.asList("battles"))
    .limit(10)
    .build());

// get tournaments
Tournament tournament = api.getTournaments(TournamentRequest.builder()
    .tag("XYZHHG")
    .keys(Arrays.asList("name", "clan", "tag"))
    .excludes(Arrays.asList("battles"))
    .build());

// get top clans
List<TopClan> topClansForEu = api.getTopClans(TopClanRequest.builder()
    .locationKey("EU")
    .keys(Arrays.asList("name", "clan", "tag"))
    .excludes(Arrays.asList("battles"))
    .limit(10)
    .build());

// get top players
List<TopPlayer> topPlayersForEu = api.getTopPlayers(TopPlayerRequest.builder()
    .locationKey("EU")
    .keys(Arrays.asList("name", "clan", "tag"))
    .excludes(Arrays.asList("battles"))
    .limit(10)
    .build());

// get endpoints
Endpoints endpoints = api.getEndpoints();

// get popular clans
List<PopularClan> popularClans = api.getPopularClans(PopularClans.builder()
    .keys(Arrays.asList("name", "clan", "tag"))
    .excludes(Arrays.asList("battles"))
    .limit(10)
    .build());

// get popular players
List<PopularPlayer> popularPlayers = api.getPopularPlayers(PopularPlayers.builder()
    .keys(Arrays.asList("name", "clan", "tag"))
    .excludes(Arrays.asList("battles"))
    .limit(10)
    .build());

// get popular tournaments
List<PopularTournament> popularTournaments = api.getPopularTournaments(PopularTournaments.builder()
    .keys(Arrays.asList("name", "clan", "tag"))
    .excludes(Arrays.asList("battles"))
    .limit(10)
    .build());

// get clan battles
List<Battle> clanBattles = api.getClanBattles(ClanBattleRequest.builder("RP88QQG")
    .keys(Arrays.asList("name", "clan", "tag"))
    .excludes(Arrays.asList("cards"))
    .limit(10)
    .build());

// get clan history
ClanHistory clanHistory = api.getClanHistory(ClanHistoryRequest.builder("RP88QQG")
    .days(1)
    .keys(Arrays.asList("name", "clan", "tag"))
    .excludes(Arrays.asList("cards"))
    .limit(10)
    .build());

// get open tournaments
List<OpenTournament> openTournaments = api.getOpenTournaments(OpenTournamentsRequest.builder()
    .keys(Arrays.asList("name", "clan", "tag"))
    .excludes(Arrays.asList("cards"))
    .limit(10)
    .build());

// get known tournaments
List<KnownTournament> knownTournaments = api.getKnownTournaments(KnownTournamentsRequest.builder()
    .keys(Arrays.asList("name", "clan", "tag"))
    .excludes(Arrays.asList("cards"))
    .limit(10)
    .build());

// tournament search
List<Clan> clans = api.getTournamentSearch(TournamentSearchRequest.builder()
    .setName("abc")
    .keys(Arrays.asList("name", "clan", "tag"))
    .excludes(Arrays.asList("battles"))
    .limit(10)
    .build());

// get player battles
List<List<Battle>> battles = api.getPlayerBattles(PlayerBattlesRequest.builder(Arrays.asList("L88P2282", "9CQ2U8QJ", "8L9L9GL"))
    .keys(Arrays.asList("name", "clan", "tag"))
    .excludes(Arrays.asList("cards"))
    .limit(10)
    .build());

// get player chests
List<ChestCycle> chestCycles = api.getPlayerChests(PlayerChestsRequest.builder(Arrays.asList("L88P2282", "9CQ2U8QJ", "8L9L9GL"))
    .keys(Arrays.asList("name", "clan", "tag"))
    .excludes(Arrays.asList("cards"))
    .limit(10)
    .build());

// get popular decks
List<PopularDeck> popularDecks = api.getPopularDecks(PopularDecksRequest.builder()
    .keys(Arrays.asList("name", "clan", "tag"))
    .excludes(Arrays.asList("cards"))
    .limit(10)
    .build());

// get clan tracking
ClanTracking clanTracking = api.getClanTracking(ClanTrackingRequest.builder()
    .keys(Arrays.asList("name", "clan", "tag"))
    .excludes(Arrays.asList("cards"))
    .build());

// get auth stats
AuthStats authStats = api.getAuthStats(AuthStatsRequest.builder()
    .keys(Arrays.asList("name", "clan", "tag"))
    .excludes(Arrays.asList("cards"))
    .build());

// get thread safe last response object from last request 
Response response = api.getLastResponse();

String raw = response.getRaw();
Map<String, String> responseHeaders = response.getResponseHeaders();
int rateLimit = response.getRateLimit();
int rateRemaining = response.getRateRemaining();

How to bind the bintray repository

<repository>
    <id>org-mili-repo</id>
    <url>http://dl.bintray.com/mlieshoff/maven</url>
    <releases>
        <enabled>true</enabled>
    </releases>
    <snapshots>
        <enabled>false</enabled>
    </snapshots>
</repository>

Continuous Integration

https://travis-ci.org/mlieshoff/jcrapi

Repository

https://bintray.com/mlieshoff/maven/jcrapi