SStats.net использует протокол REST API для взаимодействия. В ответе возвращается либо json, либо csv. - Основной адрес: `https://api.sstats.net` - Ссылка для передачи в ИИ: `https://sstats.net/llms.txt` [Подробнее об интеграции с ИИ](https://sstats.net/posts/api-ai-usage) **Авторизация и лимиты** SStats.net API не требует авторизации. API доступно без регистрации и api ключа. Но у открытого досутпа существует ограничения на количество запросв. Это сделано для предотвращения ddos атак и возможности равномерного распредения квот между всеми пользователями. Для обеспечения стабильного доступа с расширенными лимитами **рекомендуется** зарегистрироваться и получить **бесплатный** индивидуальный API ключ. [➔ Читайте инструкцию ](/posts/api-auth) как получить API ключ и использовать его в запросах --- Отправной точкой для работы с API может послужить получение всего списка лиг ### 1. Получение списка доступных лиг Познакомьтесь с нашим Coverage. Данный запрос возвращает все имеющиеся лиги, страны, сезоны. Используйте иденитфикаторы лиг и сезонов для извлечения матчей. https://api.sstats.net/leagues ```http GET /Leagues ``` **Пример ответа:** ```json { "status": "ok", "data": [ { "id": 39, "name": "Premier League", "country": {"code": "EN", "name": "England"}, "seasons": [...] } ] } ``` Далее можно перейти к получению списка матчей. ### 2. Загрузка матчей лиги за сезон Этот запрос является основным, для получения списка матчей. Поддерживаются различные фильтры, по лигам, командам, дням и т.д Для начала можно извлечь все матчи за сезон. Идентификаторы лиги и сезона мы узнали из предыдущего запроса. https://api.sstats.net/Games/list?leagueid=39&year=2024 ```http GET /Games/list?leagueid=39&year=2024 ``` **Параметры:** - `leagueid` - ID лиги из предыдущего запроса - `year` - год сезона - `limit` - количество матчей (до 1000) - `offset` - смещение для пагинации *Примечание:* Запрос не возвращает полную инфомрацию о матчах и является лишь кратким перечислением. Подробную информацию необходимо запрашивать отдельным запросом для каждого матча Подробную инструкцию по настройке фильтров читайте [➔ здесь](posts/api-games-list) **Дополнительные фильтры:** ```http # Только завершенные матчи GET /Games/list?leagueid=39&year=2024&ended=true # Матчи конкретной команды GET /Games/list?team=529&year=2024 # Матчи за определенный период GET /Games/list?leagueid=39&from=2024-01-01&to=2024-01-31 ``` https://api.sstats.net/Games/list?leagueid=39&year=2024&ended=true ### 3. Получение детальной информации о матче А вот и главный запрос для получения подробных данных по матчу. Запрос содержит самые актуальные на данный момент данные по матчу (кроме коэффициентов, они всегда доматчевые) https://api.sstats.net/Games/971762 ```http GET /Games/{id} ``` **Возвращает:** - Полную информацию о матче - Составы команд и статистику игроков - События матча (голы, карточки, замены) - Детальную статистику команд - Доматчевые коэффициенты Если матч находится в лайве, то самые актуальные данные (статистика, события) будут в этом запросе. Кроме коэффициенов. Даже если матч идёт в лайве, коэффициенты будут доматчевые (самые последние, перед началом матча) Т.к коэффициентов и букмекеров много, они вынесены в отдельный запрос. Получение лайв коэффициентов, так же в отдельном запросе ### 4. Получение коэффициентов матча https://api.sstats.net/Odds/1350725 ```http # Доматчевые коэффициенты (доступны коэффициенты открытия и закрытия) GET /Odds/{gameId} # Live-коэффициенты GET /Odds/live/{gameId} # Коэффициенты конкретного букмекера GET /Odds/{gameId}?bookmakerId=4 # история движения коэффициентов в лайве GET /oods/live-changes/{gameId} ``` ### 5. Анализ с помощью Glicko 2 https://api.sstats.net/Games/glicko/1350725 ```http GET /Games/glicko/{gameId} ``` Возвращает рейтинги команд и прогнозируемые вероятности побед на основе математической модели Glicko 2. ### 6. Анализ прибыльности стратегий https://api.sstats.net/Games/profits?gameId=1350725&limit=25&thisLeague=true ```http GET /Games/profits?gameId={id}&limit=25 ``` Показывает историческую прибыльность различных типов ставок для команд на основе их предыдущих матчей. --- ### 💡 Полезные советы 1. **Ознакомтесь с актуальной документацией**: [➜ API Документация](https://api.sstats.net/docs). Узнайте какие есть запрсы и типы возвращаемых данных. 2. **Используйте Postman**: Пробуйте уже готовые запросы в [➜ Postman](https://www.postman.com/whispryte/sstats-net/collection/lu941wt/sstats-net-api). Самый удобный интерфейс для отправки запросов. 3. **API ключ и регистраиция**: Помните, что API без ключа имеет ограничения - 300 запросов/мин на всех пользователей. [➜ Зарегистрируйтесь](https://sstats.net/login) и получите бесплатный API ключ для расширенного доступа 4. **Используйте документацию в ИИ**: Скормите нашу документацию вашему любимому ИИ чат боту, и он сделает за вас всю работу. [➜ Интеграция с ИИ](https://sstats.net/posts/api-ai-usage). Задавайте ему любые вопросы по API. 5. **Присоединяйтесь к сообществу**: Задавайте свои вопросы в [нашем VK сообществе](https://vk.com/sstats_net). Делитесь идеями и свомим продуктами на основе нашего API