/*
* Stadar Esports Data API
*
* Read-only, betting-friendly esports data across all major competitive titles. Flat-tier pricing (no per-game gates), Polar- billed subscriptions (Merchant of Record), 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 {
pub id: 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.next_cursor` to fetch the next page. Cursors are valid for at least 24 hours; treat them as opaque strings.
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>
}
/// struct for passing parameters to the method [`matches_preview`]
#[derive(Clone, Debug)]
pub struct MatchesPreviewParams {
pub id: String
}
/// struct for typed errors of method [`matches_get`]
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(untagged)]
pub enum MatchesGetError {
Status404(models::ErrorEnvelope),
UnknownValue(serde_json::Value),
}
/// struct for typed errors of method [`matches_list`]
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(untagged)]
pub enum MatchesListError {
Status402(models::ErrorEnvelope),
UnknownValue(serde_json::Value),
}
/// struct for typed errors of method [`matches_preview`]
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(untagged)]
pub enum MatchesPreviewError {
Status402(models::ErrorEnvelope),
Status404(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 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 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 }))
}
}
/// 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 bo3.gg source exposed it. Pro+ via `match_preview` capability. Derived from completed matches in our match-history corpus — Liquipedia-derived attribution is included in `meta.sources` when applicable. Client may cache via `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 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 }))
}
}