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

Request

GET

/events

Query parameters

Name

Description

dateFrom

Type: string<date-time>

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

Example: ``

dateTo

Type: string<date-time>

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

Example: ``

eventId

Type: string[]

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

Example: ``

limit

Type: string<int64>

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

Example: ``

offset

Type: string<int64>

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

Example: ``

updatedAfter

Type: string<date-time>

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

Example: ``

Responses

200 OK

OK

Body

application/json
{
  "events": [
    {
      "id": "example",
      "name": "example",
      "type": "OTHER_EVENT",
      "ageRestriction": 0,
      "duration": 0,
      "tags": [
        {
          "name": "example",
          "type": "example",
          "id": "example"
        }
      ],
      "participants": [
        {
          "id": "example",
          "name": "example",
          "roles": [
            null
          ],
          "integrations": [
            null
          ]
        }
      ],
      "images": [
        {
          "url": "example",
          "type": "example"
        }
      ],
      "videos": [
        {
          "url": "example",
          "type": "example",
          "language": "example"
        }
      ],
      "urls": [
        "example"
      ],
      "fullDescription": "example",
      "briefDescription": "example",
      "originalTitle": "example",
      "countries": [
        "example"
      ],
      "productionYear": 0,
      "stageTheatre": "example",
      "state": "example",
      "releaseDate": "example",
      "nonStop": true,
      "organizer": "example",
      "permanent": true,
      "sourceLink": "example",
      "ratings": [
        {
          "value": 0.5,
          "votes": 0,
          "source": "example",
          "url": "example"
        }
      ],
      "synonyms": [
        "example"
      ],
      "integrations": [
        {
          "serviceId": "example",
          "sourceId": "example"
        }
      ],
      "additional": {},
      "season": true,
      "agreementRequirements": [
        {
          "eventSaleAgreementType": "PERSONAL_DATA_PROCESSING",
          "required": true,
          "url": "example"
        }
      ],
      "personalDataRequirements": [
        {
          "eventSaleAgreementType": "PHONE_NUMBER",
          "required": true
        }
      ]
    }
  ],
  "paging": {
    "limit": "example",
    "offset": "example",
    "total": "example"
  }
}

Name

Description

events

Type: Event[]

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

Example
[
  {
    "id": "example",
    "name": "example",
    "type": "OTHER_EVENT",
    "ageRestriction": 0,
    "duration": 0,
    "tags": [
      {
        "name": "example",
        "type": "example",
        "id": "example"
      }
    ],
    "participants": [
      {
        "id": "example",
        "name": "example",
        "roles": [
          "OTHER_ROLE"
        ],
        "integrations": [
          {}
        ]
      }
    ],
    "images": [
      {
        "url": "example",
        "type": "example"
      }
    ],
    "videos": [
      {
        "url": "example",
        "type": "example",
        "language": "example"
      }
    ],
    "urls": [
      "example"
    ],
    "fullDescription": "example",
    "briefDescription": "example",
    "originalTitle": "example",
    "countries": [
      "example"
    ],
    "productionYear": 0,
    "stageTheatre": "example",
    "state": "example",
    "releaseDate": "example",
    "nonStop": true,
    "organizer": "example",
    "permanent": true,
    "sourceLink": "example",
    "ratings": [
      {
        "value": 0.5,
        "votes": 0,
        "source": "example",
        "url": "example"
      }
    ],
    "synonyms": [
      "example"
    ],
    "integrations": [
      null
    ],
    "additional": {},
    "season": true,
    "agreementRequirements": [
      {
        "eventSaleAgreementType": "PERSONAL_DATA_PROCESSING",
        "required": true,
        "url": "example"
      }
    ],
    "personalDataRequirements": [
      {
        "eventSaleAgreementType": "PHONE_NUMBER",
        "required": true
      }
    ]
  }
]

paging

Type: ListInfo

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

Example
{
  "limit": "example",
  "offset": "example",
  "total": "example"
}

EventType

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

Type: string

Default: OTHER_EVENT

Enum: OTHER_EVENT, MOVIE, CONCERT, THEATRE, ART, LECTURE, QUEST, SPORT, EXCURSIONS, STANDUP

Tag

Name

Description

name

Type: string

Имя тега.

Example: example

type

Type: string

Тип тега.

Example: example

id

Type: string

Уникальный идентификатор тега.

Example: example
Example
{
  "name": "example",
  "type": "example",
  "id": "example"
}

Role

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

Type: string

Default: OTHER_ROLE

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

SourceRef

Name

Description

serviceId

Type: string

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

Example: example

sourceId

Type: string

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

Example: example
Example
{
  "serviceId": "example",
  "sourceId": "example"
}

Participant

Name

Description

id

Type: string

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

Example: example

name

Type: string

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

Example: example

integrations

Type: SourceRef[]

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

Example
[
  {
    "serviceId": "example",
    "sourceId": "example"
  }
]

roles

Type: Role[]

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

Example
[
  "OTHER_ROLE"
]
Example
{
  "id": "example",
  "name": "example",
  "roles": [
    "OTHER_ROLE"
  ],
  "integrations": [
    {
      "serviceId": "example",
      "sourceId": "example"
    }
  ]
}

Image

Name

Description

type

Type: string

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

Example: example

url

Type: string

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

Example: example
Example
{
  "url": "example",
  "type": "example"
}

Video

Name

Description

language

Type: string

Язык видео.

Example: example

type

Type: string

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

Example: example

url

Type: string

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

Example: example
Example
{
  "url": "example",
  "type": "example",
  "language": "example"
}

Rating

Name

Description

source

Type: string

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

Example: example

url

Type: string

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

Example: example

value

Type: number

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

votes

Type: integer

Число голосов, на основе которых построен рейтинг.
Example
{
  "value": 0.5,
  "votes": 0,
  "source": "example",
  "url": "example"
}

EventSaleAgreementType

  • PERSONAL_DATA_PROCESSING: Обработка персональных данных.
  • AUDIENCE_BEHAVIOR_RULES: Согласие с правилами поведения.
  • THIRD_PARTY_NEWSLETTER: Согласие на получение рассылок от третьих лиц.
  • TICKETS_SALE_RULES: Согласие с условиями продажи.
  • CONTEST_RULES: Согласие с правилами конкурса.
  • COVID_VACCINATED: Подтвержение прививки от COVID-19.

Type: string

Default: PERSONAL_DATA_PROCESSING

Enum: PERSONAL_DATA_PROCESSING, AUDIENCE_BEHAVIOR_RULES, THIRD_PARTY_NEWSLETTER, TICKETS_SALE_RULES, CONTEST_RULES, COVID_VACCINATED

EventSaleAgreementRequirement

Name

Description

eventSaleAgreementType

Type: EventSaleAgreementType

Тип согласия.

  • PERSONAL_DATA_PROCESSING: Обработка персональных данных.
  • AUDIENCE_BEHAVIOR_RULES: Согласие с правилами поведения.
  • THIRD_PARTY_NEWSLETTER: Согласие на получение рассылок от третьих лиц.
  • TICKETS_SALE_RULES: Согласие с условиями продажи.
  • CONTEST_RULES: Согласие с правилами конкурса.
  • COVID_VACCINATED: Подтвержение прививки от COVID-19.

Default: PERSONAL_DATA_PROCESSING

Enum: PERSONAL_DATA_PROCESSING, AUDIENCE_BEHAVIOR_RULES, THIRD_PARTY_NEWSLETTER, TICKETS_SALE_RULES, CONTEST_RULES, COVID_VACCINATED

required

Type: boolean

Согласие обязательно.

url

Type: string

Url на правила.

Example: example
Example
{
  "eventSaleAgreementType": "PERSONAL_DATA_PROCESSING",
  "required": true,
  "url": "example"
}

EventSalePersonalDataRequirementType

  • PHONE_NUMBER: Номер телефона.
  • BIRTH_DATE: Дата рождения.
  • EMAIL: email.
  • FULLNAME: Фамилия Имя.
  • FULLNAME_WITH_PATRONYMIC: Фамилия Имя Отчество.
  • DOCUMENT_TYPE: Тип документа.
  • DOCUMENT_NUMBER: Номер документа.

Type: string

Default: PHONE_NUMBER

Enum: PHONE_NUMBER, BIRTH_DATE, EMAIL, FULLNAME, FULLNAME_WITH_PATRONYMIC, DOCUMENT_TYPE, DOCUMENT_NUMBER

EventSalePersonalDataRequirement

Name

Description

eventSaleAgreementType

Type: EventSalePersonalDataRequirementType

Тип персональных данных.

  • PHONE_NUMBER: Номер телефона.
  • BIRTH_DATE: Дата рождения.
  • EMAIL: email.
  • FULLNAME: Фамилия Имя.
  • FULLNAME_WITH_PATRONYMIC: Фамилия Имя Отчество.
  • DOCUMENT_TYPE: Тип документа.
  • DOCUMENT_NUMBER: Номер документа.

Default: PHONE_NUMBER

Enum: PHONE_NUMBER, BIRTH_DATE, EMAIL, FULLNAME, FULLNAME_WITH_PATRONYMIC, DOCUMENT_TYPE, DOCUMENT_NUMBER

required

Type: boolean

Поле обязательно для заполнения.
Example
{
  "eventSaleAgreementType": "PHONE_NUMBER",
  "required": true
}

Event

Name

Description

id

Type: string

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

Example: example

name

Type: string

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

Example: example

additional

Type: object

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

Example
{}

ageRestriction

Type: integer

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

agreementRequirements

Type: EventSaleAgreementRequirement[]

Список согласия для продажи.

Example
[
  {
    "eventSaleAgreementType": "PERSONAL_DATA_PROCESSING",
    "required": true,
    "url": "example"
  }
]

briefDescription

Type: string

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

Example: example

countries

Type: string[]

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

Example
[
  "example"
]

duration

Type: integer

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

fullDescription

Type: string

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

Example: example

images

Type: Image[]

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

Example
[
  {
    "url": "example",
    "type": "example"
  }
]

integrations

Type: SourceRef[]

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

Example
[
  {
    "serviceId": "example",
    "sourceId": "example"
  }
]

nonStop

Type: boolean

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

organizer

Type: string

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

Example: example

originalTitle

Type: string

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

Example: example

participants

Type: Participant[]

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

Example
[
  {
    "id": "example",
    "name": "example",
    "roles": [
      "OTHER_ROLE"
    ],
    "integrations": [
      {
        "serviceId": "example",
        "sourceId": "example"
      }
    ]
  }
]

permanent

Type: boolean

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

personalDataRequirements

Type: EventSalePersonalDataRequirement[]

Список необходимых персональных данных.

Example
[
  {
    "eventSaleAgreementType": "PHONE_NUMBER",
    "required": true
  }
]

productionYear

Type: integer

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

ratings

Type: Rating[]

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

Example
[
  {
    "value": 0.5,
    "votes": 0,
    "source": "example",
    "url": "example"
  }
]

releaseDate

Type: string

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

Example: example

season

Type: boolean

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

sourceLink

Type: string

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

Example: example

stageTheatre

Type: string

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

Example: example

state

Type: string

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

Example: example

synonyms

Type: string[]

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

Example
[
  "example"
]

tags

Type: Tag[]

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

Example
[
  {
    "name": "example",
    "type": "example",
    "id": "example"
  }
]

type

Type: EventType

Тип события.

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

Default: OTHER_EVENT

Enum: OTHER_EVENT, MOVIE, CONCERT, THEATRE, ART, LECTURE, QUEST, SPORT, EXCURSIONS, STANDUP

urls

Type: string[]

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

Example
[
  "example"
]

videos

Type: Video[]

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

Example
[
  {
    "url": "example",
    "type": "example",
    "language": "example"
  }
]
Example
{
  "id": "example",
  "name": "example",
  "type": "OTHER_EVENT",
  "ageRestriction": 0,
  "duration": 0,
  "tags": [
    {
      "name": "example",
      "type": "example",
      "id": "example"
    }
  ],
  "participants": [
    {
      "id": "example",
      "name": "example",
      "roles": [
        "OTHER_ROLE"
      ],
      "integrations": [
        {
          "serviceId": "example",
          "sourceId": "example"
        }
      ]
    }
  ],
  "images": [
    {
      "url": "example",
      "type": "example"
    }
  ],
  "videos": [
    {
      "url": "example",
      "type": "example",
      "language": "example"
    }
  ],
  "urls": [
    "example"
  ],
  "fullDescription": "example",
  "briefDescription": "example",
  "originalTitle": "example",
  "countries": [
    "example"
  ],
  "productionYear": 0,
  "stageTheatre": "example",
  "state": "example",
  "releaseDate": "example",
  "nonStop": true,
  "organizer": "example",
  "permanent": true,
  "sourceLink": "example",
  "ratings": [
    {
      "value": 0.5,
      "votes": 0,
      "source": "example",
      "url": "example"
    }
  ],
  "synonyms": [
    "example"
  ],
  "integrations": [
    null
  ],
  "additional": {},
  "season": true,
  "agreementRequirements": [
    {
      "eventSaleAgreementType": "PERSONAL_DATA_PROCESSING",
      "required": true,
      "url": "example"
    }
  ],
  "personalDataRequirements": [
    {
      "eventSaleAgreementType": "PHONE_NUMBER",
      "required": true
    }
  ]
}

ListInfo

Name

Description

limit

Type: string<int64>

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

Example: example

offset

Type: string<int64>

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

Example: example

total

Type: string<int64>

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

Example: example
Example
{
  "limit": "example",
  "offset": "example",
  "total": "example"
}

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

Предыдущая
Возвращает список площадок в городе
Следующая
Возвращает список залов на указанной площадке