Перейти к основному содержимому

Table Tennis — особенности данных

Настольный теннис добавляет к Match отдельный объект tableTennis: TableTennisData (с v2.0.34): формат серии, счёт по партиям и розыгрыши по партиям (point-by-point). Объект Match.tennis — только у большого тенниса: структура розыгрышей там другая (сет → геймы → очки), в настольном теннисе геймов нет (партия → розыгрыши).

Поля под настольный теннис — в интерактивном дереве ниже. Вкладка Match — общая структура матча (поле tableTennis подсвечено), вкладка TableTennisData — структура объекта (sets, pointByPoint). Источник — спека, авто-синхронизация; блоки кода иллюстративны.

Sport Schema Explorer

Выберите вид спорта — поля, специфичные для него, подсветятся и раскроются; неприменимые приглушатся. Поля без бейджей — общие для всех видов спорта.

10 спорт-специфичных полей в Match
idinteger

Уникальный идентификатор матча

statusstring

Статус матча

enum: notstartedinprogressfinishedcanceledpostponedinterruptedsuspendeddelayedwillcontinue

statusDescriptionstringnullable

Человекочитаемое описание статуса матча

dateEventstring

Дата события

startTimestampinteger

Время начала матча в миллисекундах

currentMatchMinuteinteger

Текущая минута матча на момент формирования ответа (в WebSocket — на момент сообщения, см. его timestamp). В футболе вычисляется от часов матча при каждом запросе (только пока status = inprogress; у завершённых и прерванных матчей — минута последнего события, 0 без событий); в хоккее/баскетболе — по данным источника; в остальных видах (теннис и др.) — время с начала текущего отрезка (сета/матча), пока матч идёт. В WebSocket-дельты попадает, как правило, при смене состояния часов (старт тайма или овертайма, изменение добавленного времени), а не каждую секунду; любое сообщение с этим полем — точка ресинхронизации, между ними отсчёт ведите локально от timestamp сообщения, пока status = inprogress и идёт игровой отрезок (statusDescription)

currentMatchSecondinteger

Текущая секунда матча (в пределах минуты) на момент формирования ответа или WebSocket-сообщения — см. currentMatchMinute

overtimeLengthinteger

Добавленное время в секундах. Присутствует только когда оно есть.

tournamentTournamentBrief
idinteger

ID турнира

namestring

Название турнира

translationsobject
imagestring

URL изображения турнира

categoryCategoryBrief
idinteger

ID категории

namestring

Название категории

translationsobject
imagestring

URL изображения

roundInfoRoundInfo
namestring

Название раунда

roundinteger

Номер раунда

seasonSeasonBrief
idinteger
namestring
yearstring
isCurrentboolean

Признак текущего (актуального) сезона турнира. true ровно у одного сезона в списке.

startDateTimestampinteger

Unix-время (в миллисекундах) начала текущего сезона. Присутствует только у текущего сезона (isCurrent=true).

endDateTimestampinteger

Unix-время (в миллисекундах) окончания текущего сезона. Присутствует только у текущего сезона (isCurrent=true).

venueVenue
idintegernullable

ID стадиона

namestringnullable

Название стадиона

translationsobject
capacityintegernullable

Вместимость

cityobject
countryobject
refereeRefereeФутбол
idintegernullable

ID арбитра

namestring

Имя арбитра

yellowCardsinteger

Количество жёлтых карточек показанных арбитром (статистика)

redCardsinteger

Количество красных карточек показанных арбитром (статистика)

yellowRedCardsinteger

Количество вторых жёлтых карточек показанных арбитром (статистика)

gamesinteger

Количество игр проведённых арбитром (статистика)

countryobject
translationsobject
homeTeamTeamWithLineup
idintegernullable

Уникальный идентификатор команды

namestringnullable

Название команды

fullNamestringnullable

Полное название команды

translationsobject
genderstringnullable

Пол команды

enum: MF

countrystringnullable

Название страны

managerManagernullable

Тренер команды; null, если не задан.

imagestring

URL изображения команды

lineupLineupnullableФутболХоккейБаскетболВолейбол

Состав команды на матч; null, если состав недоступен.

awayTeamTeamWithLineup
idintegernullable

Уникальный идентификатор команды

namestringnullable

Название команды

fullNamestringnullable

Полное название команды

translationsobject
genderstringnullable

Пол команды

enum: MF

countrystringnullable

Название страны

managerManagernullable

Тренер команды; null, если не задан.

imagestring

URL изображения команды

lineupLineupnullableФутболХоккейБаскетболВолейбол

Состав команды на матч; null, если состав недоступен.

homeScoreScore
currentinteger

Текущий счет

period1integer

Счет в первом тайме

Значение зависит от вида спорта: тайм (футбол), период (хоккей), четверть (баскетбол), геймы в сете (теннис, наст. теннис), очки в партии (волейбол), счёт в карте (киберспорт)

period2integer

Счет во втором тайме / геймы во 2-м сете (теннис)

period3integernullable

Счет в третьем периоде / геймы в 3-м сете (теннис)

period4integernullable

Счет в четвертом периоде / геймы в 4-м сете (теннис, Grand Slam)

period5integernullable

Счет в пятом периоде / геймы в 5-м сете (теннис, Grand Slam)

period6integernullableБаскетболНастольный теннис

Счёт в 6-м периоде: 2-й овертайм (баскетбол) или геймы в 6-м сете (наст. теннис, best-of-7). При множественных овертаймах возможны и дальнейшие периоды (period7+) — редко.

period7integernullableБаскетболНастольный теннис

Счёт в 7-м периоде: 3-й овертайм (баскетбол) или геймы в 7-м сете (наст. теннис, best-of-7).

period1TieBreakintegernullableТеннис

Очки в тайбрейке 1-го сета (только теннис, только если был тайбрейк)

period2TieBreakintegernullableТеннис

Очки в тайбрейке 2-го сета (только теннис, только если был тайбрейк)

period3TieBreakintegernullableТеннис

Очки в тайбрейке 3-го сета (только теннис, только если был тайбрейк)

period4TieBreakintegernullableТеннис

Очки в тайбрейке 4-го сета (только теннис, только если был тайбрейк)

period5TieBreakintegernullableТеннис

Очки в тайбрейке 5-го сета (только теннис, только если был тайбрейк)

penaltiesintegernullableФутболХоккей

Счёт по послематчевым пенальти. Присутствует только если была серия пенальти.

displaystringnullable

Текстовое представление счёта, как отдаёт источник (например, "2-2 (5-4 pen.)" в футболе или "3 (6-4, 4-6, 7-6)" в теннисе).

pointstringnullableТеннис

Текущее очко в теннисном гейме (для live-матчей). Значения: "0", "15", "30", "40", "A" (advantage) для обычных геймов, или числа "0"-"7"+ для тайбрейков

awayScoreScore
currentinteger

Текущий счет

period1integer

Счет в первом тайме

Значение зависит от вида спорта: тайм (футбол), период (хоккей), четверть (баскетбол), геймы в сете (теннис, наст. теннис), очки в партии (волейбол), счёт в карте (киберспорт)

period2integer

Счет во втором тайме / геймы во 2-м сете (теннис)

period3integernullable

Счет в третьем периоде / геймы в 3-м сете (теннис)

period4integernullable

Счет в четвертом периоде / геймы в 4-м сете (теннис, Grand Slam)

period5integernullable

Счет в пятом периоде / геймы в 5-м сете (теннис, Grand Slam)

period6integernullableБаскетболНастольный теннис

Счёт в 6-м периоде: 2-й овертайм (баскетбол) или геймы в 6-м сете (наст. теннис, best-of-7). При множественных овертаймах возможны и дальнейшие периоды (period7+) — редко.

period7integernullableБаскетболНастольный теннис

Счёт в 7-м периоде: 3-й овертайм (баскетбол) или геймы в 7-м сете (наст. теннис, best-of-7).

period1TieBreakintegernullableТеннис

Очки в тайбрейке 1-го сета (только теннис, только если был тайбрейк)

period2TieBreakintegernullableТеннис

Очки в тайбрейке 2-го сета (только теннис, только если был тайбрейк)

period3TieBreakintegernullableТеннис

Очки в тайбрейке 3-го сета (только теннис, только если был тайбрейк)

period4TieBreakintegernullableТеннис

Очки в тайбрейке 4-го сета (только теннис, только если был тайбрейк)

period5TieBreakintegernullableТеннис

Очки в тайбрейке 5-го сета (только теннис, только если был тайбрейк)

penaltiesintegernullableФутболХоккей

Счёт по послематчевым пенальти. Присутствует только если была серия пенальти.

displaystringnullable

Текстовое представление счёта, как отдаёт источник (например, "2-2 (5-4 pen.)" в футболе или "3 (6-4, 4-6, 7-6)" в теннисе).

pointstringnullableТеннис

Текущее очко в теннисном гейме (для live-матчей). Значения: "0", "15", "30", "40", "A" (advantage) для обычных геймов, или числа "0"-"7"+ для тайбрейков

liveEventsLiveEvent[]ФутболХоккейБаскетболВолейболНастольный теннис
timeinteger

Минута матча. У событий в добавленное время — минута конца отрезка (45 / 90 / 105 / 120), а «+N» приходит отдельно в addedTime: гол на 90+2 — это time: 90, addedTime: 2

timeSecondsinteger

Время события в секундах

typestring

Тип события

enum: cardgoalsubstitutioninGamePenaltypenaltyShootoutvarDecisioninjuryTimeperiod

classstring

Класс события

teamstring

Команда события

enum: homeaway

playerobject
playerInobject

Игрок входящий (для замен)

playerOutobject

Игрок выходящий (для замен)

reasonstring

Причина события

fromstring

Откуда (например, penalty для гола)

homeScoreinteger

Счет хозяев после события

awayScoreinteger

Счет гостей после события

periodintegernullable

Номер периода/тайма, к которому относится событие

descriptionstring

Текстовое описание события (если есть)

playerNamestring

Имя игрока, связанного с событием (дублирует player.name для удобства)

assist1Namestring

Имя игрока, сделавшего первый ассист (голы)

assist2Namestring

Имя игрока, сделавшего второй ассист (голы)

managerobject

Тренер/официальное лицо — для карточки, показанной не игроку (type=card)

rescindedboolean

Карточка отменена (type=card)

playerInNamestring

Имя вышедшего на замену игрока (type=substitution)

playerOutNamestring

Имя заменённого игрока (type=substitution)

injuryboolean

Замена из-за травмы (type=substitution)

sequenceintegernullable

Порядковый номер удара в серии пенальти (type=penaltyShootout)

confirmedbooleannullable

Подтверждено ли решение VAR (type=varDecision)

addedTimeintegerФутбол

Добавленная минута: событие произошло на time + addedTime (time: 90, addedTime: 2 — 90+2). Ключ есть только у событий, случившихся в добавленное время (goal, card, substitution, inGamePenalty, varDecision и др.); у событий в основное время отсутствует. У type=injuryTime всегда 0 (объявление делается в основное время), объявленная продолжительность — в length

lengthintegernullableФутбол

Объявленное добавленное время в минутах (type=injuryTime). Источник публикует объявление не для всех лиг; «+N» у самих событий (addedTime) приходит независимо от него

textstring

Текст метки периода, напр. начало/конец тайма (type=period)

isLiveboolean

Идёт ли период в данный момент (type=period)

matchStatisticsMatchStatisticsPeriod[]

Статистика матча по командам, сгруппированная по периодам. Машинные ключи (key) и их переводы (RU/ES) — в [словаре статистики](https://docs.api-sport.ru/concepts/statistics-dictionary). Набор ключей, периодов и полнота значений зависят от лиги и её поставщика статистики, значения передаются как есть (см. [покрытие по лигам](https://docs.api-sport.ru/concepts/statistics-dictionary#coverage)). В киберспорте — пустой массив: статистика игроков по каждой игре (карте) — в `esports.games[].homeTeamPlayers[]` / `awayTeamPlayers[]`.

periodstring

Период: ALL — за весь матч; либо часть матча в зависимости от вида спорта: тайм (1ST/2ND), четверть (1Q–4Q), период (1ST–3RD), сет/партия (1ST–5TH).

groupsMatchStatisticsGroup[]

Группы статистических показателей.

oddsBaseOddsMarket[]

Доступные коэффициенты для матча

namestring

Название рынка ставок

groupstring

Группа ставки

periodstring

Период матча для ставки

isLiveboolean

Доступна ли ставка в live режиме

suspendedboolean

Приостановлена ли ставка

choicesOddsChoice[]

Варианты ставок с коэффициентами

highlightsHighlight[]

Видео / хайлайты матча

titlestring

Название видео/хайлайта

urlstring

URL видео (обычно YouTube)

imagestring

URL изображения превью видео

esportsEsportsDatanullableКиберспорт

Детальные данные по киберспортивному матчу. Присутствует только для матчей с sportSlug=esports (CS2, Dota 2, League of Legends). Содержит информацию о каждой игре серии, индивидуальную статистику игроков, раунды (CS2), баны героев/чемпионов (Dota 2, LoL) и командную статистику.

bestOfintegernullable

Формат серии — максимальное количество игр (например, 1, 3 или 5). Best of 3 означает, что для победы нужно выиграть 2 игры из 3.

gamesEsportsGame[]

Список отдельных игр (карт) в серии. Каждая игра содержит счёт, статистику игроков, раунды (CS2) или баны (Dota 2/LoL).

tennisTennisDatanullableТеннис

Детальные данные по теннисному матчу. Присутствует только для матчей с sportSlug=tennis. Содержит информацию о сетах (геймы, тайбрейки, длительность, победитель), подаче, посеве игроков, типе покрытия и momentum-графике. При запросе одного матча (/matches/{matchId}) также включает point-by-point данные с детализацией каждого очка.

bestOfintegernullable

Формат матча — максимальное количество сетов (3 или 5). Best of 3 — для WTA и большинства ATP турниров, Best of 5 — для мужских Grand Slam.

groundTypestringnullable

Тип покрытия корта

enum: Hardcourt outdoorHardcourt indoorClayGrass

firstToServestringnullable

Кто подаёт первым в матче

enum: homeaway

homePlayerSeedstringnullable

Посев (seed) домашнего игрока в турнире. Посев определяет рейтинг игрока в сетке турнира.

awayPlayerSeedstringnullable

Посев (seed) гостевого игрока в турнире

setsTennisSet[]nullable

Детализация по сыгранным сетам. Каждый элемент содержит количество геймов, победителя, длительность и данные тайбрейка (если был).

momentumTennisMomentumItem[]nullable

График импульса (momentum) матча. Показывает доминирование одного из игроков в каждом гейме. Положительные значения — доминирование домашнего игрока, отрицательные — гостевого.

pointByPointTennisPointByPointSet[]nullable

Подробные данные по каждому очку матча, сгруппированные по сетам и геймам. Доступно только при запросе одного матча (/matches/{matchId}). Содержит тип каждого розыгрыша (эйс, двойная ошибка, виннер) и текущий счёт.

tableTennisTableTennisDatanullableНастольный теннис

Данные матча по настольному теннису. Присутствует только для матчей с sportSlug=table-tennis (у остальных видов спорта ключа нет). Содержит формат серии и счёт по партиям; при запросе одного матча (/matches/{matchId}) и в WebSocket — также розыгрыши по партиям (pointByPoint).

bestOfintegernullable

Формат серии — максимальное количество партий (5 или 7). null, если формат не передан.

setsTableTennisSet[]nullable

Счёт по сыгранным партиям по возрастанию номера (те же значения, что homeScore/awayScore.period1–period7). null, если счёта по партиям нет.

pointByPointTableTennisPointByPointSet[]nullable

Розыгрыши по партиям. Только в /matches/{matchId} и в WebSocket (снапшот и дельты); в списках матчей ключ отсутствует. Партии — по возрастанию номера, розыгрыши внутри партии — в хронологическом порядке. null, если данных о розыгрышах нет. У завершённого матча розыгрыши могут дополняться в течение нескольких часов после окончания: источник публикует их с задержкой.

hasBkOddsobject

Наличие букмекерских коэффициентов по каждому букмекеру. Всегда присутствует в ответе

melbetboolean

Есть ли коэффициенты букмекера Melbet для данного матча

pariboolean

Есть ли коэффициенты букмекера Pari для данного матча

marathonboolean

Есть ли коэффициенты букмекера Marathon для данного матча

betboomboolean

Есть ли коэффициенты букмекера BetBoom для данного матча

pinnacleboolean

Есть ли коэффициенты букмекера Pinnacle для данного матча

oddsBkBookmakerOddsnullable

Букмекерские коэффициенты. Присутствует только при with_bk_odds=true. Ключи объекта — идентификаторы букмекеров (например 'melbet', 'pari', 'marathon', 'betboom', 'pinnacle'). Если with_bk_odds не указан, поле отсутствует

melbetBookmakerOddsData

Коэффициенты букмекера Melbet

pariBookmakerOddsData

Коэффициенты букмекера Pari

marathonBookmakerOddsData

Коэффициенты букмекера Marathon

betboomBookmakerOddsData

Коэффициенты букмекера BetBoom

pinnacleBookmakerOddsData

Коэффициенты букмекера Pinnacle (референсная линия; линии — американский формат, конвертированный в десятичный; строки и исходы дополнительно несут changedAt (мс последнего изменения цены) и limit (максимальная ставка Pinnacle)). Доступна с v2.0.27; наличие котировок Pinnacle для матча показывает hasBkOdds.pinnacle

attendanceintegernullable

Посещаемость матча (число зрителей), если известна

winnerstringnullable

Исход матча: home — победа хозяев, away — победа гостей, draw — ничья; null — исход ещё не определён

enum: homeawaydraw

winnerCodeintegernullable

Числовой код исхода: 1 — победа хозяев, 2 — победа гостей, 3 — ничья; null — исход ещё не определён

pregamePregameBlocknullable

Предматчевый контекст: очные встречи (h2h), серии команд (teamStreaks) и форма (form). Всегда присутствует в ответе матча по ID; в списках матчей — при параметре `with_pregame=true` или когда `fields` включает `pregame`. null — данных нет

h2hobjectnullable

Дуэли по очным встречам. null — данных нет

teamStreaksobjectnullable

Активные серии команд. null — данных нет

formobjectnullable

Форма команд перед матчем. null — данных нет

bestPlayersBestPlayersnullableФутболХоккейБаскетбол

Лучшие игроки матча (появляются по ходу/по завершении матча). Присутствует в ответе матча по ID; в списках — когда `fields` включает `bestPlayers`. null — данных нет

playerOfTheMatchBestPlayerItemnullable

Игрок матча

homeBestPlayerItem[]

Лучшие игроки хозяев

awayBestPlayerItem[]

Лучшие игроки гостей

analyticsMatchAnalyticsAvailability

Доступность матч-аналитики — shotmap / momentum / averagePositions — без вызова саб-эндпоинтов (v2.0.26). Всегда присутствует в ответе матча по ID; в списках — когда `fields` включает `analytics` (например fields=id,analytics)

shotmapAnalyticsStatus

Карта ударов — статус /matches/{matchId}/shotmap

momentumAnalyticsStatus

График давления — статус /matches/{matchId}/momentum

averagePositionsAnalyticsStatus

Средние позиции игроков — статус /matches/{matchId}/average-positions

scoreStatusMatchScoreStatus

Окончательность счёта завершённого матча (v2.0.27): `final` — true / false / null. Всегда присутствует в ответе матча по ID; в списках — когда `fields` включает `scoreStatus` (например fields=id,status,scoreStatus)

finalbooleannullable

true — счёт окончательный (профессиональная лига или топ-турнир, результат подтверждён повторной проверкой либо после последнего изменения прошло достаточно времени); false — матч завершён, но счёт ещё может быть скорректирован; null — матч не завершён (в т.ч. отменён / перенесён)

required обязательноеnullable может быть null без бейджа спорта — поле общее для всех 7 видов

Score​

homeScore: {
current: 4, // выигранные сеты
period1: 11, period2: 9, period3: 11, period4: 13, period5: 11,
period6: 11, period7: null,
display: "4-3 (11-9, 9-11, 11-7, 13-15, 11-9, 11-8, ...)"
}
  • Сет играется до 11 очков с разницей в 2.
  • Best of 5 или 7 — поэтому в Score встречаются period1–period7.
  • Тайбрейка как такового нет; при счёте 10–10 играют до разницы в 2.

Match.tableTennis​

tableTennis: {
bestOf: 5, // максимум партий: 5 или 7
sets: [ // по возрастанию номера, из homeScore/awayScore.periodN
{ setNumber: 1, homePoints: 8, awayPoints: 11, winner: "away" },
{ setNumber: 2, homePoints: 7, awayPoints: 11, winner: "away" },
{ setNumber: 3, homePoints: 11, awayPoints: 8, winner: "home" },
{ setNumber: 4, homePoints: 10, awayPoints: 12, winner: "away" }
],
pointByPoint: [ // только /matches/{matchId} и WebSocket
{
set: 1,
score: { homePoints: 8, awayPoints: 11, wonBy: "away" },
points: [ // хронологически: счёт партии после розыгрыша
{ homePoint: 0, awayPoint: 1, homePointType: "loser", awayPointType: "winner" },
// ...
{ homePoint: 8, awayPoint: 11, homePointType: "loser", awayPointType: "ace" }
]
}
// ... партии 2–4
]
}
  • sets — счёт по партиям (те же значения, что homeScore/awayScore.periodN). winner: null — партия не завершена (идёт или матч прерван).
  • pointByPoint приходит только в GET /v2/table-tennis/matches/{matchId} и в WebSocket (снапшот и дельты). В списках матчей (GET /v2/table-tennis/matches и др.) ключа pointByPoint в объекте нет; bestOf и sets есть везде (в fields= — значение tableTennis).
  • Партии — по возрастанию номера, розыгрыши внутри партии — в хронологическом порядке; homePoint/awayPoint — числа.
  • homePointType / awayPointType — тот же словарь, что у тенниса: winner, ace, error, doubleFault, loser; null — тип не передан или не распознан. В настольном теннисе чаще всего встречаются winner / loser.
  • score партии — по данным источника; в незавершённой партии может не совпадать с последним розыгрышем.
  • Розыгрыши публикуются с задержкой. На финальном счёте у части матчей (особенно TT Elite Series и Czech Liga Pro) розыгрышей ещё нет или они обрываются раньше конца партии. У завершённых матчей pointByPoint и liveEvents дополняются: матч повторно читается у источника через 5 минут, час, 6 часов и двое суток после окончания. Если вы кешируете завершённый матч, перечитайте его позже или оставайтесь подписаны в WebSocket — дополнения приходят обычными match_delta.
  • momentum в tableTennis нет: источник не публикует график доминирования для настольного тенниса.

Чего НЕТ в схеме​

  • Match.tennis — только в большом теннисе (/v2/tennis/*). В table-tennis вместо него — Match.tableTennis.
  • liveEvents — отдельных типов событий для настольного тенниса нет: каждый розыгрыш — событие goal (team — кто выиграл очко, homeScore/awayScore — счёт партии после розыгрыша, period — партия), итог каждой партии — событие period. Это тот же поток розыгрышей, что в tableTennis.pointByPoint, но без типа розыгрыша.

homeTeam / awayTeam​

Как и в большом теннисе — команды представляют одиночных игроков (или парных, для doubles). lineup обычно пуст, manager отсутствует.

Match.matchStatistics​

Командная статистика разбита по партиям (ALL, 1ST–5TH), группы — Points, Other. Полный список ключей с переводами на русский и испанский — в Словаре статистики. Состава (lineup) и индивидуальной player.statistics в настольном теннисе нет.

Букмекерские коэффициенты​

Единицы рынков одинаковы у всех букмекеров: handicap / total / total_team_1|2 — очки, sets_handicap / total_sets — партии, 1st_set_* — очки 1-й партии (поле unit рынка; см. Concepts → Bookmaker Odds).

Melbet поддерживает базовые рынки: ML (без ничьей), фора и тотал по очкам, фора и тотал по партиям, рынки 1-й партии. Расширенные рынки в table-tennis у Melbet обычно отсутствуют.

Pari (slug pari) настольный теннис поддерживает с v2.0.32: исход (без ничьей), фора и тотал по очкам. Marathon (slug marathon) настольный теннис поддерживает: исход (без ничьей), фора и тотал по очкам и по партиям, индивидуальные тоталы команд, тотал чёт/нечёт. Betboom (slug betboom) настольный теннис поддерживает: фора и тотал. Итог: для настольного тенниса коэффициенты доступны от Melbet, Pari, Marathon и Betboom.

Связанные ссылки​