tba_api_v3 1.1.1 tba_api_v3: ^1.1.1 copied to clipboard
Unofficial Dart library for the TheBlueAlliance.com API. This uses the OpenAPI cli to generate the dart library.
tba_api_v3 (EXPERIMENTAL) #
Overview #
Information and statistics about FIRST Robotics Competition teams and events.
Authentication #
All endpoints require an Auth Key to be passed in the header X-TBA-Auth-Key
. If you do not have an auth key yet, you can obtain one from your Account Page.
This Dart package is automatically generated by the OpenAPI Generator project:
- API version: 3.8.2
- Build package: org.openapitools.codegen.languages.DartDioClientCodegen
Requirements #
- Dart 2.15.0+ or Flutter 2.8.0+
- Dio 5.0.0+ (https://pub.dev/packages/dio)
Installation & Usage #
pub.dev #
To use the package from pub.dev, please include the following in pubspec.yaml
dependencies:
tba_api_v3: 1.0.0
Github #
If this Dart package is published to Github, please include the following in pubspec.yaml
dependencies:
tba_api_v3:
git:
url: https://github.com/aidan-mundy/Dart-TBA-API-Client.git
#ref: main
Local development #
To use the package from your local drive, please include the following in pubspec.yaml
dependencies:
tba_api_v3:
path: /path/to/tba_api_v3
Getting Started #
Please follow the installation procedure and then run the following:
import 'package:tba_api_v3/tba_api_v3.dart';
final api = TbaApiV3().getDistrictApi();
final String districtKey = districtKey_example; // String | TBA District Key, eg `2016fim`
final String ifNoneMatch = ifNoneMatch_example; // String | Value of the `ETag` header in the most recently cached response by the client.
try {
final response = await api.getDistrictEvents(districtKey, ifNoneMatch);
print(response);
} catch on DioException (e) {
print("Exception when calling DistrictApi->getDistrictEvents: $e\n");
}
Documentation for API Endpoints #
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 | getEventMatchTimeseries | GET /event/{event_key}/matches/timeseries | |
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 | getEventTeamsStatuses | GET /event/{event_key}/teams/statuses | |
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 | |
EventApi | getTeamEventsStatusesByYear | GET /team/{team_key}/events/{year}/statuses | |
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 | getEventTeamsStatuses | GET /event/{event_key}/teams/statuses | |
ListApi | getEventsByYear | GET /events/{year} | |
ListApi | getEventsByYearKeys | GET /events/{year}/keys | |
ListApi | getEventsByYearSimple | GET /events/{year}/simple | |
ListApi | getTeamEventsStatusesByYear | GET /team/{team_key}/events/{year}/statuses | |
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 | getEventMatchTimeseries | GET /event/{event_key}/matches/timeseries | |
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 | getMatchTimeseries | GET /match/{match_key}/timeseries | |
MatchApi | getMatchZebra | GET /match/{match_key}/zebra_motionworks | |
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 | getEventTeamsStatuses | GET /event/{event_key}/teams/statuses | |
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 | getTeamEventsStatusesByYear | GET /team/{team_key}/events/{year}/statuses | |
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 |
Documentation For Models #
- APIStatus
- APIStatusAppVersion
- Award
- AwardRecipient
- DistrictList
- DistrictRanking
- DistrictRankingEventPointsInner
- EliminationAlliance
- EliminationAllianceBackup
- EliminationAllianceStatus
- Event
- EventDistrictPoints
- EventDistrictPointsPointsValue
- EventDistrictPointsTiebreakersValue
- EventInsights
- EventInsights2016
- EventInsights2017
- EventInsights2018
- EventOPRs
- EventRanking
- EventRankingExtraStatsInfoInner
- EventRankingRankingsInner
- EventRankingSortOrderInfoInner
- EventSimple
- GetStatus401Response
- Match
- MatchAlliance
- MatchScoreBreakdown2015
- MatchScoreBreakdown2015Alliance
- MatchScoreBreakdown2016
- MatchScoreBreakdown2016Alliance
- MatchScoreBreakdown2017
- MatchScoreBreakdown2017Alliance
- MatchScoreBreakdown2018
- MatchScoreBreakdown2018Alliance
- MatchScoreBreakdown2019
- MatchScoreBreakdown2019Alliance
- MatchScoreBreakdown2020
- MatchScoreBreakdown2020Alliance
- MatchScoreBreakdown2022
- MatchScoreBreakdown2022Alliance
- MatchScoreBreakdown2023
- MatchScoreBreakdown2023Alliance
- MatchScoreBreakdown2023AllianceAutoCommunity
- MatchScoreBreakdown2023AllianceLinksInner
- MatchSimple
- MatchSimpleAlliances
- MatchTimeseries2018
- MatchVideosInner
- Media
- Team
- TeamEventStatus
- TeamEventStatusAlliance
- TeamEventStatusAllianceBackup
- TeamEventStatusPlayoff
- TeamEventStatusRank
- TeamEventStatusRankRanking
- TeamEventStatusRankSortOrderInfoInner
- TeamRobot
- TeamSimple
- WLTRecord
- Webcast
- Zebra
- ZebraAlliances
- ZebraTeam
Documentation For Authorization #
Authentication schemes defined for the API:
apiKey #
- Type: API key
- API key parameter name: X-TBA-Auth-Key
- Location: HTTP header