1 of 4

Статические данные

Сначала вам нужно будет создать базу данных либо сформировать перечень «файткардов» (перечень мероприятий) и связанных с соответствующим файткардом/мероприятием боев.

Заголовки, необходимые для использования наших конечных точек:

Ключевой параметр

Значение

application/vnd.imggaming.dde.api+json;version=1

Content-Type

application/json

Authorization

Bearer eyvhaoudfgpdfgo*

Чтобы получить перечень «файткардов» либо мероприятий, нажмите на конечную точку файткарда UFC от IMG:

https://dde-api.data.imgarena.com/mma/fightcards

Обратите внимание на значения ключевых параметров, необходимые для данной конечной точки:

Конечная точка

Описание

Ссылка на «песочницу»

fightcardName

название файткарда

identifier

идентификатор файткарда

EventId

Если вы хотите просмотреть только информацию по конкретному файткарду, вы можете передать соответствующий идентификатор мероприятия, например:

https://dde-api.data.imgarena.com/mma/fightcards/{id}

Получить по запросу данные по «файткардам» для заданного диапазона дат можно, передав параметры «dateFrom» и «dateTo». Оба параметра должны представлять собой дату в формате YYYY-mm-dd.

Кроме того, вам понадобится получить перечень связанных с соответствующим файткардом/мероприятием боев. Это можно сделать, передав параметр «EventId» по файткарду через конечную точку «Расписание» по мероприятиям UFC на IMG Arena.

https://dde-api.data.imgarena.com/mma/fightcards/{id}/schedule

Обратите внимание на значения ключевых параметров, необходимые для конечной точки:

Конечная точка

Описание

Ссылка на «песочницу»

redTeam

Объект, содержащий в себе информацию о бойце из красной команды

blueTeam

Объект, содержащий в себе информацию о бойце из синей команды

fightId

Идентификационный номер боя

fightId

Конечная точка файткардов

Данная конечная точка позволяет получить информацию обо всех файткардах, как прошлых так и нынешних.

URL-адреса конечных точек

Все турниры:

https://dde-api.data.imgarena.com/mma/fightcards

Если вы хотите просмотреть только информацию по конкретному файткарду:

https://dde-api.data.imgarena.com/mma/fightcards/{id}

Обязательные заголовки

Ключевой параметр

Значение

application/vnd.imggaming.dde.api+json;version=1

Content-Type

application/json

Authorization

Bearer eyvhaoudfgpdfgo*

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

Если направить запрос на данную конечную точку с одновременным указанием параметров «dateFrom» и «dateTo», то в овтет будут получены данные только по файткардам, входящим в пределы определенного диапазона дат. Оба параметра должны представлять собой дату в формате YYYY-mm-dd.

Модель ответа

Объект «турнир»

Имя поля

Тип

Описание

fightcardName

строка

название файткарда

identifier

целое число

идентификатор файткарда

countryCode

строка

код страны, в которой проходит файткард

location

строка

страна, в которой проходит файткард

state

строка

штат/провинция, где проходит файткард

city

строка

город, в котором проходит файткард

venue

строка

название места, в котором проходит файткард

venueId

целое число

идентификатор места, в котором проходит файткард

startDate

дата

дата начала файткарда

endDate

дата

дата окончания файткарда

startTime

время

время, когда стартует файткард, в формате местного времени + смещение от всемирного координированного времени (UTC)

utcOffset

целое число

смещение от UTC часового пояса, в котором проходит файткард

year

целое число

год, в котором проходит файткард

sport

строка

вид спорта, связанный с файткардом, в данном случае ММА

numberOfFights

целое число

количество боев по файткарду

scheduleResource

строка

ссылка на URL-адрес API, по которому доступно расписание данного файткарда

status

строка

статус данного файткарда.

Возможные значения: «active» / «canceled».

booking Status

объект

информация о том, забронирован ли файткард

comments

массив

последние комментарии к статусу файткарда

numberOfFightsBookedToday

целое число

количество боев, забронированных с помощью функции DDE в соответствии с вашим лицензионным соглашением

eventSummary

объект

сводные данные по предварительным и основным кардам, т.е., начало и количество боев

attendance

целое число

общее число присутствующих болельщиков

competitions

массив

Объект «Сводные данные по боям»

Каждый файткард будет разбит на три карда; «main», «prelims1» и «prelims 2». Данный объект будет сообщать дату боя и три указанных карда.

Имя поля

Тип

Описание

fights

целое число

количество боев в данном конкретном файткарде

startTime

время

предполагаемое время старта данного конкретного карда

Объект «Статус бронирования»

Имя поля

Тип

Описание

status

строка

Текущий статус бронирования мероприятия с помощью функции DDE

Объект «Состязания»

Имя поля

Тип

Описание

organisation

строка

организация, проводящая данный конкретный файткард

startDate

дата

дата начала файткарда

endDate

дата

дата завершения файткарда

licensingProperty

строка

DDE-объект, лицензирующий данный конкретный файткард

Образец ответа

{
    "city": "Las Vegas",
    "startTime": "22:00",
    "location": "USA",
    "endDate": "2022-09-10",
    "fightcardName": "UFC 279: Chimaev vs. Diaz",
    "state": "Nevada",
    "identifier": 758,
    "numberOfFightsBookedToday": 13,
    "year": 2022,
    "sport": "MMA",
    "venueId": "50",
    "scheduleResource": "/mma/fightcards/758/schedule",
    "countryCode": "USA",
    "status": "active",
    "numberOfFights": 13,
    "eventsSummary": {
        "2022-09-10": {
            "prelims1": {
                "fights": 4,
                "startTime": "00:00"
            },
            "prelims2": {
                "fights": 4,
                "startTime": "22:00"
            },
            "main": {
                "fights": 5,
                "startTime": "02:00"
            }
        }
    },
    "utcOffset": 0,
    "attendance": null,
    "startDate": "2022-09-10",
    "bookingStatus": {
        "status": "AutoBooked"
    },
    "venue": "T-Mobile Arena",
    "competitions": [
        {
            "organisation": "UFC",
            "startDate": "2022-09-10",
            "endDate": "2022-09-10"
        }
    ],
    "comments": []
}

Конечная точка расписания файткардов

Данная конечная точка позволяет получить информацию о расписании конкретного файткарда.

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

URL-адреса конечных точек

https://dde-api.data.imgarena.com/mma/fightcards/{id}/schedule

Обязательные заголовки

Ключевой параметр

Значение

application/vnd.imggaming.dde.api+json;version=1

Content-Type

application/json

Authorization

Bearer eyvhaoudfgpdfgo*

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

Данная конечная точка не требует никаких параметров

Модель ответа:

Объект «Расписание файткарда»

Имя поля

Тип

Описание

startTime

объект

Объект, содержащий в себе «status» – статус времени начала, например, «EstimatedStart» и «time», расчетное время начала в формате местного времени + смещение от всемирного координированного времени (UTC)

weightClass

объект

Объект, содержащий в себе информацию о весовой категории

referee

объект

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

startTimeText

строка

Текстовое описание времени начала. Обратите внимание на тот факт, что подробную информацию о начале содержит в себе объект «время начала», который, вероятно, будет более полезным, чем данное поле. Основные значения: «Starts At», «Follows Previous»

fightOrder

целое число

Порядковый номер боя по карду. Бой номер 1 – главное мероприятие, номер 2 – сопутствующее главному мероприятие и так далее, соответственно, первый бой вечера имеет самый большой номер. Главное мероприятие – всегда под номером 1

fightcardId

целое число

Идентификатор файткарда, в котором проходит бой

accolades

объект

Объект, содержащий в себе информацию о поясе и титуле пояса

fightSeq

целое число

Место боя в последовательности файткарда. 1 если перво, 2 если второе и т.д.

redTeam

объект

Объект, содержащий в себе информацию о бойце из красной команды

Date

строка

Дата проведения боя

blueTeam

объект

Объект, содержащий в себе информацию о бойце из синей команды

status

строка

Статус боя. Возможные значения: «Not Started», «In Progress» либо «Finished»

cardSegment

строка

Сегмент карда, которому относится данный бой. Варианты: main, prelims1, prelims2

fightId

строка

Идентификационный номер боя

fightType

объект

Содержит в себе информацию о типе боя, общем количестве возможных раундов

bookingStatus

объект

Информация о том, забронирован бой или нет

Объект «Время начала»

Имя поля

Тип

Описание

status

строка

Статус текущего времени начала, например, «EstimatedStart»

time

строка

Формат: время начала боя + смещение от UTC

Объект «Весовая категория»

Имя поля

Тип

Описание

weight

строка

Весовой диапазон, в фунтах, весовой категории

description

строка

Описание весовой категории

целое число

Идентификатор весовой категории

obsolete

логическое выражение

Подробная информация о том, действует ли весовая категория в соответствующей организации

abbreviation

строка

Сокращенное описание весовой категории

Объект «Рефери»

Имя поля

Тип

Описание

целое число

идентификатор рефери

firstName

строка

имя рефери

lastName

строка

фамилия рефери

Объект «Регалии»

Имя поля

Тип

Описание

belt

строка

тип пояса

name

строка

титул пояса

Объект «Красная команда»

Имя поля

Тип

Описание

fighter1

объект

подробная информация о бойце в составе красной команды

rank

строка

текущий рейтинг бойца. (может отображаться пустое значение, если бойцу рейтинг не присвоен)

accolades

объект

Объект «Боец 1»

Имя поля

Тип

Описание

reach

десятичная дробь

размах рук, в дюймах, бойца. Если неизвестно, будет нулевым.

dob

дата

дата рождения бойца

fightsOutOf

строка

город, штат, страна, код страны, от которой в настоящее время бьется боец

height

целое число

рост бойца, в дюймах. Если неизвестно, будет нулевым.

country

строка

код страны бойца

age

целое число

возраст бойца

weighInWeight

плавающее значение

вес бойца, в фунтах. Если неизвестно, будет нулевым.

lastName

строка

фамилия бойца

stance

строка

стойка бойца. Возможные значения: «Orthodox», «Southpaw», «Switch», «Open». Если неизвестно, будет нулевым.

firstName

строка

имя бойца

nickName

строка

прозвище бойца

целое число

идентификатор бойца

born

строка

город, штат, страна, код страны, где родился боец

record

объект

показатели бойца по победам/поражениям/ничьим/отмененным участиям в состязаниях

accolades

строка

будет порожним, если у бойца нету титулов. В противном случае будет разъяснять, обладатаелем какого титула явлется боец.

Объект Показатели

Имя поля

Тип

Описание

wins

целое число

количество побед в профессиональной карьере бойца

losses

целое число

количество поражений в профессиональной карьере бойца

draws

целое число

количество ничьих в профессиональной карьере бойца

noContest

целое число

количество профессиональных состязаний, в которых участвовал боец

Объект «Синяя команда»

Имя поля

Тип

Описание

fighter1

объект

подробная информация о бойце в составе синей команды

rank

объект

текущий рейтинг бойца. (может отображаться пустое значение, если бойцу рейтинг не присвоен)

accolades

объект

отображается пустое значение, даже для чемпионов

Объект «Тип боя»

Имя поля

Тип

Описание

possibleRounds

целое число

количество возможных раундов

description

строка

описание по количеству раундов

Объект «Статус бронирования»

Имя поля

Тип

Описание

status

строка

Образец ответа

    {
        "startTime": {
            "status": "EstimatedStart",
            "time": "04:00Z"
        },
        "weightClass": {
            "weight": "156-170",
            "description": "Welterweight",
            "id": 16,
            "obsolete": false,
            "abbreviation": "WW"
        },
        "referee": null,
        "startTimeText": "Follows Previous",
        "fightOrder": 1,
        "fightcardId": 758,
        "accolades": null,
        "fightSeq": 13,
        "redTeam": {
            "fighter1": {
                "reach": 75.0,
                "dob": "1994-05-01",
                "fightsOutOf": "Chechnya, RUS",
                "height": 74,
                "country": "RUS",
                "age": 28,
                "weighInWeight": null,
                "lastName": "Chimaev",
                "stance": "ORTHODOX",
                "firstName": "Khamzat",
                "nickName": "Borz",
                "id": 3457,
                "born": "Benoy-Yurt, Chechnya, RUS",
                "record": {
                    "wins": 11,
                    "losses": 0,
                    "draws": 0,
                    "noContests": 0
                }
            },
            "rank": 3,
            "accolades": null
        },
        "date": "2022-09-10",
        "blueTeam": {
            "fighter1": {
                "reach": 76.0,
                "dob": "1985-04-16",
                "fightsOutOf": "Stockton, California, USA",
                "height": 72,
                "country": "USA",
                "age": 37,
                "weighInWeight": null,
                "lastName": "Diaz",
                "stance": "SOUTHPAW",
                "firstName": "Nate",
                "nickName": null,
                "id": 274,
                "born": "Stockton, California, USA",
                "record": {
                    "wins": 21,
                    "losses": 13,
                    "draws": 0,
                    "noContests": 0
                }
            },
            "rank": null,
            "accolades": null
        },
        "status": "Upcoming",
        "cardSegment": "main",
        "fightId": 7399,
        "fightType": {
            "possibleRounds": 5,
            "description": "5 Rnd (5-5-5-5-5)"
        },
        "bookingStatus": {
            "status": "AutoBooked"
        }
    },

Частота передачи данных по конечным точкам (RESTful)

Чтобы обеспечить себе наличие неизменно актуальной информации, рекомендуем отправлять запросы REST со указанной ниже частотой:

Обратите внимание на тот факт, что через конечную точку файткрадов UFC будут доступны только следующие 3 или 4 будущих мероприятия. Это связано с тем, что UFC все еще организовывает проходящие бои.

Конечная точка расписания файткардов

Данная конечная точка позволяет получить информацию о расписании конкретного файткарда.

URL-адреса конечных точек

https://dde-api.data.imgarena.com/mma/fightcards/{id}/schedule

Обязательные заголовки

Ключевой параметр

Значение

application/vnd.imggaming.dde.api+json;version=1

Content-Type

application/json

Authorization

Bearer eyvhaoudfgpdfgo*

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

Данная конечная точка не требует никаких параметров

Модель ответа:

Объект «Расписание файткарда»

Имя поля

Тип

Описание

startTime

объект

weightClass

объект

Объект, содержащий в себе информацию о весовой категории

referee

объект

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

startTimeText

строка

fightOrder

целое число

fightcardId

целое число

Идентификатор файткарда, в котором проходит бой

accolades

объект

Объект, содержащий в себе информацию о поясе и титуле пояса

fightSeq

целое число

Место боя в последовательности файткарда. 1 если перво, 2 если второе и т.д.

redTeam

объект

Объект, содержащий в себе информацию о бойце из красной команды

Date

строка

Дата проведения боя

blueTeam

объект

Объект, содержащий в себе информацию о бойце из синей команды

status

строка

Статус боя. Возможные значения: «Not Started», «In Progress» либо «Finished»

cardSegment

строка

Сегмент карда, которому относится данный бой. Варианты: main, prelims1, prelims2

fightId

строка

Идентификационный номер боя

fightType

объект

Содержит в себе информацию о типе боя, общем количестве возможных раундов

bookingStatus

объект

Информация о том, забронирован бой или нет

Объект «Время начала»

Имя поля

Тип

Описание

status

строка

Статус текущего времени начала, например, «EstimatedStart»

time

строка

Формат: время начала боя + смещение от UTC

Объект «Весовая категория»

Имя поля

Тип

Описание

weight

строка

Весовой диапазон, в фунтах, весовой категории

description

строка

Описание весовой категории

целое число

Идентификатор весовой категории

obsolete

логическое выражение

Подробная информация о том, действует ли весовая категория в соответствующей организации

abbreviation

строка

Сокращенное описание весовой категории

Объект «Рефери»

Имя поля

Тип

Описание

целое число

идентификатор рефери

firstName

строка

имя рефери

lastName

строка

фамилия рефери

Объект «Регалии»

Имя поля

Тип

Описание

belt

строка

тип пояса

name

строка

титул пояса

Объект «Красная команда»

Имя поля

Тип

Описание

fighter1

объект

подробная информация о бойце в составе красной команды

rank

строка

текущий рейтинг бойца. (может отображаться пустое значение, если бойцу рейтинг не присвоен)

accolades

объект

Объект «Боец 1»

Имя поля

Тип

Описание

reach

десятичная дробь

размах рук, в дюймах, бойца. Если неизвестно, будет нулевым.

dob

дата

дата рождения бойца

fightsOutOf

строка

город, штат, страна, код страны, от которой в настоящее время бьется боец

height

целое число

рост бойца, в дюймах. Если неизвестно, будет нулевым.

country

строка

код страны бойца

age

целое число

возраст бойца

weighInWeight

плавающее значение

вес бойца, в фунтах. Если неизвестно, будет нулевым.

lastName

строка

фамилия бойца

stance

строка

стойка бойца. Возможные значения: «Orthodox», «Southpaw», «Switch», «Open». Если неизвестно, будет нулевым.

firstName

строка

имя бойца

nickName

строка

прозвище бойца

целое число

идентификатор бойца

born

строка

город, штат, страна, код страны, где родился боец

record

объект

показатели бойца по победам/поражениям/ничьим/отмененным участиям в состязаниях

accolades

строка

Объект Показатели

Имя поля

Тип

Описание

wins

целое число

количество побед в профессиональной карьере бойца

losses

целое число

количество поражений в профессиональной карьере бойца

draws

целое число

количество ничьих в профессиональной карьере бойца

noContest

целое число

количество профессиональных состязаний, в которых участвовал боец

Объект «Синяя команда»

Имя поля

Тип

Описание

fighter1

объект

подробная информация о бойце в составе синей команды

rank

объект

текущий рейтинг бойца. (может отображаться пустое значение, если бойцу рейтинг не присвоен)

accolades

объект

отображается пустое значение, даже для чемпионов

Объект «Тип боя»

Имя поля

Тип

Описание

possibleRounds

целое число

количество возможных раундов

description

строка

описание по количеству раундов

Объект «Статус бронирования»

Имя поля

Тип

Описание

status

строка

Образец ответа

    {
        "startTime": {
            "status": "EstimatedStart",
            "time": "04:00Z"
        },
        "weightClass": {
            "weight": "156-170",
            "description": "Welterweight",
            "id": 16,
            "obsolete": false,
            "abbreviation": "WW"
        },
        "referee": null,
        "startTimeText": "Follows Previous",
        "fightOrder": 1,
        "fightcardId": 758,
        "accolades": null,
        "fightSeq": 13,
        "redTeam": {
            "fighter1": {
                "reach": 75.0,
                "dob": "1994-05-01",
                "fightsOutOf": "Chechnya, RUS",
                "height": 74,
                "country": "RUS",
                "age": 28,
                "weighInWeight": null,
                "lastName": "Chimaev",
                "stance": "ORTHODOX",
                "firstName": "Khamzat",
                "nickName": "Borz",
                "id": 3457,
                "born": "Benoy-Yurt, Chechnya, RUS",
                "record": {
                    "wins": 11,
                    "losses": 0,
                    "draws": 0,
                    "noContests": 0
                }
            },
            "rank": 3,
            "accolades": null
        },
        "date": "2022-09-10",
        "blueTeam": {
            "fighter1": {
                "reach": 76.0,
                "dob": "1985-04-16",
                "fightsOutOf": "Stockton, California, USA",
                "height": 72,
                "country": "USA",
                "age": 37,
                "weighInWeight": null,
                "lastName": "Diaz",
                "stance": "SOUTHPAW",
                "firstName": "Nate",
                "nickName": null,
                "id": 274,
                "born": "Stockton, California, USA",
                "record": {
                    "wins": 21,
                    "losses": 13,
                    "draws": 0,
                    "noContests": 0
                }
            },
            "rank": null,
            "accolades": null
        },
        "status": "Upcoming",
        "cardSegment": "main",
        "fightId": 7399,
        "fightType": {
            "possibleRounds": 5,
            "description": "5 Rnd (5-5-5-5-5)"
        },
        "bookingStatus": {
            "status": "AutoBooked"
        }
    },

Конечная точка файткардов

Данная конечная точка позволяет получить информацию обо всех файткардах, как прошлых так и нынешних.

URL-адреса конечных точек

Все турниры:

https://dde-api.data.imgarena.com/mma/fightcards

Если вы хотите просмотреть только информацию по конкретному файткарду:

https://dde-api.data.imgarena.com/mma/fightcards/{id}

Обязательные заголовки

Ключевой параметр

Значение

application/vnd.imggaming.dde.api+json;version=1

Content-Type

application/json

Authorization

Bearer eyvhaoudfgpdfgo*

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

Модель ответа

Объект «турнир»

Имя поля

Тип

Описание

fightcardName

строка

название файткарда

identifier

целое число

идентификатор файткарда

countryCode

строка

код страны, в которой проходит файткард

location

строка

страна, в которой проходит файткард

state

строка

штат/провинция, где проходит файткард

city

строка

город, в котором проходит файткард

venue

строка

название места, в котором проходит файткард

venueId

целое число

идентификатор места, в котором проходит файткард

startDate

дата

дата начала файткарда

endDate

дата

дата окончания файткарда

startTime

время

utcOffset

целое число

смещение от UTC часового пояса, в котором проходит файткард

year

целое число

год, в котором проходит файткард

sport

строка

вид спорта, связанный с файткардом, в данном случае ММА

numberOfFights

целое число

количество боев по файткарду

scheduleResource

строка

ссылка на URL-адрес API, по которому доступно расписание данного файткарда

status

строка

статус данного файткарда.

Возможные значения: «active» / «canceled».

booking Status

объект

информация о том, забронирован ли файткард

comments

массив

последние комментарии к статусу файткарда

numberOfFightsBookedToday

целое число

количество боев, забронированных с помощью функции DDE в соответствии с вашим лицензионным соглашением

eventSummary

объект

сводные данные по предварительным и основным кардам, т.е., начало и количество боев

attendance

целое число

общее число присутствующих болельщиков

competitions

массив

Объект «Сводные данные по боям»

Имя поля

Тип

Описание

fights

целое число

количество боев в данном конкретном файткарде

startTime

время

предполагаемое время старта данного конкретного карда

Объект «Статус бронирования»

Имя поля

Тип

Описание

status

строка

Текущий статус бронирования мероприятия с помощью функции DDE

Объект «Состязания»

Имя поля

Тип

Описание

organisation

строка

организация, проводящая данный конкретный файткард

startDate

дата

дата начала файткарда

endDate

дата

дата завершения файткарда

licensingProperty

строка

DDE-объект, лицензирующий данный конкретный файткард

Образец ответа

{
    "city": "Las Vegas",
    "startTime": "22:00",
    "location": "USA",
    "endDate": "2022-09-10",
    "fightcardName": "UFC 279: Chimaev vs. Diaz",
    "state": "Nevada",
    "identifier": 758,
    "numberOfFightsBookedToday": 13,
    "year": 2022,
    "sport": "MMA",
    "venueId": "50",
    "scheduleResource": "/mma/fightcards/758/schedule",
    "countryCode": "USA",
    "status": "active",
    "numberOfFights": 13,
    "eventsSummary": {
        "2022-09-10": {
            "prelims1": {
                "fights": 4,
                "startTime": "00:00"
            },
            "prelims2": {
                "fights": 4,
                "startTime": "22:00"
            },
            "main": {
                "fights": 5,
                "startTime": "02:00"
            }
        }
    },
    "utcOffset": 0,
    "attendance": null,
    "startDate": "2022-09-10",
    "bookingStatus": {
        "status": "AutoBooked"
    },
    "venue": "T-Mobile Arena",
    "competitions": [
        {
            "organisation": "UFC",
            "startDate": "2022-09-10",
            "endDate": "2022-09-10"
        }
    ],
    "comments": []
}