Table Tennis — особенности данных
Настольный теннис добавляет к Match отдельный объект tableTennis: TableTennisData (с v2.0.34): формат серии, счёт по партиям и розыгрыши по партиям (point-by-point). Объект Match.tennis — только у большого тенниса: структура розыгрышей там другая (сет → геймы → очки), в настольном теннисе геймов нет (партия → розыгрыши).
Поля под настольный теннис — в интерактивном дереве ниже. Вкладка Match — общая структура матча (поле tableTennis подсвечено), вкладка TableTennisData — структура объекта (sets, pointByPoint). Источник — спека, авто-синхронизация; блоки кода иллюстративны.
Sport Schema Explorer
Выберите вид спорта — поля, специфичные для него, подсветятся и раскроются; неприменимые приглушатся. Поля без бейджей — общие для всех видов спорта.
MatchidintegerstatusstringstatusDescriptionstringnullabledateEventstringstartTimestampintegercurrentMatchMinuteintegercurrentMatchSecondintegerovertimeLengthintegertournamentTournamentBriefidintegernamestringtranslationsobjectimagestringcategoryCategoryBriefidintegernamestringtranslationsobjectimagestringroundInfoRoundInfonamestringroundintegerseasonSeasonBriefidintegernamestringyearstringisCurrentbooleanstartDateTimestampintegerendDateTimestampintegervenueVenueidintegernullablenamestringnullabletranslationsobjectcapacityintegernullablecityobjectcountryobjectrefereeRefereeФутболidintegernullablenamestringyellowCardsintegerredCardsintegeryellowRedCardsintegergamesintegercountryobjecttranslationsobjecthomeTeamTeamWithLineupidintegernullablenamestringnullablefullNamestringnullabletranslationsobjectgenderstringnullablecountrystringnullablemanagerManagernullableimagestringlineupLineupnullableФутболХоккейБаскетболВолейболawayTeamTeamWithLineupidintegernullablenamestringnullablefullNamestringnullabletranslationsobjectgenderstringnullablecountrystringnullablemanagerManagernullableimagestringlineupLineupnullableФутболХоккейБаскетболВолейболhomeScoreScorecurrentintegerperiod1integerperiod2integerperiod3integernullableperiod4integernullableperiod5integernullableperiod6integernullableБаскетболНастольный теннисperiod7integernullableБаскетболНастольный теннисperiod1TieBreakintegernullableТеннисperiod2TieBreakintegernullableТеннисperiod3TieBreakintegernullableТеннисperiod4TieBreakintegernullableТеннисperiod5TieBreakintegernullableТеннисpenaltiesintegernullableФутболХоккейdisplaystringnullablepointstringnullableТеннисawayScoreScorecurrentintegerperiod1integerperiod2integerperiod3integernullableperiod4integernullableperiod5integernullableperiod6integernullableБаскетболНастольный теннисperiod7integernullableБаскетболНастольный теннисperiod1TieBreakintegernullableТеннисperiod2TieBreakintegernullableТеннисperiod3TieBreakintegernullableТеннисperiod4TieBreakintegernullableТеннисperiod5TieBreakintegernullableТеннисpenaltiesintegernullableФутболХоккейdisplaystringnullablepointstringnullableТеннисliveEventsLiveEvent[]ФутболХоккейБаскетболВолейболНастольный теннисtimeintegertimeSecondsintegertypestringclassstringteamstringplayerobjectplayerInobjectplayerOutobjectreasonstringfromstringhomeScoreintegerawayScoreintegerperiodintegernullabledescriptionstringplayerNamestringassist1Namestringassist2NamestringmanagerobjectrescindedbooleanplayerInNamestringplayerOutNamestringinjurybooleansequenceintegernullableconfirmedbooleannullableaddedTimeintegerФутболlengthintegernullableФутболtextstringisLivebooleanmatchStatisticsMatchStatisticsPeriod[]periodstringgroupsMatchStatisticsGroup[]oddsBaseOddsMarket[]namestringgroupstringperiodstringisLivebooleansuspendedbooleanchoicesOddsChoice[]highlightsHighlight[]titlestringurlstringimagestringesportsEsportsDatanullableКиберспортbestOfintegernullablegamesEsportsGame[]tennisTennisDatanullableТеннисbestOfintegernullablegroundTypestringnullablefirstToServestringnullablehomePlayerSeedstringnullableawayPlayerSeedstringnullablesetsTennisSet[]nullablemomentumTennisMomentumItem[]nullablepointByPointTennisPointByPointSet[]nullabletableTennisTableTennisDatanullableНастольный теннисbestOfintegernullablesetsTableTennisSet[]nullablepointByPointTableTennisPointByPointSet[]nullablehasBkOddsobjectmelbetbooleanparibooleanmarathonbooleanbetboombooleanpinnaclebooleanoddsBkBookmakerOddsnullablemelbetBookmakerOddsDatapariBookmakerOddsDatamarathonBookmakerOddsDatabetboomBookmakerOddsDatapinnacleBookmakerOddsDataattendanceintegernullablewinnerstringnullablewinnerCodeintegernullablepregamePregameBlocknullableh2hobjectnullableteamStreaksobjectnullableformobjectnullablebestPlayersBestPlayersnullableФутболХоккейБаскетболplayerOfTheMatchBestPlayerItemnullablehomeBestPlayerItem[]awayBestPlayerItem[]analyticsMatchAnalyticsAvailabilityshotmapAnalyticsStatusmomentumAnalyticsStatusaveragePositionsAnalyticsStatusscoreStatusMatchScoreStatusfinalbooleannullableScore
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.
Связанные ссылки
- API Reference — выберите
sportSlug=table-tennisв каждой operation - Sport-specific → Tennis — для сравнения с большим теннисом