API BasketStat

Подключайте свои сервисы к онлайн-статистике: составы на матч, заявки и протоколы. Методы добавляются по мере развития платформы.

Состав на матч

Как заявка перед стартом: кто выходит, под каким номером и кто капитан.

POST https://api.basketstat.ru/v1/games/team-roster/external/ ключ acces_key

Заполнить состав

Сохраняет состав своей команды на будущий матч. Логин не нужен — достаточно ключа команды.

Команда определяется по acces_key. Матч должен быть ещё не начат, а команда — хозяином или гостем этой игры. Можно прислать только заявленных игроков: остальные с состава матча снимутся. Чужие player_id игнорируются. Капитан должен быть один.

Поле Тип Описание
acces_key string обязательно Ключ команды
game_id number обязательно ID матча из расписания
players array обязательно Игроки состава. Каждый объект: player_id, number, selected, captain
players[].player_id number обязательно ID игрока из заявки команды на этап
players[].number string необязательно Игровой номер, например "7"
players[].selected 0 | 1 необязательно 1 — заявлен на матч, 0 — не заявлен. По умолчанию 0, если игрока нет в списке
players[].captain 0 | 1 необязательно 1 — капитан. На команду остаётся только один
coach string необязательно ФИО тренера в протоколе
assistant_coach string необязательно ФИО помощника тренера
Пример запроса
{
    "acces_key": "Ключ_команды",
    "game_id": 12345,
    "coach": "Иванов Иван",
    "assistant_coach": "Петров Пётр",
    "players": [
        {
            "player_id": 101,
            "number": "7",
            "selected": 1,
            "captain": 1
        },
        {
            "player_id": 102,
            "number": "11",
            "selected": 1,
            "captain": 0
        },
        {
            "player_id": 103,
            "number": "4",
            "selected": 0,
            "captain": 0
        }
    ]
}
curl
curl -X POST 'https://api.basketstat.ru/v1/games/team-roster/external/' \
  -H 'Content-Type: application/json' \
  -d '{"acces_key":"Ключ_команды","game_id":12345,"coach":"Иванов Иван","assistant_coach":"Петров Пётр","players":[{"player_id":101,"number":"7","selected":1,"captain":1},{"player_id":102,"number":"11","selected":1,"captain":0},{"player_id":103,"number":"4","selected":0,"captain":0}]}'
Успешный ответ
{
    "status": "success",
    "message": "Состав сохранён"
}
Укажите acces_key Неверный ключ Матч не найден Состав можно заполнить только до начала матча Команда не участвует в этом матче Ошибка при сохранении состава