/*
* Stadar Esports Data API
*
* Read-only esports data across all major competitive titles. Flat-tier pricing (no per-game gates), monthly subscriptions, sandbox keys for evaluation. See https://stadar.net for tier pricing. All endpoints under `/v1/...`. The version in `info.version` matches the URL prefix; non-breaking field additions ship in `/v1`, breaking changes get a `/v2`. We commit to 24 months of `/v1` support after `/v2` ships. Times are UTC end-to-end (RFC 3339). Localization is the client's problem. Cursors are opaque base64 strings; treat them as such.
*
* The version of the OpenAPI document: v1
* Contact: api@stadar.net
* Generated by: https://openapi-generator.tech
*/
use reqwest;
use serde::{Deserialize, Serialize, de::Error as _};
use crate::{apis::ResponseContent, models};
use super::{Error, configuration, ContentType};
/// struct for passing parameters to the method [`teams_get`]
#[derive(Clone, Debug)]
pub struct TeamsGetParams {
/// Either a public ID (`team_<ulid>`, case-insensitive) or a team slug. Slugs require the `?game=` query param to scope the lookup; passing a slug without `?game=` 400s.
pub id: String,
/// Required when `id` is a slug. Ignored when `id` is a `team_<ulid>`.
pub game: Option<String>
}
/// struct for passing parameters to the method [`teams_head_to_head`]
#[derive(Clone, Debug)]
pub struct TeamsHeadToHeadParams {
/// Either a `team_<ulid>` public id or a team slug.
pub id: String,
/// Either a `team_<ulid>` public id or a team slug.
pub opponent: String,
/// Required when either `id` or `opponent` is a slug.
pub game: Option<String>,
/// Items per page. 1-200, default 50. (Pro+ on `/v1/matches` may request up to 10k via `?bulk=true`.)
pub limit: Option<i32>
}
/// struct for passing parameters to the method [`teams_list`]
#[derive(Clone, Debug)]
pub struct TeamsListParams {
/// Items per page. 1-200, default 50. (Pro+ on `/v1/matches` may request up to 10k via `?bulk=true`.)
pub limit: Option<i32>,
/// Opaque pagination cursor. Hand back the value from `meta.paging.cursor` to fetch the next page; stop when `meta.paging.has_more` is false. Cursors are valid for at least 24 hours and signed against a per-deployment secret — treat them as opaque strings. The wire format may change in a backwards-compatible way (a future cursor will still satisfy the regex above).
pub cursor: Option<String>,
/// Restrict to one game slug (e.g. `lol`, `cs2`).
pub game: Option<String>,
/// Restrict to one region (e.g. `na`, `eu`, `sea`).
pub region: Option<String>,
/// Case-insensitive substring match on team name, acronym, or slug. Minimum 2 characters. The fastest way to resolve a team by name.
pub search: Option<String>
}
/// struct for passing parameters to the method [`teams_matches`]
#[derive(Clone, Debug)]
pub struct TeamsMatchesParams {
/// Either a `team_<ulid>` public id or a team slug. Slug requires `?game=`.
pub id: String,
/// Required when `id` is a slug.
pub game: Option<String>,
/// Items per page. 1-200, default 50. (Pro+ on `/v1/matches` may request up to 10k via `?bulk=true`.)
pub limit: Option<i32>,
/// Opaque pagination cursor. Hand back the value from `meta.paging.cursor` to fetch the next page; stop when `meta.paging.has_more` is false. Cursors are valid for at least 24 hours and signed against a per-deployment secret — treat them as opaque strings. The wire format may change in a backwards-compatible way (a future cursor will still satisfy the regex above).
pub cursor: Option<String>,
pub status: Option<String>
}
/// struct for passing parameters to the method [`teams_roster`]
#[derive(Clone, Debug)]
pub struct TeamsRosterParams {
/// Either a `team_<ulid>` public id or a team slug. Slug requires `?game=`.
pub id: String,
/// Required when `id` is a slug.
pub game: Option<String>,
pub include_former: Option<bool>
}
/// struct for passing parameters to the method [`teams_stats`]
#[derive(Clone, Debug)]
pub struct TeamsStatsParams {
/// Either a `team_<ulid>` public id or a team slug. Slug requires `?game=`.
pub id: String,
/// Required when `id` is a slug.
pub game: Option<String>
}
/// struct for typed errors of method [`teams_get`]
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(untagged)]
pub enum TeamsGetError {
Status400(models::ErrorEnvelope),
Status401(models::ErrorEnvelope),
Status404(models::ErrorEnvelope),
Status429(models::ErrorEnvelope),
UnknownValue(serde_json::Value),
}
/// struct for typed errors of method [`teams_head_to_head`]
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(untagged)]
pub enum TeamsHeadToHeadError {
Status400(models::ErrorEnvelope),
Status401(models::ErrorEnvelope),
Status404(models::ErrorEnvelope),
Status429(models::ErrorEnvelope),
UnknownValue(serde_json::Value),
}
/// struct for typed errors of method [`teams_list`]
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(untagged)]
pub enum TeamsListError {
Status400(models::ErrorEnvelope),
Status401(models::ErrorEnvelope),
Status429(models::ErrorEnvelope),
UnknownValue(serde_json::Value),
}
/// struct for typed errors of method [`teams_matches`]
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(untagged)]
pub enum TeamsMatchesError {
Status400(models::ErrorEnvelope),
Status401(models::ErrorEnvelope),
Status404(models::ErrorEnvelope),
Status429(models::ErrorEnvelope),
UnknownValue(serde_json::Value),
}
/// struct for typed errors of method [`teams_roster`]
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(untagged)]
pub enum TeamsRosterError {
Status400(models::ErrorEnvelope),
Status401(models::ErrorEnvelope),
Status404(models::ErrorEnvelope),
Status429(models::ErrorEnvelope),
UnknownValue(serde_json::Value),
}
/// struct for typed errors of method [`teams_stats`]
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(untagged)]
pub enum TeamsStatsError {
Status400(models::ErrorEnvelope),
Status401(models::ErrorEnvelope),
Status404(models::ErrorEnvelope),
Status429(models::ErrorEnvelope),
UnknownValue(serde_json::Value),
}
/// Single team detail including enrichment fields (coach, manager, social handles) when known from upstream sources.
pub async fn teams_get(configuration: &configuration::Configuration, params: TeamsGetParams) -> Result<models::TeamEnvelope, Error<TeamsGetError>> {
let uri_str = format!("{}/v1/teams/{id}", configuration.base_path, id=crate::apis::urlencode(params.id));
let mut req_builder = configuration.client.request(reqwest::Method::GET, &uri_str);
if let Some(ref param_value) = params.game {
req_builder = req_builder.query(&[("game", ¶m_value.to_string())]);
}
if let Some(ref user_agent) = configuration.user_agent {
req_builder = req_builder.header(reqwest::header::USER_AGENT, user_agent.clone());
}
if let Some(ref token) = configuration.bearer_access_token {
req_builder = req_builder.bearer_auth(token.to_owned());
};
let req = req_builder.build()?;
let resp = configuration.client.execute(req).await?;
let status = resp.status();
let content_type = resp
.headers()
.get("content-type")
.and_then(|v| v.to_str().ok())
.unwrap_or("application/octet-stream");
let content_type = super::ContentType::from(content_type);
if !status.is_client_error() && !status.is_server_error() {
let content = resp.text().await?;
match content_type {
ContentType::Json => serde_json::from_str(&content).map_err(Error::from),
ContentType::Text => return Err(Error::from(serde_json::Error::custom("Received `text/plain` content type response that cannot be converted to `models::TeamEnvelope`"))),
ContentType::Unsupported(unknown_type) => return Err(Error::from(serde_json::Error::custom(format!("Received `{unknown_type}` content type response that cannot be converted to `models::TeamEnvelope`")))),
}
} else {
let content = resp.text().await?;
let entity: Option<TeamsGetError> = serde_json::from_str(&content).ok();
Err(Error::ResponseError(ResponseContent { status, content, entity }))
}
}
/// Completed-match head-to-head record between two teams. Returns aggregate wins per side plus the recent matches list. Counts BO-N series only (no per-map breakdown — for that, fetch each match individually). Both path segments accept either id or slug; slugs require a single `?game=` scope shared by both teams (h2h within one game is the only sensible shape).
pub async fn teams_head_to_head(configuration: &configuration::Configuration, params: TeamsHeadToHeadParams) -> Result<models::TeamHeadToHeadEnvelope, Error<TeamsHeadToHeadError>> {
let uri_str = format!("{}/v1/teams/{id}/h2h/{opponent}", configuration.base_path, id=crate::apis::urlencode(params.id), opponent=crate::apis::urlencode(params.opponent));
let mut req_builder = configuration.client.request(reqwest::Method::GET, &uri_str);
if let Some(ref param_value) = params.game {
req_builder = req_builder.query(&[("game", ¶m_value.to_string())]);
}
if let Some(ref param_value) = params.limit {
req_builder = req_builder.query(&[("limit", ¶m_value.to_string())]);
}
if let Some(ref user_agent) = configuration.user_agent {
req_builder = req_builder.header(reqwest::header::USER_AGENT, user_agent.clone());
}
if let Some(ref token) = configuration.bearer_access_token {
req_builder = req_builder.bearer_auth(token.to_owned());
};
let req = req_builder.build()?;
let resp = configuration.client.execute(req).await?;
let status = resp.status();
let content_type = resp
.headers()
.get("content-type")
.and_then(|v| v.to_str().ok())
.unwrap_or("application/octet-stream");
let content_type = super::ContentType::from(content_type);
if !status.is_client_error() && !status.is_server_error() {
let content = resp.text().await?;
match content_type {
ContentType::Json => serde_json::from_str(&content).map_err(Error::from),
ContentType::Text => return Err(Error::from(serde_json::Error::custom("Received `text/plain` content type response that cannot be converted to `models::TeamHeadToHeadEnvelope`"))),
ContentType::Unsupported(unknown_type) => return Err(Error::from(serde_json::Error::custom(format!("Received `{unknown_type}` content type response that cannot be converted to `models::TeamHeadToHeadEnvelope`")))),
}
} else {
let content = resp.text().await?;
let entity: Option<TeamsHeadToHeadError> = serde_json::from_str(&content).ok();
Err(Error::ResponseError(ResponseContent { status, content, entity }))
}
}
/// Paginated list of teams across every game we cover. Filter by `?game=<slug>` or `?region=<slug>`. Available on every tier; Liquipedia-derived rows are attributed automatically in `meta.sources`.
pub async fn teams_list(configuration: &configuration::Configuration, params: TeamsListParams) -> Result<models::TeamsListResponse, Error<TeamsListError>> {
let uri_str = format!("{}/v1/teams", configuration.base_path);
let mut req_builder = configuration.client.request(reqwest::Method::GET, &uri_str);
if let Some(ref param_value) = params.limit {
req_builder = req_builder.query(&[("limit", ¶m_value.to_string())]);
}
if let Some(ref param_value) = params.cursor {
req_builder = req_builder.query(&[("cursor", ¶m_value.to_string())]);
}
if let Some(ref param_value) = params.game {
req_builder = req_builder.query(&[("game", ¶m_value.to_string())]);
}
if let Some(ref param_value) = params.region {
req_builder = req_builder.query(&[("region", ¶m_value.to_string())]);
}
if let Some(ref param_value) = params.search {
req_builder = req_builder.query(&[("search", ¶m_value.to_string())]);
}
if let Some(ref user_agent) = configuration.user_agent {
req_builder = req_builder.header(reqwest::header::USER_AGENT, user_agent.clone());
}
if let Some(ref token) = configuration.bearer_access_token {
req_builder = req_builder.bearer_auth(token.to_owned());
};
let req = req_builder.build()?;
let resp = configuration.client.execute(req).await?;
let status = resp.status();
let content_type = resp
.headers()
.get("content-type")
.and_then(|v| v.to_str().ok())
.unwrap_or("application/octet-stream");
let content_type = super::ContentType::from(content_type);
if !status.is_client_error() && !status.is_server_error() {
let content = resp.text().await?;
match content_type {
ContentType::Json => serde_json::from_str(&content).map_err(Error::from),
ContentType::Text => return Err(Error::from(serde_json::Error::custom("Received `text/plain` content type response that cannot be converted to `models::TeamsListResponse`"))),
ContentType::Unsupported(unknown_type) => return Err(Error::from(serde_json::Error::custom(format!("Received `{unknown_type}` content type response that cannot be converted to `models::TeamsListResponse`")))),
}
} else {
let content = resp.text().await?;
let entity: Option<TeamsListError> = serde_json::from_str(&content).ok();
Err(Error::ResponseError(ResponseContent { status, content, entity }))
}
}
/// Match history for a team, latest-first. Returns the same shape as `/v1/matches`. Hand the opaque cursor value back via `?cursor=` for the next page.
pub async fn teams_matches(configuration: &configuration::Configuration, params: TeamsMatchesParams) -> Result<models::MatchesListResponse, Error<TeamsMatchesError>> {
let uri_str = format!("{}/v1/teams/{id}/matches", configuration.base_path, id=crate::apis::urlencode(params.id));
let mut req_builder = configuration.client.request(reqwest::Method::GET, &uri_str);
if let Some(ref param_value) = params.game {
req_builder = req_builder.query(&[("game", ¶m_value.to_string())]);
}
if let Some(ref param_value) = params.limit {
req_builder = req_builder.query(&[("limit", ¶m_value.to_string())]);
}
if let Some(ref param_value) = params.cursor {
req_builder = req_builder.query(&[("cursor", ¶m_value.to_string())]);
}
if let Some(ref param_value) = params.status {
req_builder = req_builder.query(&[("status", ¶m_value.to_string())]);
}
if let Some(ref user_agent) = configuration.user_agent {
req_builder = req_builder.header(reqwest::header::USER_AGENT, user_agent.clone());
}
if let Some(ref token) = configuration.bearer_access_token {
req_builder = req_builder.bearer_auth(token.to_owned());
};
let req = req_builder.build()?;
let resp = configuration.client.execute(req).await?;
let status = resp.status();
let content_type = resp
.headers()
.get("content-type")
.and_then(|v| v.to_str().ok())
.unwrap_or("application/octet-stream");
let content_type = super::ContentType::from(content_type);
if !status.is_client_error() && !status.is_server_error() {
let content = resp.text().await?;
match content_type {
ContentType::Json => serde_json::from_str(&content).map_err(Error::from),
ContentType::Text => return Err(Error::from(serde_json::Error::custom("Received `text/plain` content type response that cannot be converted to `models::MatchesListResponse`"))),
ContentType::Unsupported(unknown_type) => return Err(Error::from(serde_json::Error::custom(format!("Received `{unknown_type}` content type response that cannot be converted to `models::MatchesListResponse`")))),
}
} else {
let content = resp.text().await?;
let entity: Option<TeamsMatchesError> = serde_json::from_str(&content).ok();
Err(Error::ResponseError(ResponseContent { status, content, entity }))
}
}
/// Current roster of a team — by default, only active members. Pass `?include_former=true` to include departed players (active=false on their team_players row).
pub async fn teams_roster(configuration: &configuration::Configuration, params: TeamsRosterParams) -> Result<models::TeamRosterEnvelope, Error<TeamsRosterError>> {
let uri_str = format!("{}/v1/teams/{id}/roster", configuration.base_path, id=crate::apis::urlencode(params.id));
let mut req_builder = configuration.client.request(reqwest::Method::GET, &uri_str);
if let Some(ref param_value) = params.game {
req_builder = req_builder.query(&[("game", ¶m_value.to_string())]);
}
if let Some(ref param_value) = params.include_former {
req_builder = req_builder.query(&[("include_former", ¶m_value.to_string())]);
}
if let Some(ref user_agent) = configuration.user_agent {
req_builder = req_builder.header(reqwest::header::USER_AGENT, user_agent.clone());
}
if let Some(ref token) = configuration.bearer_access_token {
req_builder = req_builder.bearer_auth(token.to_owned());
};
let req = req_builder.build()?;
let resp = configuration.client.execute(req).await?;
let status = resp.status();
let content_type = resp
.headers()
.get("content-type")
.and_then(|v| v.to_str().ok())
.unwrap_or("application/octet-stream");
let content_type = super::ContentType::from(content_type);
if !status.is_client_error() && !status.is_server_error() {
let content = resp.text().await?;
match content_type {
ContentType::Json => serde_json::from_str(&content).map_err(Error::from),
ContentType::Text => return Err(Error::from(serde_json::Error::custom("Received `text/plain` content type response that cannot be converted to `models::TeamRosterEnvelope`"))),
ContentType::Unsupported(unknown_type) => return Err(Error::from(serde_json::Error::custom(format!("Received `{unknown_type}` content type response that cannot be converted to `models::TeamRosterEnvelope`")))),
}
} else {
let content = resp.text().await?;
let entity: Option<TeamsRosterError> = serde_json::from_str(&content).ok();
Err(Error::ResponseError(ResponseContent { status, content, entity }))
}
}
/// Win/loss totals + per-game breakdown for a team.
pub async fn teams_stats(configuration: &configuration::Configuration, params: TeamsStatsParams) -> Result<models::TeamStatsEnvelope, Error<TeamsStatsError>> {
let uri_str = format!("{}/v1/teams/{id}/stats", configuration.base_path, id=crate::apis::urlencode(params.id));
let mut req_builder = configuration.client.request(reqwest::Method::GET, &uri_str);
if let Some(ref param_value) = params.game {
req_builder = req_builder.query(&[("game", ¶m_value.to_string())]);
}
if let Some(ref user_agent) = configuration.user_agent {
req_builder = req_builder.header(reqwest::header::USER_AGENT, user_agent.clone());
}
if let Some(ref token) = configuration.bearer_access_token {
req_builder = req_builder.bearer_auth(token.to_owned());
};
let req = req_builder.build()?;
let resp = configuration.client.execute(req).await?;
let status = resp.status();
let content_type = resp
.headers()
.get("content-type")
.and_then(|v| v.to_str().ok())
.unwrap_or("application/octet-stream");
let content_type = super::ContentType::from(content_type);
if !status.is_client_error() && !status.is_server_error() {
let content = resp.text().await?;
match content_type {
ContentType::Json => serde_json::from_str(&content).map_err(Error::from),
ContentType::Text => return Err(Error::from(serde_json::Error::custom("Received `text/plain` content type response that cannot be converted to `models::TeamStatsEnvelope`"))),
ContentType::Unsupported(unknown_type) => return Err(Error::from(serde_json::Error::custom(format!("Received `{unknown_type}` content type response that cannot be converted to `models::TeamStatsEnvelope`")))),
}
} else {
let content = resp.text().await?;
let entity: Option<TeamsStatsError> = serde_json::from_str(&content).ok();
Err(Error::ResponseError(ResponseContent { status, content, entity }))
}
}