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

  1. HTTP-запрос
  2. Query-параметры
  3. Ответы
    1. Код 200
      1. Представление
      2. Поля

HTTP-запрос

GET /events\
?offset={string}\
&limit={string}\
&eventId={array}\
&dateFrom={string}\
&dateTo={string}\
&updatedAfter={string}

Query-параметры

offset

string

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

limit

string

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

eventId

array

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

dateFrom

string

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

dateTo

string

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

updatedAfter

string

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

offset

string

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

limit

string

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

eventId

array

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

dateFrom

string

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

dateTo

string

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

updatedAfter

string

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

Ответы

Код 200

OK

{
  "events": [
    {
      "additional": {},
      "ageRestriction": integer,
      "briefDescription": string,
      "countries": [
        string
      ],
      "duration": integer,
      "fullDescription": string,
      "id": string,
      "images": [
        {
          "type": string,
          "url": string
        }
      ],
      "integrations": [
        {
          "serviceId": string,
          "sourceId": string
        }
      ],
      "name": string,
      "nonStop": boolean,
      "organizer": string,
      "originalTitle": string,
      "participants": [
        {
          "id": string,
          "integrations": [
            {
              "serviceId": string,
              "sourceId": string
            }
          ],
          "name": string,
          "roles": [
            string
          ]
        }
      ],
      "permanent": boolean,
      "productionYear": integer,
      "ratings": [
        {
          "source": string,
          "url": string,
          "value": number,
          "votes": integer
        }
      ],
      "releaseDate": string,
      "sourceLink": string,
      "stageTheatre": string,
      "state": string,
      "synonyms": [
        string
      ],
      "tags": [
        {
          "name": string,
          "type": string
        }
      ],
      "type": string,
      "urls": [
        string
      ],
      "videos": [
        {
          "language": string,
          "type": string,
          "url": string
        }
      ]
    }
  ],
  "paging": {
    "limit": string,
    "offset": string,
    "total": string
  }
}
Скопировано

Представление

Свернуть всё
Развернуть всё

Поля

events[]

array

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

events[].additional

object

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

events[].ageRestriction

integer

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

events[].briefDescription

string

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

events[].countries[]

array

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

events[].duration

integer

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

events[].fullDescription

string

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

events[].id *

string

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

events[].images[]

array

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

events[].images[].type *

string

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

events[].images[].url *

string

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

events[].integrations[]

array

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

events[].integrations[].serviceId

string

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

events[].integrations[].sourceId

string

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

events[].name *

string

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

events[].nonStop

boolean

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

events[].organizer

string

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

events[].originalTitle

string

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

events[].participants[]

array

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

events[].participants[].id *

string

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

events[].participants[].integrations[]

array

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

events[].participants[].integrations[].serviceId

string

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

events[].participants[].integrations[].sourceId

string

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

events[].participants[].name *

string

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

events[].participants[].roles[]

array

Роли участника.

events[].permanent

boolean

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

events[].productionYear

integer

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

events[].ratings[]

array

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

events[].ratings[].source *

string

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

events[].ratings[].url *

string

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

events[].ratings[].value *

number

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

events[].ratings[].votes *

integer

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

events[].releaseDate

string

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

events[].sourceLink

string

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

events[].stageTheatre

string

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

events[].state

string

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

events[].synonyms[]

array

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

events[].tags[]

array

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

events[].tags[].name *

string

Имя тега.

events[].tags[].type *

string

Тип тега.

events[].type

string

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

Значение по умолчанию: OTHER_EVENT.

Возможные значения
  1. OTHER_EVENT
  2. MOVIE
  3. CONCERT
  4. THEATRE
  5. ART
  6. LECTURE

events[].urls[]

array

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

events[].videos[]

array

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

events[].videos[].language *

string

Язык видео.

events[].videos[].type *

string

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

events[].videos[].url *

string

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

paging

object

paging.limit *

string

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

paging.offset *

string

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

paging.total *

string

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

events[]

array

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

events[].additional

object

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

events[].ageRestriction

integer

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

events[].briefDescription

string

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

events[].countries[]

array

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

events[].duration

integer

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

events[].fullDescription

string

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

events[].id *

string

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

events[].images[]

array

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

events[].images[].type *

string

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

events[].images[].url *

string

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

events[].integrations[]

array

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

events[].integrations[].serviceId

string

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

events[].integrations[].sourceId

string

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

events[].name *

string

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

events[].nonStop

boolean

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

events[].organizer

string

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

events[].originalTitle

string

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

events[].participants[]

array

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

events[].participants[].id *

string

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

events[].participants[].integrations[]

array

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

events[].participants[].integrations[].serviceId

string

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

events[].participants[].integrations[].sourceId

string

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

events[].participants[].name *

string

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

events[].participants[].roles[]

array

Роли участника.

events[].permanent

boolean

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

events[].productionYear

integer

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

events[].ratings[]

array

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

events[].ratings[].source *

string

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

events[].ratings[].url *

string

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

events[].ratings[].value *

number

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

events[].ratings[].votes *

integer

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

events[].releaseDate

string

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

events[].sourceLink

string

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

events[].stageTheatre

string

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

events[].state

string

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

events[].synonyms[]

array

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

events[].tags[]

array

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

events[].tags[].name *

string

Имя тега.

events[].tags[].type *

string

Тип тега.

events[].type

string

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

Значение по умолчанию: OTHER_EVENT.

Возможные значения
  1. OTHER_EVENT
  2. MOVIE
  3. CONCERT
  4. THEATRE
  5. ART
  6. LECTURE

events[].urls[]

array

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

events[].videos[]

array

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

events[].videos[].language *

string

Язык видео.

events[].videos[].type *

string

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

events[].videos[].url *

string

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

paging

object

paging.limit *

string

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

paging.offset *

string

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

paging.total *

string

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