Возвращает список событий

Request

GET

/events

Query parameters

Name

Description

dateFrom

Type: string<date-time>

Дата и время начала события, в формате UNIX времени.

dateTo

Type: string<date-time>

Дата и время конца события, в формате UNIX времени.

eventId

Type: string[]

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

limit

Type: string<int64>

Количество элементов в ответе.

offset

Type: string<int64>

Смещение первого элемента списка относительно его начала.
Например, при значении "offset 5" список будет начинаться с 6 элемента.

updatedAfter

Type: string<date-time>

События, обновленные после этого времени попадут в ответ.
Заполняется в формате UNIX времени.
Если поле заполнено, пагинация не работает.

Responses

200 OK

OK

Body

application/json
{
    "events": [
        {
            "id": "string",
            "name": "string",
            "type": "OTHER_EVENT",
            "ageRestriction": 0,
            "duration": 0,
            "tags": [
                {
                    "name": "string",
                    "type": "string"
                }
            ],
            "participants": [
                {
                    "id": "string",
                    "name": "string",
                    "roles": [
                        "OTHER_ROLE"
                    ],
                    "integrations": [
                        {
                            "serviceId": "string",
                            "sourceId": "string"
                        }
                    ]
                }
            ],
            "images": [
                {
                    "url": "string",
                    "type": "string"
                }
            ],
            "videos": [
                {
                    "url": "string",
                    "type": "string",
                    "language": "string"
                }
            ],
            "urls": [
                "string"
            ],
            "fullDescription": "string",
            "briefDescription": "string",
            "originalTitle": "string",
            "countries": [
                "string"
            ],
            "productionYear": 0,
            "stageTheatre": "string",
            "state": "string",
            "releaseDate": "string",
            "nonStop": false,
            "organizer": "string",
            "permanent": false,
            "sourceLink": "string",
            "ratings": [
                {
                    "value": 0,
                    "votes": 0,
                    "source": "string",
                    "url": "string"
                }
            ],
            "synonyms": [
                "string"
            ],
            "integrations": [
                {
                    "serviceId": "string",
                    "sourceId": "string"
                }
            ],
            "additional": {}
        }
    ],
    "paging": {
        "limit": "string",
        "offset": "string",
        "total": "string"
    }
}

Name

Description

events

Type: Event[]

Список событий.

paging

Type: ListInfo

Информация о пагинации ответа.

Event

Name

Description

id*

Type: string

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

name*

Type: string

Название события.

additional

Type: object

Служебное поле.

ageRestriction

Type: integer<int32>

Возрастное ограничение.

briefDescription

Type: string

Краткое описание события.

countries

Type: string[]

Список стран, учавствовавших в производстве фильма.

duration

Type: integer<int32>

Длительность события в минутах.

fullDescription

Type: string

Подробное описание события.

images

Type: Image[]

Связанные с событием изображения.

integrations

Type: SourceRef[]

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

nonStop

Type: boolean<boolean>

Является ли фильм нонстопом (для кино).

organizer

Type: string

Организатор мероприятия.

originalTitle

Type: string

Название на языке оригинала.

participants

Type: Participant[]

Участники события.

permanent

Type: boolean<boolean>

Указывает, что событие постоянное. True для постоянного события, в противном случае false.

productionYear

Type: integer<int32>

Год выпуска фильма.

ratings

Type: Rating[]

Рейтинги события.

releaseDate

Type: string

Год выпуска фильма.

sourceLink

Type: string

Ссылка на событие на сайте партнера.

stageTheatre

Type: string

Театр-постановщик.

state

Type: string

Страна выпуска фильма.

synonyms

Type: string[]

Список синонимов.

tags

Type: Tag[]

Теги, описывающие событие.

type

Type: EventType

Тип события.

Default: OTHER_EVENT

Enum: OTHER_EVENT, MOVIE, CONCERT, THEATRE, ART, LECTURE

urls

Type: string[]

Ссылки на дополнительную информацию.

videos

Type: Video[]

Связанные с событием видео.

ListInfo

Name

Description

limit*

Type: string<int64>

Максимальное число элементов на странице.

offset*

Type: string<int64>

Смещение первого элемента списка относительно его начала.
Например, при значении "offset 5" список будет начинаться с 6 элемента.

total*

Type: string<int64>

Общее количество элементов в списке.

Image

Name

Description

type*

Type: string

Тип изображения. Например, "Постер", "Главная картинка", "Скриншот".

url*

Type: string

Ссылка на изображение.

SourceRef

Name

Description

serviceId

Type: string

Идентификатор сервиса, полученный от менеджера.

sourceId

Type: string

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

Participant

Name

Description

id*

Type: string

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

name*

Type: string

Имя участника.

integrations

Type: SourceRef[]

Службное поле.

roles

Type: Role[]

Роли участника.
- OTHER_ROLE: Роль по умолчанию.

  • ACTOR: Актер.
  • PERFORMER: Исполнитель.
  • DIRECTOR: Режиссер.
  • ARTIST: Художник.
  • AUTHOR: Автор.
  • CAMERA_OPERATOR: Оператор.
  • CHOREOGRAPHER: Хореограф.
  • COMPOSER: Композитор.
  • CONDUCTOR: Дирижер.
  • PRODUCER: Продюсер.
  • SCREENWRITER: Сценарист.
  • PRODUCTION_DESIGNER: Художник-постановщик.

Default: OTHER_ROLE

Enum: OTHER_ROLE, ACTOR, PERFORMER, DIRECTOR, ARTIST, AUTHOR, CAMERA_OPERATOR, CHOREOGRAPHER, COMPOSER, CONDUCTOR, PRODUCER, SCREENWRITER, PRODUCTION_DESIGNER

Rating

Name

Description

source*

Type: string

Источник рейтинга. Известные значения: imdb, kinopoisk.

url*

Type: string

Ссылка на страницу события на сайте рейтинга.

value*

Type: number<double>

Числовое значение рейтинга.

votes*

Type: integer<int32>

Число голосов, на основе которых построен рейтинг.

Tag

Name

Description

name*

Type: string

Имя тега.

type*

Type: string

Тип тега.

EventType

  • OTHER_EVENT: Тип по умолчанию.
  • MOVIE: Кино.
  • CONCERT: Концерт.
  • THEATRE: Спектакль.
  • ART: Выставка.
  • LECTURE: Лекция.

Type

Description

EventType

Default: OTHER_EVENT

Enum: OTHER_EVENT, MOVIE, CONCERT, THEATRE, ART, LECTURE

Video

Name

Description

language*

Type: string

Язык видео.

type*

Type: string

Тип видео. Например, "Трейлер".

url*

Type: string

Ссылка на видеофайл.

Role

  • OTHER_ROLE: Роль по умолчанию.
  • ACTOR: Актер.
  • PERFORMER: Исполнитель.
  • DIRECTOR: Режиссер.
  • ARTIST: Художник.
  • AUTHOR: Автор.
  • CAMERA_OPERATOR: Оператор.
  • CHOREOGRAPHER: Хореограф.
  • COMPOSER: Композитор.
  • CONDUCTOR: Дирижер.
  • PRODUCER: Продюсер.
  • SCREENWRITER: Сценарист.
  • PRODUCTION_DESIGNER: Художник-постановщик.

Type

Description

Role

Default: OTHER_ROLE

Enum: OTHER_ROLE, ACTOR, PERFORMER, DIRECTOR, ARTIST, AUTHOR, CAMERA_OPERATOR, CHOREOGRAPHER, COMPOSER, CONDUCTOR, PRODUCER, SCREENWRITER, PRODUCTION_DESIGNER

No longer supported, please use an alternative and newer version.