Изображения команд и игроков через API

IMAGES API

Что в модуле изображений

Единый endpoint для получения URL изображения участника — команды, игрока, лиги или страны.

Логотипы команд

SVG и PNG в нескольких размерах. Автоматически обновляются при смене официальной эмблемы клуба.

Фото игроков

Официальные фото из профилей. Заглушка по умолчанию, если фото ещё не загружено.

Логотипы лиг

Эмблемы лиг и турниров для всех видов спорта из каталога покрытия SportWire.

Флаги стран

SVG-флаги для 250+ стран — для отображения национальности игрока или страны лиги.

Пример запроса

GET /v1/participant/{id}/image

{
  "participant_id": 1234,
  "type": "team",
  "url": "https://cdn.sportwire.ru/teams/1234.svg",
  "format": "svg",
  "sizes": {
    "small":  "https://cdn.sportwire.ru/teams/1234_50.png",
    "medium": "https://cdn.sportwire.ru/teams/1234_200.png",
    "large":  "https://cdn.sportwire.ru/teams/1234_500.png"
  }
}

Тот же endpoint работает для type=player, league, country.

Покрытие

Команды 460 000+

Игроки 2.1M+

Лиги и турниры 18 000+

Страны 250+

FORMATS

Форматы и размеры

Выбирайте формат под конкретную задачу — от иконки в 50px до полноразмерного SVG.

Размер	Разрешение	Формат	Применение
Small	50 × 50 px	PNG	Иконки в списке, аватар в мобильном приложении
Medium	200 × 200 px	PNG	Карточки матчей, превью, виджеты
Large	500 × 500 px	PNG	Детальные страницы команды, OG-изображения
SVG	Векторный	SVG	Любой масштаб без потери качества, ретина-экраны

CDN & CACHING

CDN-рекомендации

Изображения редко меняются — правильное кэширование снижает нагрузку и ускоряет загрузку страниц.

Кэшируйте изображения на стороне CDN

Проксируйте запросы через собственный CDN (Cloudflare, CloudFront и т.д.) — это снизит задержки и нагрузку на тарифный лимит.

Ставьте Cache-Control: max-age=86400

Логотипы команд и флаги меняются редко. Заголовок max-age=86400 (24 ч) оптимален для большинства случаев.

Не используйте тарифный лимит для изображений в продакшне

Получите URL один раз, сохраните в своей базе или CDN. Не запрашивайте один и тот же URL каждый раз при рендере страницы — это тратит лимит впустую.

Логотипы и фото — готовы к использованию

460 000+ изображений команд и игроков через один endpoint. Подключите и забудьте про ручной поиск ассетов.

Документация

Оплата в рублях Договор с ИП / ООО Пробный доступ бесплатно

Логотипы команд и фото игроков через API