FACEIT API

Посмотреть три примера карточки игрока: полученные показатели, отсутствующие данные и сбой запроса истории.

1. Найдите игрокаПередайте SteamID64 в game_player_id с game=cs2. Читайте ELO и уровень из games.cs2.faceit_elo и games.cs2.skill_level.
2. Сохраните идентификатор игрока FACEITИспользуйте полученный player_id в путях запросов статистики и истории. SteamID64 и никнейм не заменяют этот идентификатор.
3. Запросите нужные дополнительные данныеОбщая статистика находится в lifetime; необязательный segments[] содержит разрезы Map или Competition с режимом mode из того же ответа. Метка Competition является идентификатором соревнования, а не его названием. Матчи находятся в items[]; необязательный match_stats.Headshots содержит число хедшотов, а не процент. История принимает limit от 1 до 20. Для выбора страницы используйте отдельный HTTP-запрос с page от 0 до 100. Позиции страниц могут меняться.

Скачайте руководство по полям и страницам FACEIT (Markdown, англ.). В нём описаны границы данных, необязательные поля и явный HTTP-запрос страницы; SDK 1.3.0 запрашивает только первую страницу истории.

Храните WOK_API_KEY и WOK_STEAM_ID из 17 цифр в окружении сервера. Нужен ключ тарифа Players или универсального тарифа с доступом к FACEIT; отдельный ключ FACEIT не требуется. Не размещайте ключ WOK в коде браузера, сообщениях бота или публичных URL.

Три запроса через cURL

# Задайте WOK_API_KEY и WOK_STEAM_ID в окружении сервера.
set -eu
curl --fail-with-body --max-time 35 --get \
  -H "Authorization: Bearer $WOK_API_KEY" \
  "https://woksteamapi.com/faceit/data/v4/players" \
  --data-urlencode "game=cs2" \
  --data-urlencode "game_player_id=$WOK_STEAM_ID"

# Сохраните player_id из ответа в WOK_FACEIT_PLAYER_ID.
curl --fail-with-body --max-time 35 \
  -H "Authorization: Bearer $WOK_API_KEY" \
  "https://woksteamapi.com/faceit/data/v4/players/$WOK_FACEIT_PLAYER_ID/stats/cs2"
curl --fail-with-body --max-time 35 \
  -H "Authorization: Bearer $WOK_API_KEY" \
  "https://woksteamapi.com/faceit/data/v4/players/$WOK_FACEIT_PLAYER_ID/history?game=cs2&limit=5"

# Python 3: установите requests; задайте WOK_API_KEY и WOK_STEAM_ID.
import json
import os
import re
import requests

steam_id = os.environ["WOK_STEAM_ID"]
if not re.fullmatch(r"[0-9]{17}", steam_id):
    raise SystemExit("WOK_STEAM_ID должен содержать SteamID64 из 17 цифр")
session = requests.Session()
session.headers["Authorization"] = f"Bearer {os.environ['WOK_API_KEY']}"

def read(path, params=None, *, allow_missing=False):
    response = session.get("https://woksteamapi.com" + path,
                           params=params, timeout=(5, 30),
                           allow_redirects=False)
    if allow_missing and response.status_code == 404:
        return None
    response.raise_for_status()  # Остановиться при ошибке ключа, квоты или источника.
    return response.json()

profile = read("/faceit/data/v4/players", {
    "game": "cs2", "game_player_id": steam_id,
}, allow_missing=True)
if profile is None:
    raise SystemExit("Для этого SteamID64 не найден профиль FACEIT CS2")
player_id = profile.get("player_id", "")
if not re.fullmatch(r"[A-Za-z0-9-]{1,64}", player_id):
    raise SystemExit("В профиле отсутствует допустимый player_id")
# Эти два запроса необязательны: запрашивайте только нужные странице данные.
stats = read(f"/faceit/data/v4/players/{player_id}/stats/cs2")
history = read(f"/faceit/data/v4/players/{player_id}/history",
               {"game": "cs2", "limit": 5})
print(json.dumps({
    "nickname": profile.get("nickname"),
    "rank": profile.get("games", {}).get("cs2", {}),
    "lifetime": stats.get("lifetime", {}),
    "recent_matches": history.get("items", []),
}, indent=2))

// Node.js 18+: задайте WOK_API_KEY и WOK_STEAM_ID на сервере.
const key = process.env.WOK_API_KEY;
const steamId = process.env.WOK_STEAM_ID;
if (!key || !/^[0-9]{17}$/.test(steamId || "")) {
  throw new Error("Задайте WOK_API_KEY и WOK_STEAM_ID из 17 цифр");
}
async function read(path, params = {}, allowMissing = false) {
  const url = new URL(path, "https://woksteamapi.com");
  url.search = new URLSearchParams(params);
  const response = await fetch(url, {
    headers: { Authorization: `Bearer ${key}` },
    signal: AbortSignal.timeout(35_000),
    redirect: "error"
  });
  if (allowMissing && response.status === 404) return null;
  if (!response.ok) throw new Error(`WOK HTTP ${response.status}`);
  return response.json();
}
const profile = await read("/faceit/data/v4/players", {
  game: "cs2", game_player_id: steamId
}, true);
if (!profile) throw new Error("Для этого SteamID64 не найден профиль FACEIT CS2");
if (!/^[A-Za-z0-9-]{1,64}$/.test(profile.player_id || "")) {
  throw new Error("В профиле отсутствует допустимый player_id");
}
const playerPath = `/faceit/data/v4/players/${encodeURIComponent(profile.player_id)}`;
// Необязательные запросы: получайте только нужные странице игрока данные.
const stats = await read(`${playerPath}/stats/cs2`);
const history = await read(`${playerPath}/history`, { game: "cs2", limit: "5" });
console.log({ nickname: profile.nickname, rank: profile.games?.cs2,
  lifetime: stats.lifetime, recent_matches: history.items });

Эти клиенты выполняют не более трёх запросов и останавливаются при ошибке; автоматических повторов нет. Полный сценарий расходует три единицы квоты, если все вызовы допущены к выполнению. Каждый запрос профиля, статистики или истории стоит одну единицу, включая ответ из кэша. GET /v1/key показывает доступ, остаток квоты и время сброса без расхода единицы запроса.

Читайте ответ, сохраняя неизвестные значения

Метрики lifetime, например Matches, Wins и Average K/D Ratio, при наличии возвращаются строками. Отсутствующее поле означает недоступные данные, а не ноль. Записи последних матчей могут содержать finished_at (Unix-время в секундах), elo, elo_delta и match_stats с картой, счётом, убийствами и смертями. Экранируйте имена и подписи перед вставкой в HTML.

Различайте отсутствие данных, проблемы доступа и временные сбои

Кэш и границы источника данных

Снимки профиля и общей статистики используют настраиваемый TTL кэша, по умолчанию — шесть часов. Ранг из кэша может отставать от только что завершённого матча. Для последних матчей нет постоянного кэша результатов: выполняется отдельный запрос к источнику с ограниченным временем ожидания. История также зависит от доступности FACEIT и не гарантирует немедленное появление завершённого матча. Эти ответы не содержат времени наблюдения или точного возраста кэша; время получения ответа вашим клиентом не подтверждает свежесть данных.

WOK адаптирует подтверждённые публичные поля сайта-источника и не обещает полное покрытие официального FACEIT API. Необязательные memberships и friends_count не подтверждают платную подписку или полноту списка друзей. Профили и инвентари Steam запрашиваются отдельно; ни один метод не открывает закрытые данные Steam.

{
  "profile": {
    "http_status": 200,
    "body": {
      "player_id": "example-player",
      "nickname": "Example player",
      "games": {
        "cs2": {
          "faceit_elo": 1450,
          "skill_level": 6
        }
      }
    }
  },
  "stats": {
    "http_status": 200,
    "body": {
      "lifetime": {
        "Matches": "120",
        "Wins": "68",
        "Average K/D Ratio": "1.10"
      }
    }
  },
  "history": {
    "http_status": 200,
    "body": {
      "start": 0,
      "end": 1,
      "items": [
        {
          "match_id": "example-match",
          "game_id": "cs2",
          "elo": 1450,
          "elo_delta": 20,
          "match_stats": {
            "Kills": "24",
            "Deaths": "16",
            "Headshots": "12"
          }
        }
      ]
    }
  }
}

{
  "profile": {
    "http_status": 200,
    "body": {
      "player_id": "example-player",
      "nickname": "Example player",
      "games": {
        "cs2": {
          "faceit_elo": 1450,
          "skill_level": 6
        }
      }
    }
  },
  "stats": {
    "http_status": 200,
    "body": {
      "lifetime": {}
    }
  },
  "history": {
    "http_status": 200,
    "body": {
      "start": 0,
      "end": 0,
      "items": []
    }
  }
}

{
  "profile": {
    "http_status": 200,
    "body": {
      "player_id": "example-player",
      "nickname": "Example player",
      "games": {
        "cs2": {
          "faceit_elo": 1450,
          "skill_level": 6
        }
      }
    }
  },
  "stats": {
    "http_status": 200,
    "body": {
      "lifetime": {
        "Matches": "0",
        "Wins": "0"
      }
    }
  },
  "history": {
    "http_status": 502
  }
}

Запустите общую карточку игрока Steam и FACEIT

Скачайте пример Steam + FACEIT на Python и следуйте инструкции по настройке и запуску (англ.). Связывайте два сервиса по найденному SteamID64; храните сведения Steam и ранг FACEIT в отдельных полях. Отсутствие аккаунта FACEIT не делает профиль Steam недействительным. Отсутствующий ранг и показатели lifetime оставляйте недоступными, не заменяйте нулём. Храните ключ WOK на сервере.

Полная справка API · Контракт OpenAPI · Добавить профиль Steam (англ.) · Обзор API CS2 (англ.) · Тарифы и лимиты запросов