TennisData

Корневой объект с данными теннисного матча. Содержит информацию о формате серии, покрытии, подаче, посеве игроков, детализацию по сетам, momentum-график и (при запросе одного матча) point-by-point данные.

bestOfintegernullable

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

Example: 3

groundTypestringnullable

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

Possible values: [Hardcourt outdoor, Hardcourt indoor, Clay, Grass]

Example: Hardcourt outdoor

firstToServestringnullable

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

Possible values: [home, away]

Example: home

homePlayerSeedstringnullable

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

Example: 25

awayPlayerSeedstringnullable

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

Example: 18

sets object[]nullable

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

Array [

setNumberinteger

Номер сета (1-5)

Example: 3

homeGamesinteger

Количество геймов, выигранных домашним игроком в этом сете

Example: 7

awayGamesinteger

Количество геймов, выигранных гостевым игроком в этом сете

Example: 6

winnerstringnullable

Победитель сета. null если сет ещё не завершён

Possible values: [home, away]

Example: home

durationSecondsintegernullable

Длительность сета в секундах

Example: 3423

tiebreak objectnullable

Данные тайбрейка. Присутствует только если в сете был тайбрейк (обычно при счёте 6-6). Тайбрейк — специальный гейм, в котором очки считаются последовательно (1, 2, 3...) до 7 с разницей минимум 2.

homePointsinteger

Очки домашнего игрока в тайбрейке

Example: 7

awayPointsinteger

Очки гостевого игрока в тайбрейке

Example: 4

]

momentum object[]nullable

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

Array [

setinteger

Номер сета

Example: 1

gameinteger

Номер гейма в сете

Example: 9

valuenumber

Значение импульса. Положительное значение — доминирование домашнего игрока (home), отрицательное — гостевого (away). Диапазон примерно от -100 до +100. Чем больше абсолютное значение, тем увереннее была победа в гейме.

Example: -17.48

breakOccurredboolean

Был ли брейк подачи в этом гейме. Брейк — ситуация когда принимающий игрок выиграл гейм на подаче соперника.

Example: true

]

pointByPoint object[]nullable

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

Array [

setinteger

Номер сета

Example: 3

games object[]

Массив геймов в сете (в обратном хронологическом порядке — от последнего к первому)

Array [

gameinteger

Номер гейма в сете

Example: 13

isTiebreakboolean

Является ли этот гейм тайбрейком. В тайбрейке используется другая система подсчёта очков (1, 2, 3... вместо 15, 30, 40).

Example: true

score objectnullable

Счёт по геймам в сете после завершения данного гейма, а также информация о подающем и победителе

homeGamesinteger

Геймы домашнего игрока в сете после этого гейма

Example: 7

awayGamesinteger

Геймы гостевого игрока в сете после этого гейма

Example: 6

servingstringnullable

Кто подавал в этом гейме

Possible values: [home, away]

Example: home

wonBystringnullable

Кто выиграл этот гейм

Possible values: [home, away]

Example: home

points object[]

Массив очков в гейме в хронологическом порядке. Каждое очко содержит текущий счёт и тип розыгрыша.

Array [

homePointstringnullable

Очко домашнего игрока после розыгрыша. В обычном гейме: "0", "15", "30", "40", "A" (advantage). В тайбрейке: "0", "1", "2", ... (последовательные числа).

Example: 40

awayPointstringnullable

Очко гостевого игрока после розыгрыша

Example: 30

descriptionstringnullable

Тип розыгрыша

Possible values: [normal, ace, doubleFault]

Example: ace

homePointTypestringnullable

Результат розыгрыша для домашнего игрока. winner — игрок выиграл очко активным ударом; ace — выиграл очко подачей навылет; error — соперник допустил ошибку; doubleFault — двойная ошибка при подаче; loser — игрок проиграл очко.

Possible values: [winner, doubleFault, ace, loser, error]

Example: ace

awayPointTypestringnullable

Результат розыгрыша для гостевого игрока

Possible values: [winner, doubleFault, ace, loser, error]

Example: loser

]

]

]

TennisData

{
  "bestOf": 3,
  "groundType": "Hardcourt outdoor",
  "firstToServe": "home",
  "homePlayerSeed": "25",
  "awayPlayerSeed": "18",
  "sets": [
    {
      "setNumber": 3,
      "homeGames": 7,
      "awayGames": 6,
      "winner": "home",
      "durationSeconds": 3423,
      "tiebreak": {
        "homePoints": 7,
        "awayPoints": 4
      }
    }
  ],
  "momentum": [
    {
      "set": 1,
      "game": 9,
      "value": -17.48,
      "breakOccurred": true
    }
  ],
  "pointByPoint": [
    {
      "set": 3,
      "games": [
        {
          "game": 13,
          "isTiebreak": true,
          "score": {
            "homeGames": 7,
            "awayGames": 6,
            "serving": "home",
            "wonBy": "home"
          },
          "points": [
            {
              "homePoint": "40",
              "awayPoint": "30",
              "description": "ace",
              "homePointType": "ace",
              "awayPointType": "loser"
            }
          ]
        }
      ]
    }
  ]
}