/*
* 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 [`matches_get`]
#[derive(Clone, Debug)]
pub struct MatchesGetParams {
/// Either a public ID (`match_<ulid>`, case-insensitive) or a match 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 `match_<ulid>`.
pub game: Option<String>
}
/// struct for passing parameters to the method [`matches_list`]
#[derive(Clone, Debug)]
pub struct MatchesListParams {
/// 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>,
/// Items per page. 1-200, default 50. (Pro+ on `/v1/matches` may request up to 10k via `?bulk=true`.)
pub limit: Option<i32>,
/// Pro+ only. Returns up to 10k matches per page instead of the cursor-default 50. Free/Hobbyist callers get 402.
pub bulk: Option<bool>,
pub game: Option<String>,
pub status: Option<String>,
pub league_id: Option<i64>,
pub series_id: Option<i64>,
pub tournament_id: Option<i64>,
pub from: Option<chrono::NaiveDate>,
pub to: Option<chrono::NaiveDate>,
/// Order results by soonest scheduled start (`scheduled_at` ascending, then id). Omitted, results follow insertion order.
pub sort: Option<String>
}
/// struct for passing parameters to the method [`matches_live`]
#[derive(Clone, Debug)]
pub struct MatchesLiveParams {
/// Either a `match_<ulid>` public id or a match slug. Slug requires `?game=`.
pub id: String,
/// Required when `id` is a slug.
pub game: Option<String>
}
/// struct for passing parameters to the method [`matches_preview`]
#[derive(Clone, Debug)]
pub struct MatchesPreviewParams {
/// Either a `match_<ulid>` public id or a match slug. Slug requires `?game=`.
pub id: String,
/// Required when `id` is a slug.
pub game: Option<String>
}
/// struct for passing parameters to the method [`matches_rounds`]
#[derive(Clone, Debug)]
pub struct MatchesRoundsParams {
/// Either a `match_<ulid>` public id or a match slug. Slug requires `?game=`.
pub id: String,
/// Required when `id` is a slug.
pub game: Option<String>
}
/// struct for passing parameters to the method [`matches_scoreboard`]
#[derive(Clone, Debug)]
pub struct MatchesScoreboardParams {
/// Either a `match_<ulid>` public id or a match slug. Slug requires `?game=`.
pub id: String,
/// Required when `id` is a slug.
pub game: Option<String>
}
/// struct for typed errors of method [`matches_get`]
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(untagged)]
pub enum MatchesGetError {
Status400(models::ErrorEnvelope),
Status401(models::ErrorEnvelope),
Status404(models::ErrorEnvelope),
Status429(models::ErrorEnvelope),
UnknownValue(serde_json::Value),
}
/// struct for typed errors of method [`matches_list`]
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(untagged)]
pub enum MatchesListError {
Status400(models::ErrorEnvelope),
Status401(models::ErrorEnvelope),
Status402(models::ErrorEnvelope),
Status429(models::ErrorEnvelope),
UnknownValue(serde_json::Value),
}
/// struct for typed errors of method [`matches_live`]
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(untagged)]
pub enum MatchesLiveError {
Status400(models::ErrorEnvelope),
Status401(models::ErrorEnvelope),
Status402(models::ErrorEnvelope),
Status404(models::ErrorEnvelope),
Status429(models::ErrorEnvelope),
UnknownValue(serde_json::Value),
}
/// struct for typed errors of method [`matches_preview`]
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(untagged)]
pub enum MatchesPreviewError {
Status400(models::ErrorEnvelope),
Status401(models::ErrorEnvelope),
Status402(models::ErrorEnvelope),
Status404(models::ErrorEnvelope),
Status429(models::ErrorEnvelope),
UnknownValue(serde_json::Value),
}
/// struct for typed errors of method [`matches_rounds`]
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(untagged)]
pub enum MatchesRoundsError {
Status400(models::ErrorEnvelope),
Status401(models::ErrorEnvelope),
Status402(models::ErrorEnvelope),
Status404(models::ErrorEnvelope),
Status429(models::ErrorEnvelope),
UnknownValue(serde_json::Value),
}
/// struct for typed errors of method [`matches_scoreboard`]
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(untagged)]
pub enum MatchesScoreboardError {
Status400(models::ErrorEnvelope),
Status401(models::ErrorEnvelope),
Status402(models::ErrorEnvelope),
Status404(models::ErrorEnvelope),
Status429(models::ErrorEnvelope),
UnknownValue(serde_json::Value),
}
pub async fn matches_get(configuration: &configuration::Configuration, params: MatchesGetParams) -> Result<models::MatchEnvelope, Error<MatchesGetError>> {
let uri_str = format!("{}/v1/matches/{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::MatchEnvelope`"))),
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::MatchEnvelope`")))),
}
} else {
let content = resp.text().await?;
let entity: Option<MatchesGetError> = serde_json::from_str(&content).ok();
Err(Error::ResponseError(ResponseContent { status, content, entity }))
}
}
/// Returns matches with denormalized league/series/tournament summaries. Stats (per-player KDA / per-map team aggregates) are gated to Hobbyist+ via the `match_stats` capability — Free-tier sees scores + status only. Bulk export (`?bulk=true`) is Pro+ via `bulk_export` capability and allows up to 10k matches per page.
pub async fn matches_list(configuration: &configuration::Configuration, params: MatchesListParams) -> Result<models::MatchesListResponse, Error<MatchesListError>> {
let uri_str = format!("{}/v1/matches", configuration.base_path);
let mut req_builder = configuration.client.request(reqwest::Method::GET, &uri_str);
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.limit {
req_builder = req_builder.query(&[("limit", ¶m_value.to_string())]);
}
if let Some(ref param_value) = params.bulk {
req_builder = req_builder.query(&[("bulk", ¶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.status {
req_builder = req_builder.query(&[("status", ¶m_value.to_string())]);
}
if let Some(ref param_value) = params.league_id {
req_builder = req_builder.query(&[("league_id", ¶m_value.to_string())]);
}
if let Some(ref param_value) = params.series_id {
req_builder = req_builder.query(&[("series_id", ¶m_value.to_string())]);
}
if let Some(ref param_value) = params.tournament_id {
req_builder = req_builder.query(&[("tournament_id", ¶m_value.to_string())]);
}
if let Some(ref param_value) = params.from {
req_builder = req_builder.query(&[("from", ¶m_value.to_string())]);
}
if let Some(ref param_value) = params.to {
req_builder = req_builder.query(&[("to", ¶m_value.to_string())]);
}
if let Some(ref param_value) = params.sort {
req_builder = req_builder.query(&[("sort", ¶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<MatchesListError> = serde_json::from_str(&content).ok();
Err(Error::ResponseError(ResponseContent { status, content, entity }))
}
}
/// Polling-friendly projection of the per-game / per-map state for a single match. Surfaces the current in-progress game, per-team kill counts, the series score, and a freshness timestamp so clients can back off polling on stale series. Matches without an upstream live-state counterpart return 200 with an empty `games` array and `live_data_source: \"liquipedia\"` — clients should not poll these matches. Scale+ via the `live` capability. Responses ship `Cache-Control: max-age=15` so polling at 1 Hz still hits the cache about 14 times out of 15.
pub async fn matches_live(configuration: &configuration::Configuration, params: MatchesLiveParams) -> Result<models::MatchLiveEnvelope, Error<MatchesLiveError>> {
let uri_str = format!("{}/v1/matches/{id}/live", 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::MatchLiveEnvelope`"))),
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::MatchLiveEnvelope`")))),
}
} else {
let content = resp.text().await?;
let entity: Option<MatchesLiveError> = serde_json::from_str(&content).ok();
Err(Error::ResponseError(ResponseContent { status, content, entity }))
}
}
/// Pre-match form (last-N results, 30-day wins/losses), head-to-head record, and last-5 matches per team. CS2 matches additionally carry `cs2_specific` with map veto history when the upstream carried structured veto data. Pro+ via `match_preview` capability. Derived from completed matches in our match-history corpus — attribution is included in `meta.sources` when applicable. Responses ship `Cache-Control: max-age=120`.
pub async fn matches_preview(configuration: &configuration::Configuration, params: MatchesPreviewParams) -> Result<models::MatchPreviewEnvelope, Error<MatchesPreviewError>> {
let uri_str = format!("{}/v1/matches/{id}/preview", 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::MatchPreviewEnvelope`"))),
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::MatchPreviewEnvelope`")))),
}
} else {
let content = resp.text().await?;
let entity: Option<MatchesPreviewError> = serde_json::from_str(&content).ok();
Err(Error::ResponseError(ResponseContent { status, content, entity }))
}
}
/// Round-by-round breakdown for a CS2 match — per round: the winning side, the round-end condition (`win_type`), and the T/CT side each team played. Sourced from the GRID Live Data Feed. Available only for matches linked to a GRID counterpart; others return 200 with an empty `rounds` array. Hobbyist+ via the `match_stats` capability. Responses ship `Cache-Control: max-age=15`.
pub async fn matches_rounds(configuration: &configuration::Configuration, params: MatchesRoundsParams) -> Result<models::MatchRoundsEnvelope, Error<MatchesRoundsError>> {
let uri_str = format!("{}/v1/matches/{id}/rounds", 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::MatchRoundsEnvelope`"))),
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::MatchRoundsEnvelope`")))),
}
} else {
let content = resp.text().await?;
let entity: Option<MatchesRoundsError> = serde_json::from_str(&content).ok();
Err(Error::ResponseError(ResponseContent { status, content, entity }))
}
}
/// Per-map per-player scoreboard for a CS2 match — kills, deaths, assists, headshots, damage, and end-of-map economy (money, loadout value, net worth). Sourced from the GRID Live Data Feed. Available only for matches linked to a GRID counterpart; others return 200 with an empty `players` array. Hobbyist+ via the `match_stats` capability. Responses ship `Cache-Control: max-age=15`.
pub async fn matches_scoreboard(configuration: &configuration::Configuration, params: MatchesScoreboardParams) -> Result<models::MatchScoreboardEnvelope, Error<MatchesScoreboardError>> {
let uri_str = format!("{}/v1/matches/{id}/scoreboard", 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::MatchScoreboardEnvelope`"))),
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::MatchScoreboardEnvelope`")))),
}
} else {
let content = resp.text().await?;
let entity: Option<MatchesScoreboardError> = serde_json::from_str(&content).ok();
Err(Error::ResponseError(ResponseContent { status, content, entity }))
}
}