Метод получения информации по сезонам

Содержание:

Получение списка туров по указанному сезону

Метод предназначен для получения списка туров по указанному id сезона.
url: https://offvariance.com/api/v2/{format}/seasons/{id}/{method}

Пример запроса:
json:
https://offvariance.com/api/v2/json/seasons/3331/tours/?key=demokey
xml:
https://offvariance.com/api/v2/xml/seasons/3331/tours/?key=demokey

Параметры запроса

Параметр

Описание

format

формат данных ответа от сервера

key

Ваш API ключ

Идентификатор сезона

method

имя метода

Параметры ответа

Параметр

Описание

Идентификатор страны в базе данных.

name

Наименование тура на сайте

application/json

text/xml


				{
		"result":[
			{
				"id":3332,
				"name": "1-й тур"
			},
			...
		]
	}


				 <root>
	     <result>
	        <element-0>
	            <id>3332</id>
	            <name>1-й тур</name>
	        </element-0>
	        ...
	     </result>
	 </root>

Получение списка матчей по указанному сезону

Метод предназначен для получения списка матчей с их данными и событиями по указанному id сезона.
url: https://offvariance.com/api/v2/{format}/seasons/{id}/{method}

Пример запроса
json:
https://offvariance.com/api/v2/json/seasons/3331/fixtures/?key=demokey
xml:
https://offvariance.com/api/v2/xml/seasons/3331/fixtures/?key=demokey

Параметры запроса

Параметр

Описание

format

формат данных ответа от сервера

key

Ваш API ключ

Идентификатор сезона

method

имя метода

Параметры ответа

Параметр

Описание

Идентификатор матча в базе данных

status

Статус матча. Может принимать такие значения:

preview - матч сыгран
prepare - матч сыгран, но еще нет всей информации о событиях
canceled - матч отменен
tech-defeat - техническое поражение
moved - матч перенесен
finished - матч сыгран

startTime

Дата проведения матча в Timestamp

updateTime

Дата обновления матча на сайте в Timestamp

homeTeam

Информация о домашней команде.
Массив с параметрами:

id - идентификатор команды
name - наименование команды

awayTeam

Информация о выездной команде.
Массив с параметрами:

id - идентификатор команды
name - наименование команды

duration

Продолжительность матча и таймов.
Массив с параметрами:

total - продолжительность игры
firstHalf - первый тайм
secondHalf - второй тайм

homeScore

Счет домашней команды.
Массив с параметрами:

final - счет по окончанию игры
firstHalf - счет по окончанию первого тайма

awayScore

Счет выездной команды.
Массив с параметрами:

final - счет по окончанию игры
firstHalf - счет по окончанию первого тайма

country

Страна проведения чемпионата.
Массив с параметрами:

id - идентификатор
name - наименование

tournament

Чемпионат.
Массив с параметрами:

id - идентификатор
name - наименование

season

Сезон чемпионата.
Массив с параметрами:

id - идентификатор
name - наименование

events

События матча.
Массив событий, у каждого события есть такие параметры:

homeScore - счет домашней команды на момент события
awayScore - счет выездной команды на момент события
minute - минута
author - игрок, создавший событие. Его идентификатор и имя
teamId - идентификатор команды игрока, создавшего событие
type - тип события. Может принимать такие значения: goal, own-goal, red-card, penalty-goal, penalty-miss, miss, save, block.
xg - значение xg

odds

Коэффициенты матча.
Всего их 5: home, draw, away, totalOver25, totalUnder25.
У каждого есть значение open(открытие) и last(текущий).

limits

Лимиты матча.
Всего их 5: home, draw, away, totalOver25, totalUnder25.
У каждого есть значение open(открытие) и last(текущий).

application/json

text/xml


							{
				  "result": {
				    "id": 124846,
				    "status": "finished",
				    "startTime": 1628940600,
				    "updateTime": 1634947563,
				    "homeTeam": {
				      "id": 6712,
				      "name": "Manchester Utd"
				    },
				    "awayTeam": {
				      "id": 14846,
				      "name": "Leeds"
				    },
				    "duration": {
				      "total": 93,
				      "firstHalf": 46,
				      "secondHalf": 48
				    },
				    "homeScore": {
				      "final": 5,
				      "firstHalf": 1
				    },
				    "awayScore": {
				      "final": 1,
				      "firstHalf": 0
				    },
				    "country": {
				      "id": 291,
				      "name": "England"
				    },
				    "tournament": {
				      "id": 325,
				      "name": "Premier League"
				    },
				    "season": {
				      "id": 8202,
				      "name": "2021/2022"
				    },
				    "events": [
				      {
				        "homeScore": 0,
				        "awayScore": 0,
				        "minute": 2,
				        "author": {
				          "id": 6782,
				          "name": "S. MCTOMINAY"
				        },
				        "teamId": 6712,
				        "type": "block",
				        "xg": 0.026
				      },
						...
				      {
				        "homeScore": 5,
				        "awayScore": 1,
				        "minute": 87,
				        "author": {
				          "id": 7635,
				          "name": "L. AYLING"
				        },
				        "teamId": 14846,
				        "type": "miss",
				        "xg": 0.01
				      }
				    ],
				    "odds": [
				      {
				        "type": "home",
				        "open": 1.57,
				        "last": 1.67
				      },
				      {
				        "type": "draw",
				        "open": 4.65,
				        "last": 4.2
				      },
				      {
				        "type": "away",
				        "open": 5.77,
				        "last": 5.4
				      },
				      {
				        "type": "totalOver25",
				        "open": 1.55,
				        "last": 1.7
				      },
				      {
				        "type": "totalUnder25",
				        "open": 2.61,
				        "last": 2.27
				      }
				    ]
				  }
				}


	 Ссылка на пример файла