Skip to content

Latest commit

 

History

History
1201 lines (642 loc) · 37.4 KB

EventApi.md

File metadata and controls

1201 lines (642 loc) · 37.4 KB
Raw

\EventApi

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

Method HTTP request Description
get_district_events GET /district/{district_key}/events
get_district_events_keys GET /district/{district_key}/events/keys
get_district_events_simple GET /district/{district_key}/events/simple
get_event GET /event/{event_key}
get_event_alliances GET /event/{event_key}/alliances
get_event_awards GET /event/{event_key}/awards
get_event_coprs GET /event/{event_key}/coprs
get_event_district_points GET /event/{event_key}/district_points
get_event_insights GET /event/{event_key}/insights
get_event_match_timeseries GET /event/{event_key}/matches/timeseries
get_event_matches GET /event/{event_key}/matches
get_event_matches_keys GET /event/{event_key}/matches/keys
get_event_matches_simple GET /event/{event_key}/matches/simple
get_event_oprs GET /event/{event_key}/oprs
get_event_predictions GET /event/{event_key}/predictions
get_event_rankings GET /event/{event_key}/rankings
get_event_simple GET /event/{event_key}/simple
get_event_team_media GET /event/{event_key}/team_media
get_event_teams GET /event/{event_key}/teams
get_event_teams_keys GET /event/{event_key}/teams/keys
get_event_teams_simple GET /event/{event_key}/teams/simple
get_event_teams_statuses GET /event/{event_key}/teams/statuses
get_events_by_year GET /events/{year}
get_events_by_year_keys GET /events/{year}/keys
get_events_by_year_simple GET /events/{year}/simple
get_team_event_awards GET /team/{team_key}/event/{event_key}/awards
get_team_event_matches GET /team/{team_key}/event/{event_key}/matches
get_team_event_matches_keys GET /team/{team_key}/event/{event_key}/matches/keys
get_team_event_matches_simple GET /team/{team_key}/event/{event_key}/matches/simple
get_team_event_status GET /team/{team_key}/event/{event_key}/status
get_team_events GET /team/{team_key}/events
get_team_events_by_year GET /team/{team_key}/events/{year}
get_team_events_by_year_keys GET /team/{team_key}/events/{year}/keys
get_team_events_by_year_simple GET /team/{team_key}/events/{year}/simple
get_team_events_keys GET /team/{team_key}/events/keys
get_team_events_simple GET /team/{team_key}/events/simple
get_team_events_statuses_by_year GET /team/{team_key}/events/{year}/statuses

get_district_events

Vecmodels::Event get_district_events(district_key, if_none_match)

Gets a list of events in the given district.

Parameters

Name Type Description Required Notes
district_key String TBA District Key, eg 2016fim [required]
if_none_match Option<String> Value of the ETag header in the most recently cached response by the client.

Return type

Vecmodels::Event

Authorization

apiKey

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

get_district_events_keys

Vec get_district_events_keys(district_key, if_none_match)

Gets a list of event keys for events in the given district.

Parameters

Name Type Description Required Notes
district_key String TBA District Key, eg 2016fim [required]
if_none_match Option<String> Value of the ETag header in the most recently cached response by the client.

Return type

Vec

Authorization

apiKey

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

get_district_events_simple

Vecmodels::EventSimple get_district_events_simple(district_key, if_none_match)

Gets a short-form list of events in the given district.

Parameters

Name Type Description Required Notes
district_key String TBA District Key, eg 2016fim [required]
if_none_match Option<String> Value of the ETag header in the most recently cached response by the client.

Return type

Vecmodels::EventSimple

Authorization

apiKey

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

get_event

models::Event get_event(event_key, if_none_match)

Gets an Event.

Parameters

Name Type Description Required Notes
event_key String TBA Event Key, eg 2016nytr [required]
if_none_match Option<String> Value of the ETag header in the most recently cached response by the client.

Return type

models::Event

Authorization

apiKey

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

get_event_alliances

Vecmodels::EliminationAlliance get_event_alliances(event_key, if_none_match)

Gets a list of Elimination Alliances for the given Event.

Parameters

Name Type Description Required Notes
event_key String TBA Event Key, eg 2016nytr [required]
if_none_match Option<String> Value of the ETag header in the most recently cached response by the client.

Return type

Vecmodels::EliminationAlliance

Authorization

apiKey

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

get_event_awards

Vecmodels::Award get_event_awards(event_key, if_none_match)

Gets a list of awards from the given event.

Parameters

Name Type Description Required Notes
event_key String TBA Event Key, eg 2016nytr [required]
if_none_match Option<String> Value of the ETag header in the most recently cached response by the client.

Return type

Vecmodels::Award

Authorization

apiKey

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

get_event_coprs

std::collections::HashMap<String, std::collections::HashMap<String, f64>> get_event_coprs(event_key, if_none_match)

Gets a set of Event Component OPRs for the given Event.

Parameters

Name Type Description Required Notes
event_key String TBA Event Key, eg 2016nytr [required]
if_none_match Option<String> Value of the ETag header in the most recently cached response by the client.

Return type

std::collections::HashMap<String, std::collections::HashMap<String, f64>>

Authorization

apiKey

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

get_event_district_points

models::EventDistrictPoints get_event_district_points(event_key, if_none_match)

Gets a list of team rankings for the Event.

Parameters

Name Type Description Required Notes
event_key String TBA Event Key, eg 2016nytr [required]
if_none_match Option<String> Value of the ETag header in the most recently cached response by the client.

Return type

models::EventDistrictPoints

Authorization

apiKey

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

get_event_insights

models::EventInsights get_event_insights(event_key, if_none_match)

Gets a set of Event-specific insights for the given Event.

Parameters

Name Type Description Required Notes
event_key String TBA Event Key, eg 2016nytr [required]
if_none_match Option<String> Value of the ETag header in the most recently cached response by the client.

Return type

models::EventInsights

Authorization

apiKey

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

get_event_match_timeseries

Vec get_event_match_timeseries(event_key, if_none_match)

Gets an array of Match Keys for the given event key that have timeseries data. Returns an empty array if no matches have timeseries data. WARNING: This is not official data, and is subject to a significant possibility of error, or missing data. Do not rely on this data for any purpose. In fact, pretend we made it up. WARNING: This endpoint and corresponding data models are under active development and may change at any time, including in breaking ways.

Parameters

Name Type Description Required Notes
event_key String TBA Event Key, eg 2016nytr [required]
if_none_match Option<String> Value of the ETag header in the most recently cached response by the client.

Return type

Vec

Authorization

apiKey

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

get_event_matches

Vecmodels::Match get_event_matches(event_key, if_none_match)

Gets a list of matches for the given event.

Parameters

Name Type Description Required Notes
event_key String TBA Event Key, eg 2016nytr [required]
if_none_match Option<String> Value of the ETag header in the most recently cached response by the client.

Return type

Vecmodels::Match

Authorization

apiKey

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

get_event_matches_keys

Vec get_event_matches_keys(event_key, if_none_match)

Gets a list of match keys for the given event.

Parameters

Name Type Description Required Notes
event_key String TBA Event Key, eg 2016nytr [required]
if_none_match Option<String> Value of the ETag header in the most recently cached response by the client.

Return type

Vec

Authorization

apiKey

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

get_event_matches_simple

Vecmodels::MatchSimple get_event_matches_simple(event_key, if_none_match)

Gets a short-form list of matches for the given event.

Parameters

Name Type Description Required Notes
event_key String TBA Event Key, eg 2016nytr [required]
if_none_match Option<String> Value of the ETag header in the most recently cached response by the client.

Return type

Vecmodels::MatchSimple

Authorization

apiKey

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

get_event_oprs

models::EventOprs get_event_oprs(event_key, if_none_match)

Gets a set of Event OPRs (including OPR, DPR, and CCWM) for the given Event.

Parameters

Name Type Description Required Notes
event_key String TBA Event Key, eg 2016nytr [required]
if_none_match Option<String> Value of the ETag header in the most recently cached response by the client.

Return type

models::EventOprs

Authorization

apiKey

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

get_event_predictions

serde_json::Value get_event_predictions(event_key, if_none_match)

Gets information on TBA-generated predictions for the given Event. Contains year-specific information. WARNING This endpoint is currently under development and may change at any time.

Parameters

Name Type Description Required Notes
event_key String TBA Event Key, eg 2016nytr [required]
if_none_match Option<String> Value of the ETag header in the most recently cached response by the client.

Return type

serde_json::Value

Authorization

apiKey

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

get_event_rankings

models::EventRanking get_event_rankings(event_key, if_none_match)

Gets a list of team rankings for the Event.

Parameters

Name Type Description Required Notes
event_key String TBA Event Key, eg 2016nytr [required]
if_none_match Option<String> Value of the ETag header in the most recently cached response by the client.

Return type

models::EventRanking

Authorization

apiKey

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

get_event_simple

models::EventSimple get_event_simple(event_key, if_none_match)

Gets a short-form Event.

Parameters

Name Type Description Required Notes
event_key String TBA Event Key, eg 2016nytr [required]
if_none_match Option<String> Value of the ETag header in the most recently cached response by the client.

Return type

models::EventSimple

Authorization

apiKey

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

get_event_team_media

Vecmodels::Media get_event_team_media(event_key, if_none_match)

Gets a list of media objects that correspond to teams at this event.

Parameters

Name Type Description Required Notes
event_key String TBA Event Key, eg 2016nytr [required]
if_none_match Option<String> Value of the ETag header in the most recently cached response by the client.

Return type

Vecmodels::Media

Authorization

apiKey

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

get_event_teams

Vecmodels::Team get_event_teams(event_key, if_none_match)

Gets a list of Team objects that competed in the given event.

Parameters

Name Type Description Required Notes
event_key String TBA Event Key, eg 2016nytr [required]
if_none_match Option<String> Value of the ETag header in the most recently cached response by the client.

Return type

Vecmodels::Team

Authorization

apiKey

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

get_event_teams_keys

Vec get_event_teams_keys(event_key, if_none_match)

Gets a list of Team keys that competed in the given event.

Parameters

Name Type Description Required Notes
event_key String TBA Event Key, eg 2016nytr [required]
if_none_match Option<String> Value of the ETag header in the most recently cached response by the client.

Return type

Vec

Authorization

apiKey

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

get_event_teams_simple

Vecmodels::TeamSimple get_event_teams_simple(event_key, if_none_match)

Gets a short-form list of Team objects that competed in the given event.

Parameters

Name Type Description Required Notes
event_key String TBA Event Key, eg 2016nytr [required]
if_none_match Option<String> Value of the ETag header in the most recently cached response by the client.

Return type

Vecmodels::TeamSimple

Authorization

apiKey

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

get_event_teams_statuses

std::collections::HashMap<String, models::GetTeamEventsStatusesByYear200ResponseValue> get_event_teams_statuses(event_key, if_none_match)

Gets a key-value list of the event statuses for teams competing at the given event.

Parameters

Name Type Description Required Notes
event_key String TBA Event Key, eg 2016nytr [required]
if_none_match Option<String> Value of the ETag header in the most recently cached response by the client.

Return type

std::collections::HashMap<String, models::GetTeamEventsStatusesByYear200ResponseValue>

Authorization

apiKey

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

get_events_by_year

Vecmodels::Event get_events_by_year(year, if_none_match)

Gets a list of events in the given year.

Parameters

Name Type Description Required Notes
year i32 Competition Year (or Season). Must be 4 digits. [required]
if_none_match Option<String> Value of the ETag header in the most recently cached response by the client.

Return type

Vecmodels::Event

Authorization

apiKey

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

get_events_by_year_keys

Vec get_events_by_year_keys(year, if_none_match)

Gets a list of event keys in the given year.

Parameters

Name Type Description Required Notes
year i32 Competition Year (or Season). Must be 4 digits. [required]
if_none_match Option<String> Value of the ETag header in the most recently cached response by the client.

Return type

Vec

Authorization

apiKey

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

get_events_by_year_simple

Vecmodels::EventSimple get_events_by_year_simple(year, if_none_match)

Gets a short-form list of events in the given year.

Parameters

Name Type Description Required Notes
year i32 Competition Year (or Season). Must be 4 digits. [required]
if_none_match Option<String> Value of the ETag header in the most recently cached response by the client.

Return type

Vecmodels::EventSimple

Authorization

apiKey

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

get_team_event_awards

Vecmodels::Award get_team_event_awards(team_key, event_key, if_none_match)

Gets a list of awards the given team won at the given event.

Parameters

Name Type Description Required Notes
team_key String TBA Team Key, eg frc254 [required]
event_key String TBA Event Key, eg 2016nytr [required]
if_none_match Option<String> Value of the ETag header in the most recently cached response by the client.

Return type

Vecmodels::Award

Authorization

apiKey

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

get_team_event_matches

Vecmodels::Match get_team_event_matches(team_key, event_key, if_none_match)

Gets a list of matches for the given team and event.

Parameters

Name Type Description Required Notes
team_key String TBA Team Key, eg frc254 [required]
event_key String TBA Event Key, eg 2016nytr [required]
if_none_match Option<String> Value of the ETag header in the most recently cached response by the client.

Return type

Vecmodels::Match

Authorization

apiKey

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

get_team_event_matches_keys

Vec get_team_event_matches_keys(team_key, event_key, if_none_match)

Gets a list of match keys for matches for the given team and event.

Parameters

Name Type Description Required Notes
team_key String TBA Team Key, eg frc254 [required]
event_key String TBA Event Key, eg 2016nytr [required]
if_none_match Option<String> Value of the ETag header in the most recently cached response by the client.

Return type

Vec

Authorization

apiKey

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

get_team_event_matches_simple

Vecmodels::Match get_team_event_matches_simple(team_key, event_key, if_none_match)

Gets a short-form list of matches for the given team and event.

Parameters

Name Type Description Required Notes
team_key String TBA Team Key, eg frc254 [required]
event_key String TBA Event Key, eg 2016nytr [required]
if_none_match Option<String> Value of the ETag header in the most recently cached response by the client.

Return type

Vecmodels::Match

Authorization

apiKey

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

get_team_event_status

models::TeamEventStatus get_team_event_status(team_key, event_key, if_none_match)

Gets the competition rank and status of the team at the given event.

Parameters

Name Type Description Required Notes
team_key String TBA Team Key, eg frc254 [required]
event_key String TBA Event Key, eg 2016nytr [required]
if_none_match Option<String> Value of the ETag header in the most recently cached response by the client.

Return type

models::TeamEventStatus

Authorization

apiKey

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

get_team_events

Vecmodels::Event get_team_events(team_key, if_none_match)

Gets a list of all events this team has competed at.

Parameters

Name Type Description Required Notes
team_key String TBA Team Key, eg frc254 [required]
if_none_match Option<String> Value of the ETag header in the most recently cached response by the client.

Return type

Vecmodels::Event

Authorization

apiKey

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

get_team_events_by_year

Vecmodels::Event get_team_events_by_year(team_key, year, if_none_match)

Gets a list of events this team has competed at in the given year.

Parameters

Name Type Description Required Notes
team_key String TBA Team Key, eg frc254 [required]
year i32 Competition Year (or Season). Must be 4 digits. [required]
if_none_match Option<String> Value of the ETag header in the most recently cached response by the client.

Return type

Vecmodels::Event

Authorization

apiKey

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

get_team_events_by_year_keys

Vec get_team_events_by_year_keys(team_key, year, if_none_match)

Gets a list of the event keys for events this team has competed at in the given year.

Parameters

Name Type Description Required Notes
team_key String TBA Team Key, eg frc254 [required]
year i32 Competition Year (or Season). Must be 4 digits. [required]
if_none_match Option<String> Value of the ETag header in the most recently cached response by the client.

Return type

Vec

Authorization

apiKey

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

get_team_events_by_year_simple

Vecmodels::EventSimple get_team_events_by_year_simple(team_key, year, if_none_match)

Gets a short-form list of events this team has competed at in the given year.

Parameters

Name Type Description Required Notes
team_key String TBA Team Key, eg frc254 [required]
year i32 Competition Year (or Season). Must be 4 digits. [required]
if_none_match Option<String> Value of the ETag header in the most recently cached response by the client.

Return type

Vecmodels::EventSimple

Authorization

apiKey

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

get_team_events_keys

Vec get_team_events_keys(team_key, if_none_match)

Gets a list of the event keys for all events this team has competed at.

Parameters

Name Type Description Required Notes
team_key String TBA Team Key, eg frc254 [required]
if_none_match Option<String> Value of the ETag header in the most recently cached response by the client.

Return type

Vec

Authorization

apiKey

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

get_team_events_simple

Vecmodels::EventSimple get_team_events_simple(team_key, if_none_match)

Gets a short-form list of all events this team has competed at.

Parameters

Name Type Description Required Notes
team_key String TBA Team Key, eg frc254 [required]
if_none_match Option<String> Value of the ETag header in the most recently cached response by the client.

Return type

Vecmodels::EventSimple

Authorization

apiKey

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

get_team_events_statuses_by_year

std::collections::HashMap<String, models::GetTeamEventsStatusesByYear200ResponseValue> get_team_events_statuses_by_year(team_key, year, if_none_match)

Gets a key-value list of the event statuses for events this team has competed at in the given year.

Parameters

Name Type Description Required Notes
team_key String TBA Team Key, eg frc254 [required]
year i32 Competition Year (or Season). Must be 4 digits. [required]
if_none_match Option<String> Value of the ETag header in the most recently cached response by the client.

Return type

std::collections::HashMap<String, models::GetTeamEventsStatusesByYear200ResponseValue>

Authorization

apiKey

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]