Skip to content
No description, website, or topics provided.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.openapi-generator
docs
tbaapiv3client
test
.gitignore
.openapi-generator-ignore
.travis.yml
README.md
git_push.sh
requirements.txt
setup.py
test-requirements.txt
tox.ini

README.md

tba-api-v3client

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. A User-Agent header may need to be set to prevent a 403 Unauthorized error.

This Python package is automatically generated by the OpenAPI Generator project:

  • API version: 3.5
  • Package version: 3.5
  • Build package: org.openapitools.codegen.languages.PythonClientCodegen

Requirements.

Python 2.7 and 3.4+

Installation & Usage

pip install

If the python package is hosted on Github, you can install directly from Github

pip install git+https://github.com/GIT_USER_ID/GIT_REPO_ID.git

(you may need to run pip with root permission: sudo pip install git+https://github.com/GIT_USER_ID/GIT_REPO_ID.git)

Then import the package:

import tbaapiv3client 

Setuptools

Install via Setuptools.

python setup.py install --user

(or sudo python setup.py install to install the package for all users)

Then import the package:

import tbaapiv3client

Getting Started

Please follow the installation procedure and then run the following:

from __future__ import print_function
import time
import tbaapiv3client
from tbaapiv3client.rest import ApiException
from pprint import pprint

configuration = tbaapiv3client.Configuration()
# Configure API key authorization: apiKey
configuration.api_key['X-TBA-Auth-Key'] = 'YOUR_API_KEY'
# Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
# configuration.api_key_prefix['X-TBA-Auth-Key'] = 'Bearer'

# Defining host is optional and default to https://www.thebluealliance.com/api/v3
configuration.host = "https://www.thebluealliance.com/api/v3"
# Create an instance of the API class
api_instance = tbaapiv3client.TBAApi(tbaapiv3client.ApiClient(configuration))
if_modified_since = 'if_modified_since_example' # str | Value of the `Last-Modified` header in the most recently cached response by the client. (optional)

try:
    api_response = api_instance.get_status(if_modified_since=if_modified_since)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling TBAApi->get_status: %s\n" % e)

Documentation for API Endpoints

All URIs are relative to https://www.thebluealliance.com/api/v3

Class Method HTTP request Description
TBAApi get_status GET /status
DistrictApi get_district_events GET /district/{district_key}/events
DistrictApi get_district_events_keys GET /district/{district_key}/events/keys
DistrictApi get_district_events_simple GET /district/{district_key}/events/simple
DistrictApi get_district_rankings GET /district/{district_key}/rankings
DistrictApi get_district_teams GET /district/{district_key}/teams
DistrictApi get_district_teams_keys GET /district/{district_key}/teams/keys
DistrictApi get_district_teams_simple GET /district/{district_key}/teams/simple
DistrictApi get_districts_by_year GET /districts/{year}
DistrictApi get_event_district_points GET /event/{event_key}/district_points
DistrictApi get_team_districts GET /team/{team_key}/districts
EventApi get_district_events GET /district/{district_key}/events
EventApi get_district_events_keys GET /district/{district_key}/events/keys
EventApi get_district_events_simple GET /district/{district_key}/events/simple
EventApi get_event GET /event/{event_key}
EventApi get_event_alliances GET /event/{event_key}/alliances
EventApi get_event_awards GET /event/{event_key}/awards
EventApi get_event_district_points GET /event/{event_key}/district_points
EventApi get_event_insights GET /event/{event_key}/insights
EventApi get_event_match_timeseries GET /event/{event_key}/matches/timeseries
EventApi get_event_matches GET /event/{event_key}/matches
EventApi get_event_matches_keys GET /event/{event_key}/matches/keys
EventApi get_event_matches_simple GET /event/{event_key}/matches/simple
EventApi get_event_op_rs GET /event/{event_key}/oprs
EventApi get_event_predictions GET /event/{event_key}/predictions
EventApi get_event_rankings GET /event/{event_key}/rankings
EventApi get_event_simple GET /event/{event_key}/simple
EventApi get_event_teams GET /event/{event_key}/teams
EventApi get_event_teams_keys GET /event/{event_key}/teams/keys
EventApi get_event_teams_simple GET /event/{event_key}/teams/simple
EventApi get_event_teams_statuses GET /event/{event_key}/teams/statuses
EventApi get_events_by_year GET /events/{year}
EventApi get_events_by_year_keys GET /events/{year}/keys
EventApi get_events_by_year_simple GET /events/{year}/simple
EventApi get_team_event_awards GET /team/{team_key}/event/{event_key}/awards
EventApi get_team_event_matches GET /team/{team_key}/event/{event_key}/matches
EventApi get_team_event_matches_keys GET /team/{team_key}/event/{event_key}/matches/keys
EventApi get_team_event_matches_simple GET /team/{team_key}/event/{event_key}/matches/simple
EventApi get_team_event_status GET /team/{team_key}/event/{event_key}/status
EventApi get_team_events GET /team/{team_key}/events
EventApi get_team_events_by_year GET /team/{team_key}/events/{year}
EventApi get_team_events_by_year_keys GET /team/{team_key}/events/{year}/keys
EventApi get_team_events_by_year_simple GET /team/{team_key}/events/{year}/simple
EventApi get_team_events_keys GET /team/{team_key}/events/keys
EventApi get_team_events_simple GET /team/{team_key}/events/simple
EventApi get_team_events_statuses_by_year GET /team/{team_key}/events/{year}/statuses
ListApi get_district_events GET /district/{district_key}/events
ListApi get_district_events_keys GET /district/{district_key}/events/keys
ListApi get_district_events_simple GET /district/{district_key}/events/simple
ListApi get_district_rankings GET /district/{district_key}/rankings
ListApi get_district_teams GET /district/{district_key}/teams
ListApi get_district_teams_keys GET /district/{district_key}/teams/keys
ListApi get_district_teams_simple GET /district/{district_key}/teams/simple
ListApi get_event_teams GET /event/{event_key}/teams
ListApi get_event_teams_keys GET /event/{event_key}/teams/keys
ListApi get_event_teams_simple GET /event/{event_key}/teams/simple
ListApi get_event_teams_statuses GET /event/{event_key}/teams/statuses
ListApi get_events_by_year GET /events/{year}
ListApi get_events_by_year_keys GET /events/{year}/keys
ListApi get_events_by_year_simple GET /events/{year}/simple
ListApi get_team_events_statuses_by_year GET /team/{team_key}/events/{year}/statuses
ListApi get_teams GET /teams/{page_num}
ListApi get_teams_by_year GET /teams/{year}/{page_num}
ListApi get_teams_by_year_keys GET /teams/{year}/{page_num}/keys
ListApi get_teams_by_year_simple GET /teams/{year}/{page_num}/simple
ListApi get_teams_keys GET /teams/{page_num}/keys
ListApi get_teams_simple GET /teams/{page_num}/simple
MatchApi get_event_match_timeseries GET /event/{event_key}/matches/timeseries
MatchApi get_event_matches GET /event/{event_key}/matches
MatchApi get_event_matches_keys GET /event/{event_key}/matches/keys
MatchApi get_event_matches_simple GET /event/{event_key}/matches/simple
MatchApi get_match GET /match/{match_key}
MatchApi get_match_simple GET /match/{match_key}/simple
MatchApi get_match_timeseries GET /match/{match_key}/timeseries
MatchApi get_team_event_matches GET /team/{team_key}/event/{event_key}/matches
MatchApi get_team_event_matches_keys GET /team/{team_key}/event/{event_key}/matches/keys
MatchApi get_team_event_matches_simple GET /team/{team_key}/event/{event_key}/matches/simple
MatchApi get_team_matches_by_year GET /team/{team_key}/matches/{year}
MatchApi get_team_matches_by_year_keys GET /team/{team_key}/matches/{year}/keys
MatchApi get_team_matches_by_year_simple GET /team/{team_key}/matches/{year}/simple
TeamApi get_district_rankings GET /district/{district_key}/rankings
TeamApi get_district_teams GET /district/{district_key}/teams
TeamApi get_district_teams_keys GET /district/{district_key}/teams/keys
TeamApi get_district_teams_simple GET /district/{district_key}/teams/simple
TeamApi get_event_teams GET /event/{event_key}/teams
TeamApi get_event_teams_keys GET /event/{event_key}/teams/keys
TeamApi get_event_teams_simple GET /event/{event_key}/teams/simple
TeamApi get_event_teams_statuses GET /event/{event_key}/teams/statuses
TeamApi get_team GET /team/{team_key}
TeamApi get_team_awards GET /team/{team_key}/awards
TeamApi get_team_awards_by_year GET /team/{team_key}/awards/{year}
TeamApi get_team_districts GET /team/{team_key}/districts
TeamApi get_team_event_awards GET /team/{team_key}/event/{event_key}/awards
TeamApi get_team_event_matches GET /team/{team_key}/event/{event_key}/matches
TeamApi get_team_event_matches_keys GET /team/{team_key}/event/{event_key}/matches/keys
TeamApi get_team_event_matches_simple GET /team/{team_key}/event/{event_key}/matches/simple
TeamApi get_team_event_status GET /team/{team_key}/event/{event_key}/status
TeamApi get_team_events GET /team/{team_key}/events
TeamApi get_team_events_by_year GET /team/{team_key}/events/{year}
TeamApi get_team_events_by_year_keys GET /team/{team_key}/events/{year}/keys
TeamApi get_team_events_by_year_simple GET /team/{team_key}/events/{year}/simple
TeamApi get_team_events_keys GET /team/{team_key}/events/keys
TeamApi get_team_events_simple GET /team/{team_key}/events/simple
TeamApi get_team_events_statuses_by_year GET /team/{team_key}/events/{year}/statuses
TeamApi get_team_matches_by_year GET /team/{team_key}/matches/{year}
TeamApi get_team_matches_by_year_keys GET /team/{team_key}/matches/{year}/keys
TeamApi get_team_matches_by_year_simple GET /team/{team_key}/matches/{year}/simple
TeamApi get_team_media_by_tag GET /team/{team_key}/media/tag/{media_tag}
TeamApi get_team_media_by_tag_year GET /team/{team_key}/media/tag/{media_tag}/{year}
TeamApi get_team_media_by_year GET /team/{team_key}/media/{year}
TeamApi get_team_robots GET /team/{team_key}/robots
TeamApi get_team_simple GET /team/{team_key}/simple
TeamApi get_team_social_media GET /team/{team_key}/social_media
TeamApi get_team_years_participated GET /team/{team_key}/years_participated
TeamApi get_teams GET /teams/{page_num}
TeamApi get_teams_by_year GET /teams/{year}/{page_num}
TeamApi get_teams_by_year_keys GET /teams/{year}/{page_num}/keys
TeamApi get_teams_by_year_simple GET /teams/{year}/{page_num}/simple
TeamApi get_teams_keys GET /teams/{page_num}/keys
TeamApi get_teams_simple GET /teams/{page_num}/simple

Documentation For Models

Documentation For Authorization

apiKey

  • Type: API key
  • API key parameter name: X-TBA-Auth-Key
  • Location: HTTP header

Author

You can’t perform that action at this time.