Introduction
Partner JSON API of the Global Sport Systems ecosystem: teams, players, tournaments, games, standings, statistics and photo albums.
The Global Sport Systems API gives partner sites read access to the data of their
leagues: tournaments, schedules, standings, teams, players, statistics and photo albums.
**Every endpoint requires a Bearer token.** There are no public endpoints. Tokens are
issued manually by the GSS team — contact us to get one. Each token is scoped to a set
of leagues and to the data types it may read; requests outside that scope return `404`.
Required headers on every request:
```
Authorization: Bearer <your-token>
Accept: application/json
```
No other headers are needed. All list endpoints are paginated
(`{data, meta.pagination, links}`); errors always come back as
`{"errors": [{"code", "title", "detail", "source"}]}`.
## Names and languages
Names are never localized server-side — you decide what to show.
Every named entity returns three fields:
- `name` — the name in the entity's own language (Russian for most,
but also Kazakh, English, Chinese and others)
- `name_en` — the Latin/English version
- `native_language` — the ISO code of the language `name` is
written in (`ru`, `en`, `kk`, ...), or `null` when unknown
Pick the string for the page language like this:
```php
function displayName(array $entity, string $pageLang): string
{
return $entity['native_language'] === $pageLang
? $entity['name']
: ($entity['name_en'] ?: $entity['name']);
}
```
Players use `full_name` / `full_name_en`, videos use `title` /
`title_en`, and both carry `native_language` as well — the same
rule applies.
One more display rule: a club can enter a tournament with more
than one squad, so tournament teams carry `additional_name`
(e.g. "White" / "Blue"). Always render it — `display_name` is
the ready-made `name · additional_name` string.
Rate limit is per token (default 600 requests/minute). On `429` check the
`Retry-After` header.
<aside>As you scroll, you'll see code examples for working with the API in different programming languages in the dark area to the right (or as part of the content on mobile).
You can switch the language used with the tabs at the top right (or from the nav menu at the top left on mobile).</aside>
Authenticating requests
To authenticate requests, include an Authorization header with the value "Bearer {YOUR_API_TOKEN}".
All authenticated endpoints are marked with a requires authentication badge in the documentation below.
Tokens are issued manually by the Global Sport Systems team. Contact your GSS manager to get a token for your leagues. Keep the token server-side — never expose it in browser JavaScript.
Games
Игры турниров доверенных лиг вашего токена.
List games
requires authentication
Example request:
curl --request GET \
--get "https://api.globalsportsystems.org/v1/games?league_id=1132&date_from=2026-01-01&status=finished&per_page=50&page=1" \
--header "Authorization: Bearer {YOUR_API_TOKEN}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"$url = 'https://api.globalsportsystems.org/v1/games';
$query = http_build_query([
'league_id' => 1132,
'date_from' => '2026-01-01',
'status' => 'finished',
'per_page' => 50,
'page' => 1,
]);
$url .= '?' . $query;
$ch = curl_init($url);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer {YOUR_API_TOKEN}',
'Content-Type: application/json',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
curl_close($ch);
$data = json_decode($response, true);
print_r($data);const url = new URL(
"https://api.globalsportsystems.org/v1/games"
);
const params = {
"league_id": "1132",
"date_from": "2026-01-01",
"status": "finished",
"per_page": "50",
"page": "1",
};
Object.keys(params)
.forEach(key => url.searchParams.append(key, params[key]));
const headers = {
"Authorization": "Bearer {YOUR_API_TOKEN}",
"Content-Type": "application/json",
"Accept": "application/json",
};
fetch(url, {
method: "GET",
headers,
}).then(response => response.json());Received response:
Request failed with error:
Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.
Get a game
requires authentication
Example request:
curl --request GET \
--get "https://api.globalsportsystems.org/v1/games/9001" \
--header "Authorization: Bearer {YOUR_API_TOKEN}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"$url = 'https://api.globalsportsystems.org/v1/games/9001';
$ch = curl_init($url);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer {YOUR_API_TOKEN}',
'Content-Type: application/json',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
curl_close($ch);
$data = json_decode($response, true);
print_r($data);const url = new URL(
"https://api.globalsportsystems.org/v1/games/9001"
);
const headers = {
"Authorization": "Bearer {YOUR_API_TOKEN}",
"Content-Type": "application/json",
"Accept": "application/json",
};
fetch(url, {
method: "GET",
headers,
}).then(response => response.json());Received response:
Request failed with error:
Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.
Game rosters
requires authentication
Составы обеих команд с per-game статистикой (stats — сырой JSON матча).
Example request:
curl --request GET \
--get "https://api.globalsportsystems.org/v1/games/9001/roster" \
--header "Authorization: Bearer {YOUR_API_TOKEN}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"$url = 'https://api.globalsportsystems.org/v1/games/9001/roster';
$ch = curl_init($url);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer {YOUR_API_TOKEN}',
'Content-Type: application/json',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
curl_close($ch);
$data = json_decode($response, true);
print_r($data);const url = new URL(
"https://api.globalsportsystems.org/v1/games/9001/roster"
);
const headers = {
"Authorization": "Bearer {YOUR_API_TOKEN}",
"Content-Type": "application/json",
"Accept": "application/json",
};
fetch(url, {
method: "GET",
headers,
}).then(response => response.json());Received response:
Request failed with error:
Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.
Game events
requires authentication
События игры (голы, штрафы, буллиты, ...) в хронологическом порядке.
Example request:
curl --request GET \
--get "https://api.globalsportsystems.org/v1/games/9001/events" \
--header "Authorization: Bearer {YOUR_API_TOKEN}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"$url = 'https://api.globalsportsystems.org/v1/games/9001/events';
$ch = curl_init($url);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer {YOUR_API_TOKEN}',
'Content-Type: application/json',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
curl_close($ch);
$data = json_decode($response, true);
print_r($data);const url = new URL(
"https://api.globalsportsystems.org/v1/games/9001/events"
);
const headers = {
"Authorization": "Bearer {YOUR_API_TOKEN}",
"Content-Type": "application/json",
"Accept": "application/json",
};
fetch(url, {
method: "GET",
headers,
}).then(response => response.json());Received response:
Request failed with error:
Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.
Game photo albums
requires authentication
Шорткат для GET /v1/albums?game_id={id}.
Example request:
curl --request GET \
--get "https://api.globalsportsystems.org/v1/games/9001/albums" \
--header "Authorization: Bearer {YOUR_API_TOKEN}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"$url = 'https://api.globalsportsystems.org/v1/games/9001/albums';
$ch = curl_init($url);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer {YOUR_API_TOKEN}',
'Content-Type: application/json',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
curl_close($ch);
$data = json_decode($response, true);
print_r($data);const url = new URL(
"https://api.globalsportsystems.org/v1/games/9001/albums"
);
const headers = {
"Authorization": "Bearer {YOUR_API_TOKEN}",
"Content-Type": "application/json",
"Accept": "application/json",
};
fetch(url, {
method: "GET",
headers,
}).then(response => response.json());Received response:
Request failed with error:
Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.
Game videos
requires authentication
Трансляции и видео матча. Шорткат для GET /v1/videos?game_id={id}.
Example request:
curl --request GET \
--get "https://api.globalsportsystems.org/v1/games/9001/videos?type=live" \
--header "Authorization: Bearer {YOUR_API_TOKEN}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"$url = 'https://api.globalsportsystems.org/v1/games/9001/videos';
$query = http_build_query([
'type' => 'live',
]);
$url .= '?' . $query;
$ch = curl_init($url);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer {YOUR_API_TOKEN}',
'Content-Type: application/json',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
curl_close($ch);
$data = json_decode($response, true);
print_r($data);const url = new URL(
"https://api.globalsportsystems.org/v1/games/9001/videos"
);
const params = {
"type": "live",
};
Object.keys(params)
.forEach(key => url.searchParams.append(key, params[key]));
const headers = {
"Authorization": "Bearer {YOUR_API_TOKEN}",
"Content-Type": "application/json",
"Accept": "application/json",
};
fetch(url, {
method: "GET",
headers,
}).then(response => response.json());Received response:
Request failed with error:
Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.
Leagues
Сводные сезонные данные доверенных лиг вашего токена.
League season standings
requires authentication
Сводная таблица команд лиги за сезон (по возрастным категориям), из сезонного агрегата league_stats_team_season.
Example request:
curl --request GET \
--get "https://api.globalsportsystems.org/v1/leagues/1132/standings" \
--header "Authorization: Bearer {YOUR_API_TOKEN}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"$url = 'https://api.globalsportsystems.org/v1/leagues/1132/standings';
$ch = curl_init($url);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer {YOUR_API_TOKEN}',
'Content-Type: application/json',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
curl_close($ch);
$data = json_decode($response, true);
print_r($data);const url = new URL(
"https://api.globalsportsystems.org/v1/leagues/1132/standings"
);
const headers = {
"Authorization": "Bearer {YOUR_API_TOKEN}",
"Content-Type": "application/json",
"Accept": "application/json",
};
fetch(url, {
method: "GET",
headers,
}).then(response => response.json());Received response:
Request failed with error:
Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.
League season leaders
requires authentication
Top scorers и top goalies лиги за сезон (league_stats_player / goalie).
Example request:
curl --request GET \
--get "https://api.globalsportsystems.org/v1/leagues/1132/stats?limit=10" \
--header "Authorization: Bearer {YOUR_API_TOKEN}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"$url = 'https://api.globalsportsystems.org/v1/leagues/1132/stats';
$query = http_build_query([
'limit' => 10,
]);
$url .= '?' . $query;
$ch = curl_init($url);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer {YOUR_API_TOKEN}',
'Content-Type: application/json',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
curl_close($ch);
$data = json_decode($response, true);
print_r($data);const url = new URL(
"https://api.globalsportsystems.org/v1/leagues/1132/stats"
);
const params = {
"limit": "10",
};
Object.keys(params)
.forEach(key => url.searchParams.append(key, params[key]));
const headers = {
"Authorization": "Bearer {YOUR_API_TOKEN}",
"Content-Type": "application/json",
"Accept": "application/json",
};
fetch(url, {
method: "GET",
headers,
}).then(response => response.json());Received response:
Request failed with error:
Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.
League albums
requires authentication
Фотоальбомы лиги каскадом: собственные альбомы лиги ПЛЮС альбомы её
турниров и матчей. Это отличается от GET /v1/albums?league_id={id} —
тот фильтр смотрит только на прямую привязку альбома к лиге и нужен,
чтобы сузить мульти-лиговый токен до одной лиги.
Example request:
curl --request GET \
--get "https://api.globalsportsystems.org/v1/leagues/1132/albums" \
--header "Authorization: Bearer {YOUR_API_TOKEN}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"$url = 'https://api.globalsportsystems.org/v1/leagues/1132/albums';
$ch = curl_init($url);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer {YOUR_API_TOKEN}',
'Content-Type: application/json',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
curl_close($ch);
$data = json_decode($response, true);
print_r($data);const url = new URL(
"https://api.globalsportsystems.org/v1/leagues/1132/albums"
);
const headers = {
"Authorization": "Bearer {YOUR_API_TOKEN}",
"Content-Type": "application/json",
"Accept": "application/json",
};
fetch(url, {
method: "GET",
headers,
}).then(response => response.json());Example response (404):
{
"errors": [
{
"code": "not_found",
"title": "Not found",
"detail": "Resource not found",
"source": null
}
]
}
Received response:
Request failed with error:
Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.
Photo albums
Фотоальбомы лиг/турниров/игр из scope токена. Сами файлы хранятся в фотоальбомах VK — мы отдаём мету альбома и готовые абсолютные ссылки на изображения в трёх размерах (thumbnail / medium / large).
vk_album_url — ссылка на первоисточник, если нужно отправить читателя
в VK.
Обложка альбома
cover — кадр-обложка во всех трёх размерах (url_thumbnail ~160 px,
url_medium ~640 px, url_large до 2400 px) плюс его id и vk_photo_id.
Берите отсюда: url_medium годится для карточки, url_large — для ретины
и крупных блоков.
cover_image_url — та же обложка одной ссылкой (url_medium), оставлена
для совместимости. Если кадр не резолвится (альбом пуст либо фотографии
ещё не выгружены), cover равен null, а cover_image_url содержит
маленькую превью-обложку из VK.
Скрытые альбомы и скрытые фотографии наружу не отдаются: их нет ни в списках, ни в карточке (скрытый альбом отвечает 404). Альбом, который мы ещё ни разу не синхронизировали с VK, тоже не отдаётся: фотографий и обложки у него пока нет, и на витрине это была бы пустая карточка.
Турниры и порталы
Альбом может относиться к НЕСКОЛЬКИМ турнирам: организаторы дробят одно
событие на дивизионы отдельными турнирами, а фотографии заливают одним
альбомом на всех. Такой альбом остаётся ОДНИМ объектом с общим id и
находится по каждому из своих турниров. Полный набор — в tournaments
(основной первым); скалярные tournament_id / tournament продолжают
указывать на основной и сохранены для совместимости.
projects — порталы, на которых альбом опубликован. Фильтр ?project=
отдаёт только альбомы этого портала: детский хоккейный альбом не попадёт в
выдачу любительского портала, даже если лига у них общая.
Ссылки на изображения — не постоянные идентификаторы
url_thumbnail / url_medium / url_large / cover_image_url — это
ПОДПИСАННЫЕ ссылки на VK-CDN. На практике они живут долго (проверено:
ссылки 2021 года открываются сегодня), поэтому агрессивно перезапрашивать
их не нужно. Но постоянными считать их нельзя: при каждом перепарсе альбома
мы переписываем URL на те, что VK отдал в этот раз, и старая ссылка со
временем перестаёт открываться.
Отсюда два правила для партнёра, который зеркалит альбомы у себя:
- Ключ фотографии —
vk_photo_id(или нашid), но НЕ URL. Ссылка меняется, идентификатор — нет. - Проверять обновления через
?updated_since=, а не перекачивая корпус. Синк трогает альбом только когда в VK действительно что-то поменялось, поэтому такой запрос обычно возвращает пустой список. Разумная периодичность — раз в сутки; чаще смысла нет, крон синка ходит в VK раз в три часа.
Заголовков кэширования эти эндпойнты не отдают намеренно: момент
следующего изменения альбома непредсказуем (его задаёт организатор в VK),
и любой max-age означал бы либо устаревшие данные, либо лишние запросы.
Механизм актуализации — updated_since.
List albums
requires authentication
Все альбомы доверенных лиг токена, новые сверху (по album_date).
Без фильтров возвращаются альбомы всех лиг сразу — мульти-лиговому
сайту не нужно слать по запросу на лигу: группировать можно по блоку
league (или tournament.league у альбомов турнира) в каждом элементе.
Ключ photos в списке всегда null — «не включено на этом
эндпойнте»; сами фотографии приходят в GET /v1/albums/{id}.
Example request:
curl --request GET \
--get "https://api.globalsportsystems.org/v1/albums?league_id=1132&project=trackhockey&updated_since=2026-07-01T00%3A00%3A00%2B00%3A00&per_page=50&page=1" \
--header "Authorization: Bearer {YOUR_API_TOKEN}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"$url = 'https://api.globalsportsystems.org/v1/albums';
$query = http_build_query([
'league_id' => 1132,
'project' => 'trackhockey',
'updated_since' => '2026-07-01T00:00:00+00:00',
'per_page' => 50,
'page' => 1,
]);
$url .= '?' . $query;
$ch = curl_init($url);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer {YOUR_API_TOKEN}',
'Content-Type: application/json',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
curl_close($ch);
$data = json_decode($response, true);
print_r($data);const url = new URL(
"https://api.globalsportsystems.org/v1/albums"
);
const params = {
"league_id": "1132",
"project": "trackhockey",
"updated_since": "2026-07-01T00:00:00+00:00",
"per_page": "50",
"page": "1",
};
Object.keys(params)
.forEach(key => url.searchParams.append(key, params[key]));
const headers = {
"Authorization": "Bearer {YOUR_API_TOKEN}",
"Content-Type": "application/json",
"Accept": "application/json",
};
fetch(url, {
method: "GET",
headers,
}).then(response => response.json());Example response (200):
{
"data": [
{
"id": 77,
"name": "Сибириус 2017-U8 /// 1 — 3 ноября",
"name_en": "Sibirius 2017-U8 /// Nov 1-3",
"native_language": "ru",
"album_date": "2026-03-14",
"cover_image_url": "https://sun9-1.userapi.com/impg/aaa/bbb.jpg?size=640x427&quality=95&type=album",
"cover": {
"id": 9001,
"vk_photo_id": 457300504,
"url_thumbnail": "https://sun9-1.userapi.com/impg/aaa/bbb.jpg?size=160x107&quality=95&type=album",
"url_medium": "https://sun9-1.userapi.com/impg/aaa/bbb.jpg?size=640x427&quality=95&type=album",
"url_large": "https://sun9-1.userapi.com/impg/aaa/bbb.jpg?size=2400x1600&quality=95&type=album"
},
"photos_count": 346,
"vk_album_url": "https://vk.com/album-130544483_295833417",
"season_id": 12,
"league_id": null,
"tournament_id": 45,
"game_id": null,
"league": null,
"tournament": {
"id": 45,
"slug": "sibirius-cup-2026",
"name": "Кубок Сибириус",
"name_en": "Sibirius Cup",
"league_id": 1132,
"season_id": 12,
"native_language": "ru",
"league": {
"id": 1132,
"slug": "corporate-cup",
"name": "Корпоративный Кубок",
"name_en": "Corporate Cup",
"native_language": "ru"
}
},
"tournaments": [
{
"id": 45,
"slug": "sibirius-cup-2026",
"name": "Кубок Сибириус",
"name_en": "Sibirius Cup",
"league_id": 1132,
"season_id": 12,
"native_language": "ru",
"league": {
"id": 1132,
"slug": "corporate-cup",
"name": "Корпоративный Кубок",
"name_en": "Corporate Cup",
"native_language": "ru"
}
},
{
"id": 46,
"slug": "sibirius-cup-2026-gold",
"name": "Кубок Сибириус — Дивизион Золотой",
"name_en": "Sibirius Cup — Gold Division",
"league_id": 1132,
"season_id": 12,
"native_language": "ru",
"league": null
}
],
"projects": [
{
"id": 1,
"slug": "trackhockey",
"name": "TrackHockey"
}
],
"photos": null,
"created_at": "2026-03-15T09:12:00+00:00",
"updated_at": "2026-03-16T04:00:11+00:00"
}
],
"meta": {
"pagination": {
"total": 2,
"count": 1,
"per_page": 1,
"current_page": 1,
"total_pages": 2
}
},
"links": {
"self": "https://api.globalsportsystems.org/v1/albums?per_page=1",
"first": "https://api.globalsportsystems.org/v1/albums?per_page=1&page=1",
"last": "https://api.globalsportsystems.org/v1/albums?per_page=1&page=2",
"next": "https://api.globalsportsystems.org/v1/albums?per_page=1&page=2",
"prev": null
}
}
Received response:
Request failed with error:
Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.
Get an album with photos
requires authentication
Тот же объект, что в списке, плюс photos — ПРЕВЬЮ первых 24 кадров
в порядке VK (sort_order). Весь альбом одним куском не отдаётся: при
реальных подписанных ссылках VK это ответ под мегабайт. Полное число
видимых фото — в photos_count, признак усечения — photos_truncated,
остальные кадры постранично — GET /v1/albums/{id}/photos.
У каждой фотографии три готовых абсолютных URL:
url_thumbnail (~160px) для превью-сетки, url_medium (~640px) для
страницы, url_large (до 2400px) для лайтбокса. Не у всех оригиналов
есть большой размер — тогда в url_large лежит максимальный доступный.
Скрытые фотографии в выдачу не попадают, photos_count считает
только видимые.
Example request:
curl --request GET \
--get "https://api.globalsportsystems.org/v1/albums/77" \
--header "Authorization: Bearer {YOUR_API_TOKEN}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"$url = 'https://api.globalsportsystems.org/v1/albums/77';
$ch = curl_init($url);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer {YOUR_API_TOKEN}',
'Content-Type: application/json',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
curl_close($ch);
$data = json_decode($response, true);
print_r($data);const url = new URL(
"https://api.globalsportsystems.org/v1/albums/77"
);
const headers = {
"Authorization": "Bearer {YOUR_API_TOKEN}",
"Content-Type": "application/json",
"Accept": "application/json",
};
fetch(url, {
method: "GET",
headers,
}).then(response => response.json());Example response (200):
{
"data": {
"id": 77,
"name": "Сибириус 2017-U8 /// 1 — 3 ноября",
"name_en": "Sibirius 2017-U8 /// Nov 1-3",
"native_language": "ru",
"album_date": "2026-03-14",
"cover_image_url": "https://sun9-1.userapi.com/impg/aaa/bbb.jpg?size=640x427&quality=95&type=album",
"cover": {
"id": 9001,
"vk_photo_id": 457300504,
"url_thumbnail": "https://sun9-1.userapi.com/impg/aaa/bbb.jpg?size=160x107&quality=95&type=album",
"url_medium": "https://sun9-1.userapi.com/impg/aaa/bbb.jpg?size=640x427&quality=95&type=album",
"url_large": "https://sun9-1.userapi.com/impg/aaa/bbb.jpg?size=2400x1600&quality=95&type=album"
},
"photos_count": 2,
"vk_album_url": "https://vk.com/album-130544483_295833417",
"season_id": 12,
"league_id": null,
"tournament_id": 45,
"game_id": null,
"league": null,
"tournament": {
"id": 45,
"slug": "sibirius-cup-2026",
"name": "Кубок Сибириус",
"name_en": "Sibirius Cup",
"league_id": 1132,
"season_id": 12,
"native_language": "ru",
"league": {
"id": 1132,
"slug": "corporate-cup",
"name": "Корпоративный Кубок",
"name_en": "Corporate Cup",
"native_language": "ru"
}
},
"tournaments": [
{
"id": 45,
"slug": "sibirius-cup-2026",
"name": "Кубок Сибириус",
"name_en": "Sibirius Cup",
"league_id": 1132,
"season_id": 12,
"native_language": "ru",
"league": {
"id": 1132,
"slug": "corporate-cup",
"name": "Корпоративный Кубок",
"name_en": "Corporate Cup",
"native_language": "ru"
}
},
{
"id": 46,
"slug": "sibirius-cup-2026-gold",
"name": "Кубок Сибириус — Дивизион Золотой",
"name_en": "Sibirius Cup — Gold Division",
"league_id": 1132,
"season_id": 12,
"native_language": "ru",
"league": null
}
],
"projects": [
{
"id": 1,
"slug": "trackhockey",
"name": "TrackHockey"
}
],
"photos": [
{
"id": 9001,
"sort_order": 0,
"url_thumbnail": "https://sun9-1.userapi.com/impg/aaa/bbb.jpg?size=160x107&quality=95&type=album",
"url_medium": "https://sun9-1.userapi.com/impg/aaa/bbb.jpg?size=640x427&quality=95&type=album",
"url_large": "https://sun9-1.userapi.com/impg/aaa/bbb.jpg?size=2400x1600&quality=95&type=album",
"vk_photo_id": 457300504
},
{
"id": 9002,
"sort_order": 1,
"url_thumbnail": "https://sun9-2.userapi.com/impg/ccc/ddd.jpg?size=160x107&quality=95&type=album",
"url_medium": "https://sun9-2.userapi.com/impg/ccc/ddd.jpg?size=640x427&quality=95&type=album",
"url_large": "https://sun9-2.userapi.com/impg/ccc/ddd.jpg?size=2400x1600&quality=95&type=album",
"vk_photo_id": 457300505
}
],
"created_at": "2026-03-15T09:12:00+00:00",
"updated_at": "2026-03-16T04:00:11+00:00"
}
}
Example response (404):
{
"errors": [
{
"code": "not_found",
"title": "Not found",
"detail": "Resource not found",
"source": null
}
]
}
Received response:
Request failed with error:
Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.
List album photos
requires authentication
Все видимые фотографии альбома постранично, в порядке VK (sort_order).
Это продолжение превью из GET /v1/albums/{id}: там первые 24 кадра,
здесь — весь альбом с обычной обёрткой пагинации.
Скрытые фотографии (снятые модератором или пропавшие из VK) не отдаются. Альбом вне scope токена, скрытый или ещё не синхронизированный — 404, как и на карточке альбома.
Помните: ссылки подписанные и при перепарсе меняются — кэшируйте по
vk_photo_id, а не по URL (см. описание группы).
Example request:
curl --request GET \
--get "https://api.globalsportsystems.org/v1/albums/77/photos?per_page=100&page=1" \
--header "Authorization: Bearer {YOUR_API_TOKEN}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"$url = 'https://api.globalsportsystems.org/v1/albums/77/photos';
$query = http_build_query([
'per_page' => 100,
'page' => 1,
]);
$url .= '?' . $query;
$ch = curl_init($url);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer {YOUR_API_TOKEN}',
'Content-Type: application/json',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
curl_close($ch);
$data = json_decode($response, true);
print_r($data);const url = new URL(
"https://api.globalsportsystems.org/v1/albums/77/photos"
);
const params = {
"per_page": "100",
"page": "1",
};
Object.keys(params)
.forEach(key => url.searchParams.append(key, params[key]));
const headers = {
"Authorization": "Bearer {YOUR_API_TOKEN}",
"Content-Type": "application/json",
"Accept": "application/json",
};
fetch(url, {
method: "GET",
headers,
}).then(response => response.json());Example response (200):
{
"data": [
{
"id": 9001,
"sort_order": 0,
"url_thumbnail": "https://sun9-1.userapi.com/impg/aaa/bbb.jpg?size=160x107&quality=95&type=album",
"url_medium": "https://sun9-1.userapi.com/impg/aaa/bbb.jpg?size=640x427&quality=95&type=album",
"url_large": "https://sun9-1.userapi.com/impg/aaa/bbb.jpg?size=2400x1600&quality=95&type=album",
"vk_photo_id": 457300504
}
],
"meta": {
"pagination": {
"total": 346,
"count": 1,
"per_page": 1,
"current_page": 1,
"total_pages": 346
}
},
"links": {
"self": "https://api.globalsportsystems.org/v1/albums/77/photos?per_page=1",
"first": "https://api.globalsportsystems.org/v1/albums/77/photos?per_page=1&page=1",
"last": "https://api.globalsportsystems.org/v1/albums/77/photos?per_page=1&page=346",
"next": "https://api.globalsportsystems.org/v1/albums/77/photos?per_page=1&page=2",
"prev": null
}
}
Example response (404):
{
"errors": [
{
"code": "not_found",
"title": "Not found",
"detail": "Resource not found",
"source": null
}
]
}
Received response:
Request failed with error:
Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.
Players
Игроки, заявленные в турнирах доверенных лиг вашего токена. Статистика отдаётся только по этим лигам — чужие лиги игрока не раскрываются.
Статусы игрока
classifications — статусы и спортивные классы, присвоенные игроку
ВАШИМИ лигами: «Любитель», «Профессионал», «Класс AA». У каждой записи
есть type.category — status (статус) либо level (спортивный класс),
так что бейджи двух видов можно развести на витрине.
Отдаются только ДЕЙСТВУЮЩИЕ: снятый или истёкший статус на сайте выглядел бы как текущий. Свежие первыми. Присвоения других лиг не показываются — то же правило, что у статистики.
Те же classifications приходят в составе команды
(GET /v1/teams/{id}/players) — чтобы рисовать бейдж рядом с фамилией
без второго запроса на каждого игрока.
Команды вне справочника
first_team_unlisted и current_team_unlisted — клуб, которого в нашем
справочнике нет: его записал наш модератор со слов игрока или его
представителя. Отдельные ключи именно затем, чтобы витрина отличала
справочник от слов заказчика: у такой команды нет ни id, ни slug, ни
логотипа — ссылаться некуда, рисуйте текстом.
Заполнены, только когда команды из справочника в этом слоте нет: как только
она появляется, приоритет у неё, а блок становится null.
List players
requires authentication
Example request:
curl --request GET \
--get "https://api.globalsportsystems.org/v1/players?search=%D0%98%D0%B2%D0%B0%D0%BD%D0%BE%D0%B2&per_page=50&page=1" \
--header "Authorization: Bearer {YOUR_API_TOKEN}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"$url = 'https://api.globalsportsystems.org/v1/players';
$query = http_build_query([
'search' => 'Иванов',
'per_page' => 50,
'page' => 1,
]);
$url .= '?' . $query;
$ch = curl_init($url);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer {YOUR_API_TOKEN}',
'Content-Type: application/json',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
curl_close($ch);
$data = json_decode($response, true);
print_r($data);const url = new URL(
"https://api.globalsportsystems.org/v1/players"
);
const params = {
"search": "Иванов",
"per_page": "50",
"page": "1",
};
Object.keys(params)
.forEach(key => url.searchParams.append(key, params[key]));
const headers = {
"Authorization": "Bearer {YOUR_API_TOKEN}",
"Content-Type": "application/json",
"Accept": "application/json",
};
fetch(url, {
method: "GET",
headers,
}).then(response => response.json());Received response:
Request failed with error:
Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.
Get a player
requires authentication
Карточка игрока + его команды в рамках доверенных лиг (самая свежая — первой, она же current_team).
Example request:
curl --request GET \
--get "https://api.globalsportsystems.org/v1/players/4510" \
--header "Authorization: Bearer {YOUR_API_TOKEN}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"$url = 'https://api.globalsportsystems.org/v1/players/4510';
$ch = curl_init($url);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer {YOUR_API_TOKEN}',
'Content-Type: application/json',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
curl_close($ch);
$data = json_decode($response, true);
print_r($data);const url = new URL(
"https://api.globalsportsystems.org/v1/players/4510"
);
const headers = {
"Authorization": "Bearer {YOUR_API_TOKEN}",
"Content-Type": "application/json",
"Accept": "application/json",
};
fetch(url, {
method: "GET",
headers,
}).then(response => response.json());Received response:
Request failed with error:
Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.
Player aggregated stats
requires authentication
Агрегаты из турнирной и сезонной статистики — только по турнирам и лигам из scope токена.
career — строки карьеры, внесённые нашим модератором со слов
игрока или его представителя: выступления, протоколы которых до нас
не дошли. Это НЕ соревнование в системе: страницы, id и slug у него
нет, ссылаться некуда — только текст, даты и цифры. Отдаются лишь
записи, привязанные к вашей лиге.
Example request:
curl --request GET \
--get "https://api.globalsportsystems.org/v1/players/4510/stats" \
--header "Authorization: Bearer {YOUR_API_TOKEN}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"$url = 'https://api.globalsportsystems.org/v1/players/4510/stats';
$ch = curl_init($url);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer {YOUR_API_TOKEN}',
'Content-Type: application/json',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
curl_close($ch);
$data = json_decode($response, true);
print_r($data);const url = new URL(
"https://api.globalsportsystems.org/v1/players/4510/stats"
);
const headers = {
"Authorization": "Bearer {YOUR_API_TOKEN}",
"Content-Type": "application/json",
"Accept": "application/json",
};
fetch(url, {
method: "GET",
headers,
}).then(response => response.json());Received response:
Request failed with error:
Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.
Team applications
Приём заявок команд на турниры с сайтов лиг. Единственный write-эндпойнт v1: заявка попадает прямо в БД GSS, и организатор видит её в админке my.globalsportsystems.org в разделе «Заявки».
Зачем это нужно
Заявка содержит персональные данные (ФИО, телефон). Пересылка их в мессенджер или на почту третьей стороне — трансграничная передача ПДн со всеми вытекающими. Этот эндпойнт держит их внутри периметра GSS.
Согласие обязательно
Без consent.given = true заявка не создаётся — 422. Форма на сайте лиги
обязана содержать чекбокс согласия со ссылкой на
https://globalsportsystems.org/privacy. Момент согласия, URL и версия
политики сохраняются вместе с заявкой.
Скоуп
league_id обязан входить в список доверенных лиг токена — иначе 403.
Создать заявку в чужую лигу физически нельзя. Если передан tournament_id,
он обязан принадлежать доверенной лиге, иначе 404 (существование чужих
турниров наружу не подтверждаем).
Повторные отправки
Передавайте заголовок Idempotency-Key — повторный запрос с тем же ключом
в течение часа вернёт исходную заявку и не создаст дубль. Ключ действует
только для вашего токена: совпадение с ключом другого сайта ни на что не
влияет. Без заголовка дедупликация всё равно работает: одна и та же
команда с тем же телефоном на ту же цель в пределах часа считается
повторной отправкой.
Новая заявка — 201 и duplicate_of_existing: false. Распознанный повтор —
200 и duplicate_of_existing: true с тем же id. Оба ответа означают
«заявка принята», показывайте пользователю одно и то же «спасибо».
Submit a team application
requires authentication
Регистрирует заявку команды на турнир (или на лигу — если заявитель не выбирал конкретный турнир). Ответ намеренно короткий: сайту лиги нужен только факт приёма.
Example request:
curl --request POST \
"https://api.globalsportsystems.org/v1/applications" \
--header "Authorization: Bearer {YOUR_API_TOKEN}" \
--header "Idempotency-Key: Произвольный уникальный ключ отправки. Повтор с тем же ключом не создаст дубль. Example: 3f1a9c2e-6b71-4f0a-9a1e-1b2c3d4e5f60" \
--header "Content-Type: application/json" \
--header "Accept: application/json" \
--data "{
\"team_name\": \"Сибириус 2015\",
\"city\": \"Новосибирск\",
\"league_id\": 1132,
\"tournament_id\": 4417,
\"contact_name\": \"Иванов Иван\",
\"contact_phone\": \"+7 913 123-45-67\",
\"contact_email\": \"coach@example.org\",
\"comment\": \"Готовы приехать на все выходные\",
\"source\": \"league_site:sibirius-hockey.ru\",
\"submitted_from_url\": \"https:\\/\\/sibirius-hockey.ru\\/apply\",
\"consent\": {
\"given\": true,
\"at\": \"2026-07-28T10:15:00+03:00\"
}
}"
$url = 'https://api.globalsportsystems.org/v1/applications';
$ch = curl_init($url);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 30,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_HTTPHEADER => [
'Authorization: Bearer {YOUR_API_TOKEN}',
'Idempotency-Key: Произвольный уникальный ключ отправки. Повтор с тем же ключом не создаст дубль. Example: 3f1a9c2e-6b71-4f0a-9a1e-1b2c3d4e5f60',
'Content-Type: application/json',
'Accept: application/json',
],
CURLOPT_POSTFIELDS => json_encode([
'team_name' => 'Сибириус 2015',
'city' => 'Новосибирск',
'league_id' => 1132,
'tournament_id' => 4417,
'contact_name' => 'Иванов Иван',
'contact_phone' => '+7 913 123-45-67',
'contact_email' => 'coach@example.org',
'comment' => 'Готовы приехать на все выходные',
'source' => 'league_site:sibirius-hockey.ru',
'submitted_from_url' => 'https://sibirius-hockey.ru/apply',
'consent' => ['given' => true, 'at' => '2026-07-28T10:15:00+03:00'],
]),
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
curl_close($ch);
$data = json_decode($response, true);
print_r($data);const url = new URL(
"https://api.globalsportsystems.org/v1/applications"
);
const headers = {
"Authorization": "Bearer {YOUR_API_TOKEN}",
"Idempotency-Key": "Произвольный уникальный ключ отправки. Повтор с тем же ключом не создаст дубль. Example: 3f1a9c2e-6b71-4f0a-9a1e-1b2c3d4e5f60",
"Content-Type": "application/json",
"Accept": "application/json",
};
let body = {
"team_name": "Сибириус 2015",
"city": "Новосибирск",
"league_id": 1132,
"tournament_id": 4417,
"contact_name": "Иванов Иван",
"contact_phone": "+7 913 123-45-67",
"contact_email": "coach@example.org",
"comment": "Готовы приехать на все выходные",
"source": "league_site:sibirius-hockey.ru",
"submitted_from_url": "https:\/\/sibirius-hockey.ru\/apply",
"consent": {
"given": true,
"at": "2026-07-28T10:15:00+03:00"
}
};
fetch(url, {
method: "POST",
headers,
body: JSON.stringify(body),
}).then(response => response.json());Example response (200):
{
"data": {
"id": 1042,
"created_at": "2026-07-28T10:15:04+00:00",
"duplicate_of_existing": true
}
}
Example response (201):
{
"data": {
"id": 1042,
"created_at": "2026-07-28T10:15:04+00:00",
"duplicate_of_existing": false
}
}
Example response (403):
{
"errors": [
{
"code": "forbidden",
"title": "Forbidden",
"detail": "Your token is not allowed to perform this action",
"source": null
}
]
}
Example response (404):
{
"errors": [
{
"code": "not_found",
"title": "Not found",
"detail": "Resource not found",
"source": null
}
]
}
Example response (422):
{
"errors": [
{
"code": "validation_failed",
"title": "Validation failed",
"detail": "Consent to personal data processing is required.",
"source": {
"pointer": "consent.given"
}
}
]
}
Received response:
Request failed with error:
Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.
Teams
Команды, участвующие в турнирах доверенных лиг вашего токена.
List teams
requires authentication
Пагинированный список команд в рамках scope токена.
Example request:
curl --request GET \
--get "https://api.globalsportsystems.org/v1/teams?league_id=1132&search=%D0%A8%D1%83%D1%88%D0%B0%D1%80%D1%8B&per_page=50&page=1" \
--header "Authorization: Bearer {YOUR_API_TOKEN}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"$url = 'https://api.globalsportsystems.org/v1/teams';
$query = http_build_query([
'league_id' => 1132,
'search' => 'Шушары',
'per_page' => 50,
'page' => 1,
]);
$url .= '?' . $query;
$ch = curl_init($url);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer {YOUR_API_TOKEN}',
'Content-Type: application/json',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
curl_close($ch);
$data = json_decode($response, true);
print_r($data);const url = new URL(
"https://api.globalsportsystems.org/v1/teams"
);
const params = {
"league_id": "1132",
"search": "Шушары",
"per_page": "50",
"page": "1",
};
Object.keys(params)
.forEach(key => url.searchParams.append(key, params[key]));
const headers = {
"Authorization": "Bearer {YOUR_API_TOKEN}",
"Content-Type": "application/json",
"Accept": "application/json",
};
fetch(url, {
method: "GET",
headers,
}).then(response => response.json());Example response (200):
{
"data": [
{
"id": 123,
"slug": "team-a-2010",
"name": "Команда А",
"name_en": "Team A",
"short_name": null,
"short_name_en": null,
"native_language": "ru",
"team_year": 2010,
"type": "child",
"status": "active",
"sport": {
"id": 1,
"key": "hockey",
"name": "Hockey"
},
"club": null,
"city": {
"id": 7,
"name": "Санкт-Петербург",
"name_en": "Saint Petersburg"
},
"logo_url": "https://s3.example/logos/123.webp",
"created_at": "2025-09-01T10:30:00+00:00",
"updated_at": "2026-04-10T14:22:15+00:00"
}
],
"meta": {
"pagination": {
"total": 2,
"count": 1,
"per_page": 1,
"current_page": 1,
"total_pages": 2
}
},
"links": {
"self": "https://api.globalsportsystems.org/v1/teams?per_page=1",
"first": "https://api.globalsportsystems.org/v1/teams?per_page=1&page=1",
"last": "https://api.globalsportsystems.org/v1/teams?per_page=1&page=2",
"next": "https://api.globalsportsystems.org/v1/teams?per_page=1&page=2",
"prev": null
}
}
Received response:
Request failed with error:
Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.
Get a team
requires authentication
Example request:
curl --request GET \
--get "https://api.globalsportsystems.org/v1/teams/123" \
--header "Authorization: Bearer {YOUR_API_TOKEN}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"$url = 'https://api.globalsportsystems.org/v1/teams/123';
$ch = curl_init($url);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer {YOUR_API_TOKEN}',
'Content-Type: application/json',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
curl_close($ch);
$data = json_decode($response, true);
print_r($data);const url = new URL(
"https://api.globalsportsystems.org/v1/teams/123"
);
const headers = {
"Authorization": "Bearer {YOUR_API_TOKEN}",
"Content-Type": "application/json",
"Accept": "application/json",
};
fetch(url, {
method: "GET",
headers,
}).then(response => response.json());Received response:
Request failed with error:
Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.
Team roster with basic stats
requires authentication
Состав команды в рамках доверенных лиг, с базовой статистикой из турнирных агрегатов. Единицу измерения выбираете вы:
- Без фильтров — состав за сезон (default — текущий): объединение заявок на все турниры сезона, как карточка команды на нашем портале без контекста турнира. У любительской команды за сезон через клуб проходит несколько составов, поэтому здесь бывает 40+ человек при 14 в каждой отдельной заявке — это не ошибка, подпишите блок сезоном.
tournament_id— заявка на конкретный турнир: ровно те игроки, что заявлены на него, и статистика только по нему. Сезон берётся у турнира,season_idпри этом не участвует. Id турниров команды — вGET /v1/tournamentsили вteams[]карточки турнира.tournament_team_id— одна заявка: нужен, когда клуб выставил на турнир два состава («Сочи Белые» / «Сочи Синие»), поtournament_idпридут оба. Этоteams[].idиз карточки турнира.
Чужой, скрытый или принадлежащий другой команде турнир в фильтре
даёт пустой data, а не ошибку. meta всегда возвращает контекст,
по которому собран состав.
Example request:
curl --request GET \
--get "https://api.globalsportsystems.org/v1/teams/123/players" \
--header "Authorization: Bearer {YOUR_API_TOKEN}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"$url = 'https://api.globalsportsystems.org/v1/teams/123/players';
$ch = curl_init($url);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer {YOUR_API_TOKEN}',
'Content-Type: application/json',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
curl_close($ch);
$data = json_decode($response, true);
print_r($data);const url = new URL(
"https://api.globalsportsystems.org/v1/teams/123/players"
);
const headers = {
"Authorization": "Bearer {YOUR_API_TOKEN}",
"Content-Type": "application/json",
"Accept": "application/json",
};
fetch(url, {
method: "GET",
headers,
}).then(response => response.json());Received response:
Request failed with error:
Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.
Tournaments
Турниры доверенных лиг вашего токена.
List tournaments
requires authentication
Example request:
curl --request GET \
--get "https://api.globalsportsystems.org/v1/tournaments?league_id=1132&status=active&type=cup&per_page=50&page=1" \
--header "Authorization: Bearer {YOUR_API_TOKEN}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"$url = 'https://api.globalsportsystems.org/v1/tournaments';
$query = http_build_query([
'league_id' => 1132,
'status' => 'active',
'type' => 'cup',
'per_page' => 50,
'page' => 1,
]);
$url .= '?' . $query;
$ch = curl_init($url);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer {YOUR_API_TOKEN}',
'Content-Type: application/json',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
curl_close($ch);
$data = json_decode($response, true);
print_r($data);const url = new URL(
"https://api.globalsportsystems.org/v1/tournaments"
);
const params = {
"league_id": "1132",
"status": "active",
"type": "cup",
"per_page": "50",
"page": "1",
};
Object.keys(params)
.forEach(key => url.searchParams.append(key, params[key]));
const headers = {
"Authorization": "Bearer {YOUR_API_TOKEN}",
"Content-Type": "application/json",
"Accept": "application/json",
};
fetch(url, {
method: "GET",
headers,
}).then(response => response.json());Received response:
Request failed with error:
Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.
Get a tournament
requires authentication
Мета турнира + команды-участники + список этапов.
Example request:
curl --request GET \
--get "https://api.globalsportsystems.org/v1/tournaments/45" \
--header "Authorization: Bearer {YOUR_API_TOKEN}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"$url = 'https://api.globalsportsystems.org/v1/tournaments/45';
$ch = curl_init($url);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer {YOUR_API_TOKEN}',
'Content-Type: application/json',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
curl_close($ch);
$data = json_decode($response, true);
print_r($data);const url = new URL(
"https://api.globalsportsystems.org/v1/tournaments/45"
);
const headers = {
"Authorization": "Bearer {YOUR_API_TOKEN}",
"Content-Type": "application/json",
"Accept": "application/json",
};
fetch(url, {
method: "GET",
headers,
}).then(response => response.json());Received response:
Request failed with error:
Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.
Tournament table (standings)
requires authentication
Турнирная таблица по этапам — тот же агрегат, что и на публичных порталах (пересчитывается кроном после каждого матча).
Example request:
curl --request GET \
--get "https://api.globalsportsystems.org/v1/tournaments/45/table" \
--header "Authorization: Bearer {YOUR_API_TOKEN}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"$url = 'https://api.globalsportsystems.org/v1/tournaments/45/table';
$ch = curl_init($url);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer {YOUR_API_TOKEN}',
'Content-Type: application/json',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
curl_close($ch);
$data = json_decode($response, true);
print_r($data);const url = new URL(
"https://api.globalsportsystems.org/v1/tournaments/45/table"
);
const headers = {
"Authorization": "Bearer {YOUR_API_TOKEN}",
"Content-Type": "application/json",
"Accept": "application/json",
};
fetch(url, {
method: "GET",
headers,
}).then(response => response.json());Example response (200):
{
"data": {
"tournament": {
"id": 45,
"slug": "allowed-cup",
"name": "Кубок",
"name_en": "Cup",
"native_language": "ru"
},
"stages": [
{
"id": 3,
"name": "Группа А",
"name_en": "Group A",
"type": "round-robin",
"sort_order": 1,
"native_language": "ru",
"standings": [
{
"position": 1,
"team": {
"id": 11,
"team_id": 123,
"name": "Команда А",
"name_en": "Team A",
"short_name": null,
"short_name_en": null,
"native_language": "ru",
"additional_name": null,
"display_name": "Команда А",
"logo_url": "https://s3.example/logos/123.webp",
"is_placeholder": false,
"is_out_of_standings": false,
"final_position": null
},
"games_played": 5,
"wins_total": 4,
"wins": 4,
"wins_ot": 0,
"wins_so": 0,
"draws": 0,
"losses_total": 1,
"losses": 1,
"losses_ot": 0,
"losses_so": 0,
"scores_for": 20,
"scores_against": 8,
"points": 8
}
]
}
]
}
}
Received response:
Request failed with error:
Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.
Tournament schedule
requires authentication
Календарь игр турнира от старых к новым.
Example request:
curl --request GET \
--get "https://api.globalsportsystems.org/v1/tournaments/45/schedule" \
--header "Authorization: Bearer {YOUR_API_TOKEN}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"$url = 'https://api.globalsportsystems.org/v1/tournaments/45/schedule';
$ch = curl_init($url);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer {YOUR_API_TOKEN}',
'Content-Type: application/json',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
curl_close($ch);
$data = json_decode($response, true);
print_r($data);const url = new URL(
"https://api.globalsportsystems.org/v1/tournaments/45/schedule"
);
const headers = {
"Authorization": "Bearer {YOUR_API_TOKEN}",
"Content-Type": "application/json",
"Accept": "application/json",
};
fetch(url, {
method: "GET",
headers,
}).then(response => response.json());Received response:
Request failed with error:
Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.
Tournament leaders
requires authentication
Top scorers и top goalies из турнирных агрегатов.
Example request:
curl --request GET \
--get "https://api.globalsportsystems.org/v1/tournaments/45/stats?limit=10" \
--header "Authorization: Bearer {YOUR_API_TOKEN}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"$url = 'https://api.globalsportsystems.org/v1/tournaments/45/stats';
$query = http_build_query([
'limit' => 10,
]);
$url .= '?' . $query;
$ch = curl_init($url);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer {YOUR_API_TOKEN}',
'Content-Type: application/json',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
curl_close($ch);
$data = json_decode($response, true);
print_r($data);const url = new URL(
"https://api.globalsportsystems.org/v1/tournaments/45/stats"
);
const params = {
"limit": "10",
};
Object.keys(params)
.forEach(key => url.searchParams.append(key, params[key]));
const headers = {
"Authorization": "Bearer {YOUR_API_TOKEN}",
"Content-Type": "application/json",
"Accept": "application/json",
};
fetch(url, {
method: "GET",
headers,
}).then(response => response.json());Received response:
Request failed with error:
Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.
Tournament photo albums
requires authentication
Шорткат для GET /v1/albums?tournament_id={id}.
Example request:
curl --request GET \
--get "https://api.globalsportsystems.org/v1/tournaments/45/albums" \
--header "Authorization: Bearer {YOUR_API_TOKEN}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"$url = 'https://api.globalsportsystems.org/v1/tournaments/45/albums';
$ch = curl_init($url);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer {YOUR_API_TOKEN}',
'Content-Type: application/json',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
curl_close($ch);
$data = json_decode($response, true);
print_r($data);const url = new URL(
"https://api.globalsportsystems.org/v1/tournaments/45/albums"
);
const headers = {
"Authorization": "Bearer {YOUR_API_TOKEN}",
"Content-Type": "application/json",
"Accept": "application/json",
};
fetch(url, {
method: "GET",
headers,
}).then(response => response.json());Received response:
Request failed with error:
Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.
Tournament videos
requires authentication
Трансляции и видео турнира. Шорткат для GET /v1/videos?tournament_id={id}.
Example request:
curl --request GET \
--get "https://api.globalsportsystems.org/v1/tournaments/45/videos?type=live" \
--header "Authorization: Bearer {YOUR_API_TOKEN}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"$url = 'https://api.globalsportsystems.org/v1/tournaments/45/videos';
$query = http_build_query([
'type' => 'live',
]);
$url .= '?' . $query;
$ch = curl_init($url);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer {YOUR_API_TOKEN}',
'Content-Type: application/json',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
curl_close($ch);
$data = json_decode($response, true);
print_r($data);const url = new URL(
"https://api.globalsportsystems.org/v1/tournaments/45/videos"
);
const params = {
"type": "live",
};
Object.keys(params)
.forEach(key => url.searchParams.append(key, params[key]));
const headers = {
"Authorization": "Bearer {YOUR_API_TOKEN}",
"Content-Type": "application/json",
"Accept": "application/json",
};
fetch(url, {
method: "GET",
headers,
}).then(response => response.json());Received response:
Request failed with error:
Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.
Videos
Трансляции и видео лиг из scope токена. Трансляции матчей — это
type=live; кроме них бывают review (обзоры), intro/outro,
interview, player (видео игрока).
Для встраивания плеера используйте embed_url (готовая ссылка на
iframe-плеер провайдера); url — ссылка на страницу видео.
List videos
requires authentication
Все трансляции доверенных лиг токена. Без фильтров возвращаются видео
по всем лигам сразу — мульти-лиговому сайту не нужно слать по запросу
на лигу, группировать можно по полю league в каждом элементе.
Example request:
curl --request GET \
--get "https://api.globalsportsystems.org/v1/videos?league_id=1132&type=live&per_page=50&page=1" \
--header "Authorization: Bearer {YOUR_API_TOKEN}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"$url = 'https://api.globalsportsystems.org/v1/videos';
$query = http_build_query([
'league_id' => 1132,
'type' => 'live',
'per_page' => 50,
'page' => 1,
]);
$url .= '?' . $query;
$ch = curl_init($url);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer {YOUR_API_TOKEN}',
'Content-Type: application/json',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
curl_close($ch);
$data = json_decode($response, true);
print_r($data);const url = new URL(
"https://api.globalsportsystems.org/v1/videos"
);
const params = {
"league_id": "1132",
"type": "live",
"per_page": "50",
"page": "1",
};
Object.keys(params)
.forEach(key => url.searchParams.append(key, params[key]));
const headers = {
"Authorization": "Bearer {YOUR_API_TOKEN}",
"Content-Type": "application/json",
"Accept": "application/json",
};
fetch(url, {
method: "GET",
headers,
}).then(response => response.json());Received response:
Request failed with error:
Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.
Get a video
requires authentication
Example request:
curl --request GET \
--get "https://api.globalsportsystems.org/v1/videos/55012" \
--header "Authorization: Bearer {YOUR_API_TOKEN}" \
--header "Content-Type: application/json" \
--header "Accept: application/json"$url = 'https://api.globalsportsystems.org/v1/videos/55012';
$ch = curl_init($url);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer {YOUR_API_TOKEN}',
'Content-Type: application/json',
'Accept: application/json',
],
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
curl_close($ch);
$data = json_decode($response, true);
print_r($data);const url = new URL(
"https://api.globalsportsystems.org/v1/videos/55012"
);
const headers = {
"Authorization": "Bearer {YOUR_API_TOKEN}",
"Content-Type": "application/json",
"Accept": "application/json",
};
fetch(url, {
method: "GET",
headers,
}).then(response => response.json());Received response:
Request failed with error:
Tip: Check that you're properly connected to the network.
If you're a maintainer of ths API, verify that your API is running and you've enabled CORS.
You can check the Dev Tools console for debugging information.