Building the API client library requires Maven to be installed.
To install the API client library to your local Maven repository, simply execute:
mvn install
To deploy it to a remote Maven repository instead, configure the settings of the repository and execute:
mvn deploy
Refer to the official documentation for more information.
Add this dependency to your project's POM:
<dependency>
<groupId>net.thefletcher.tbaapi.v3</groupId>
<artifactId>tba-api-v3client</artifactId>
<version>3.0.4</version>
<scope>compile</scope>
</dependency>
Add this dependency to your project's build file:
compile "net.thefletcher.tbaapi.v3:tba-api-v3client:3.0.4"
At first generate the JAR by executing:
mvn package
Then manually install the following JARs:
- target/tba-api-v3client-3.0.4.jar
- target/lib/*.jar
Please follow the installation instruction and execute the following Java code:
import net.thefletcher.tbaapi.v3client.*;
import net.thefletcher.tbaapi.v3client.auth.*;
import net.thefletcher.tbaapi.v3client.model.*;
import net.thefletcher.tbaapi.v3client.api.DistrictApi;
import java.io.File;
import java.util.*;
public class DistrictApiExample {
public static void main(String[] args) {
ApiClient defaultClient = Configuration.getDefaultApiClient();
// Configure API key authorization: apiKey
ApiKeyAuth apiKey = (ApiKeyAuth) defaultClient.getAuthentication("apiKey");
apiKey.setApiKey("YOUR API KEY");
// Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null)
//apiKey.setApiKeyPrefix("Token");
DistrictApi apiInstance = new DistrictApi();
String districtKey = "districtKey_example"; // String | TBA District Key, eg `2016fim`
String ifModifiedSince = "ifModifiedSince_example"; // String | Value of the `Last-Modified` header in the most recently cached response by the client.
try {
List<Event> result = apiInstance.getDistrictEvents(districtKey, ifModifiedSince);
System.out.println(result);
} catch (ApiException e) {
System.err.println("Exception when calling DistrictApi#getDistrictEvents");
e.printStackTrace();
}
}
}
All URIs are relative to https://www.thebluealliance.com/api/v3
Class | Method | HTTP request | Description |
---|---|---|---|
DistrictApi | getDistrictEvents | GET /district/{district_key}/events | |
DistrictApi | getDistrictEventsKeys | GET /district/{district_key}/events/keys | |
DistrictApi | getDistrictEventsSimple | GET /district/{district_key}/events/simple | |
DistrictApi | getDistrictRankings | GET /district/{district_key}/rankings | |
DistrictApi | getDistrictTeams | GET /district/{district_key}/teams | |
DistrictApi | getDistrictTeamsKeys | GET /district/{district_key}/teams/keys | |
DistrictApi | getDistrictTeamsSimple | GET /district/{district_key}/teams/simple | |
DistrictApi | getDistrictsByYear | GET /districts/{year} | |
DistrictApi | getEventDistrictPoints | GET /event/{event_key}/district_points | |
DistrictApi | getTeamDistricts | GET /team/{team_key}/districts | |
EventApi | getDistrictEvents | GET /district/{district_key}/events | |
EventApi | getDistrictEventsKeys | GET /district/{district_key}/events/keys | |
EventApi | getDistrictEventsSimple | GET /district/{district_key}/events/simple | |
EventApi | getEvent | GET /event/{event_key} | |
EventApi | getEventAlliances | GET /event/{event_key}/alliances | |
EventApi | getEventAwards | GET /event/{event_key}/awards | |
EventApi | getEventDistrictPoints | GET /event/{event_key}/district_points | |
EventApi | getEventInsights | GET /event/{event_key}/insights | |
EventApi | getEventMatches | GET /event/{event_key}/matches | |
EventApi | getEventMatchesKeys | GET /event/{event_key}/matches/keys | |
EventApi | getEventMatchesSimple | GET /event/{event_key}/matches/simple | |
EventApi | getEventOPRs | GET /event/{event_key}/oprs | |
EventApi | getEventPredictions | GET /event/{event_key}/predictions | |
EventApi | getEventRankings | GET /event/{event_key}/rankings | |
EventApi | getEventSimple | GET /event/{event_key}/simple | |
EventApi | getEventTeams | GET /event/{event_key}/teams | |
EventApi | getEventTeamsKeys | GET /event/{event_key}/teams/keys | |
EventApi | getEventTeamsSimple | GET /event/{event_key}/teams/simple | |
EventApi | getEventsByYear | GET /events/{year} | |
EventApi | getEventsByYearKeys | GET /events/{year}/keys | |
EventApi | getEventsByYearSimple | GET /events/{year}/simple | |
EventApi | getTeamEventAwards | GET /team/{team_key}/event/{event_key}/awards | |
EventApi | getTeamEventMatches | GET /team/{team_key}/event/{event_key}/matches | |
EventApi | getTeamEventMatchesKeys | GET /team/{team_key}/event/{event_key}/matches/keys | |
EventApi | getTeamEventMatchesSimple | GET /team/{team_key}/event/{event_key}/matches/simple | |
EventApi | getTeamEventStatus | GET /team/{team_key}/event/{event_key}/status | |
EventApi | getTeamEvents | GET /team/{team_key}/events | |
EventApi | getTeamEventsByYear | GET /team/{team_key}/events/{year} | |
EventApi | getTeamEventsByYearKeys | GET /team/{team_key}/events/{year}/keys | |
EventApi | getTeamEventsByYearSimple | GET /team/{team_key}/events/{year}/simple | |
EventApi | getTeamEventsKeys | GET /team/{team_key}/events/keys | |
EventApi | getTeamEventsSimple | GET /team/{team_key}/events/simple | |
ListApi | getDistrictEvents | GET /district/{district_key}/events | |
ListApi | getDistrictEventsKeys | GET /district/{district_key}/events/keys | |
ListApi | getDistrictEventsSimple | GET /district/{district_key}/events/simple | |
ListApi | getDistrictRankings | GET /district/{district_key}/rankings | |
ListApi | getDistrictTeams | GET /district/{district_key}/teams | |
ListApi | getDistrictTeamsKeys | GET /district/{district_key}/teams/keys | |
ListApi | getDistrictTeamsSimple | GET /district/{district_key}/teams/simple | |
ListApi | getEventTeams | GET /event/{event_key}/teams | |
ListApi | getEventTeamsKeys | GET /event/{event_key}/teams/keys | |
ListApi | getEventTeamsSimple | GET /event/{event_key}/teams/simple | |
ListApi | getEventsByYear | GET /events/{year} | |
ListApi | getEventsByYearKeys | GET /events/{year}/keys | |
ListApi | getEventsByYearSimple | GET /events/{year}/simple | |
ListApi | getTeams | GET /teams/{page_num} | |
ListApi | getTeamsByYear | GET /teams/{year}/{page_num} | |
ListApi | getTeamsByYearKeys | GET /teams/{year}/{page_num}/keys | |
ListApi | getTeamsByYearSimple | GET /teams/{year}/{page_num}/simple | |
ListApi | getTeamsKeys | GET /teams/{page_num}/keys | |
ListApi | getTeamsSimple | GET /teams/{page_num}/simple | |
MatchApi | getEventMatches | GET /event/{event_key}/matches | |
MatchApi | getEventMatchesKeys | GET /event/{event_key}/matches/keys | |
MatchApi | getEventMatchesSimple | GET /event/{event_key}/matches/simple | |
MatchApi | getMatch | GET /match/{match_key} | |
MatchApi | getMatchSimple | GET /match/{match_key}/simple | |
MatchApi | getTeamEventMatches | GET /team/{team_key}/event/{event_key}/matches | |
MatchApi | getTeamEventMatchesKeys | GET /team/{team_key}/event/{event_key}/matches/keys | |
MatchApi | getTeamEventMatchesSimple | GET /team/{team_key}/event/{event_key}/matches/simple | |
MatchApi | getTeamMatchesByYear | GET /team/{team_key}/matches/{year} | |
MatchApi | getTeamMatchesByYearKeys | GET /team/{team_key}/matches/{year}/keys | |
MatchApi | getTeamMatchesByYearSimple | GET /team/{team_key}/matches/{year}/simple | |
TBAApi | getStatus | GET /status | |
TeamApi | getDistrictRankings | GET /district/{district_key}/rankings | |
TeamApi | getDistrictTeams | GET /district/{district_key}/teams | |
TeamApi | getDistrictTeamsKeys | GET /district/{district_key}/teams/keys | |
TeamApi | getDistrictTeamsSimple | GET /district/{district_key}/teams/simple | |
TeamApi | getEventTeams | GET /event/{event_key}/teams | |
TeamApi | getEventTeamsKeys | GET /event/{event_key}/teams/keys | |
TeamApi | getEventTeamsSimple | GET /event/{event_key}/teams/simple | |
TeamApi | getTeam | GET /team/{team_key} | |
TeamApi | getTeamAwards | GET /team/{team_key}/awards | |
TeamApi | getTeamAwardsByYear | GET /team/{team_key}/awards/{year} | |
TeamApi | getTeamDistricts | GET /team/{team_key}/districts | |
TeamApi | getTeamEventAwards | GET /team/{team_key}/event/{event_key}/awards | |
TeamApi | getTeamEventMatches | GET /team/{team_key}/event/{event_key}/matches | |
TeamApi | getTeamEventMatchesKeys | GET /team/{team_key}/event/{event_key}/matches/keys | |
TeamApi | getTeamEventMatchesSimple | GET /team/{team_key}/event/{event_key}/matches/simple | |
TeamApi | getTeamEventStatus | GET /team/{team_key}/event/{event_key}/status | |
TeamApi | getTeamEvents | GET /team/{team_key}/events | |
TeamApi | getTeamEventsByYear | GET /team/{team_key}/events/{year} | |
TeamApi | getTeamEventsByYearKeys | GET /team/{team_key}/events/{year}/keys | |
TeamApi | getTeamEventsByYearSimple | GET /team/{team_key}/events/{year}/simple | |
TeamApi | getTeamEventsKeys | GET /team/{team_key}/events/keys | |
TeamApi | getTeamEventsSimple | GET /team/{team_key}/events/simple | |
TeamApi | getTeamMatchesByYear | GET /team/{team_key}/matches/{year} | |
TeamApi | getTeamMatchesByYearKeys | GET /team/{team_key}/matches/{year}/keys | |
TeamApi | getTeamMatchesByYearSimple | GET /team/{team_key}/matches/{year}/simple | |
TeamApi | getTeamMediaByTag | GET /team/{team_key}/media/tag/{media_tag} | |
TeamApi | getTeamMediaByTagYear | GET /team/{team_key}/media/tag/{media_tag}/{year} | |
TeamApi | getTeamMediaByYear | GET /team/{team_key}/media/{year} | |
TeamApi | getTeamRobots | GET /team/{team_key}/robots | |
TeamApi | getTeamSimple | GET /team/{team_key}/simple | |
TeamApi | getTeamSocialMedia | GET /team/{team_key}/social_media | |
TeamApi | getTeamYearsParticipated | GET /team/{team_key}/years_participated | |
TeamApi | getTeams | GET /teams/{page_num} | |
TeamApi | getTeamsByYear | GET /teams/{year}/{page_num} | |
TeamApi | getTeamsByYearKeys | GET /teams/{year}/{page_num}/keys | |
TeamApi | getTeamsByYearSimple | GET /teams/{year}/{page_num}/simple | |
TeamApi | getTeamsKeys | GET /teams/{page_num}/keys | |
TeamApi | getTeamsSimple | GET /teams/{page_num}/simple |
- APIStatus
- APIStatusAppVersion
- Award
- AwardRecipient
- DistrictList
- DistrictRanking
- DistrictRankingEventPoints
- EliminationAlliance
- EliminationAllianceBackup
- EliminationAllianceStatus
- Event
- EventDistrictPoints
- EventDistrictPointsPoints
- EventDistrictPointsTiebreakers
- EventInsights2016
- EventInsights2016Detail
- EventInsights2017
- EventInsights2017Detail
- EventOPRs
- EventPredictions
- EventRanking
- EventRankingExtraStatsInfo
- EventRankingRankings
- EventRankingSortOrderInfo
- EventSimple
- Match
- MatchAlliance
- MatchScoreBreakdown2015
- MatchScoreBreakdown2015Alliance
- MatchScoreBreakdown2016
- MatchScoreBreakdown2016Alliance
- MatchScoreBreakdown2017
- MatchScoreBreakdown2017Alliance
- MatchSimple
- MatchSimpleAlliances
- MatchVideos
- Media
- Team
- TeamEventStatus
- TeamEventStatusAlliance
- TeamEventStatusAllianceBackup
- TeamEventStatusPlayoff
- TeamEventStatusRank
- TeamEventStatusRankRanking
- TeamEventStatusRankSortOrderInfo
- TeamRobot
- TeamSimple
- WLTRecord
- Webcast
Authentication schemes defined for the API:
- Type: API key
- API key parameter name: X-TBA-Auth-Key
- Location: HTTP header
It's recommended to create an instance of ApiClient
per thread in a multithreaded environment to avoid any potential issues.