Информация о событии

Возвращает информацию о событии.

Формат запроса

POST https://api.tickets.yandex.net/api/agent/\
 ? action=event.detail\
 & auth=<string>\
 & city_id=<number>\
 & event_id=<number>\
 & [organizer=<boolean>]\
 & [html=<boolean>]\
 & [discount=<boolean>]

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

Query-параметр	Описание
action	string Идентификатор запроса.
auth	string Идентификатор внешней системы.
city_id	number Идентификатор города.
event_id	number Идентификатор события.
organizer	boolean Флаг, указывающий, что в ответ нужно добавить массих данных организатора.
html	boolean Флаг, указывающий, что описание события должно вернуться с HTML-разметкой.
discount	boolean Флаг, указывающий, что в ответ нужно добавить массив скидок.

Формат ответа

JSON

{
  "status": string,
  "result": {
    "id": number,
    "name": string,
    "venue_id": number,
    "version_id": number,
    "version_show": number,
    "venue": string,
    "version": string,
    "address": string,
    "date": string,
    "image": string,
    "image_list": string,
    "image_poster": string,
    "descr": string,
    "status": number,
    "activity_id": number,
    "widget": string,
    "min_price": number,
    "max_price": number,
    "genres_id": array,
    "age": string,
    "meta_title": string,
    "meta_descr": string,
    "meta_kw": string,
    "close_to": number,
    "open_to_date": string,
    "close_to_date": string,
    "organizer": {
      "id": string,
      "name": string,
      "address": string,
      "inn": string
    },
    "discounts": [
      {
        "start": string,
        "end": string,
        "discount_percent": number,
        "discount_sum": number
      }
    ],
    "pro_culture_id": string,
    "pro_culture_organization_id": number,
    "has_document_verification": integer,
    "pro_culture_place_id": number,
    "khl_id": number
  }
}

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

Параметр	Описание
status	string Статус выполнения запроса. Возможные значения: `0` — запрос выполнен; `1` — произошла ошибка.
result	object Результат выполнения запроса.
result.id	number Идентификатор события.
result.name	string Название события.
result.venue_id	number Идентификатор места проведения.
result.version_id	number Идентификатор версии зала.
result.version_show	number Тип отображения схемы. Возможные значения: `0` — общая схема; `1` — список секторов.
result.venue	string Название места проведения.
result.version	string Название версии зала.
result.address	string Адрес места проведения.
result.date	string Дата события в формате YYYY-MM-DD hh:mm:ss.
result.image	string Ссылка на изображение.
result.image_list	string Ссылка на изображение для списков.
result.image_poster	string Ссылка на постер.
result.descr	string Описание события.
result.status	number Cтатус события. Возможные значения: `0` — закрыто; `1` — в продаже.
result.activity_id	number Идентификатор мероприятия.
result.widget	string Код виджета.
result.min_price	number Минимальная стоимость билета.
result.max_price	number Максимальная стоимость билета.
result.genres_id[]	array Массив идентификаторов жанров.
result.age	string Рекомендованный возраст.
result.meta_title	string Заголовок страницы.
result.meta_descr	string Описание страницы.
result.meta_kw	string Ключевые слова.
result.close_to	number Количество часов до события, когда прекращается продажа билетов.
result.open_to_date	string Дата открытия продаж на событие в формате YYYY-MM-DD hh:mm:ss.
result.close_to_date	string Дата закрытия события в формате YYYY-MM-DD hh:mm:ss.
result.organizer	object Данные об организаторе. Возвращается, если `organizer=true`.
result.organizer.id	object Идентификатор организатора.
result.organizer.name	object Юридическое название организации.
result.organizer.address	object Юридический адрес организации.
result.organizer.inn	object ИНН организации.
result.organizer.inn	object ИНН организации.
result.discounts[]	[object] Массив скидок. Возвращается, если `discount=true`.
result.discounts[].start	string Дата начала скидки.
result.discounts[].end	string Дата окончания скидки.
result.discounts[].discount_percent	number Процент скидки на билет.
result.discounts[].discount_sum	number Сумма скидки на билет.
result.pro_culture_id	string Идентификатор мероприятия из системы «PRO.Культура.РФ».
result.pro_culture_organization_id	number Идентификатор организации из системы «PRO.Культура.РФ».
result.has_document_verification	integer Если значение равно `1`, то для события нужно передавать документы зрителя. Параметр не может принимать значение `null`.
result.pro_culture_place_id	number Идентификатор площадки из системы «PRO.Культура.РФ».
result.khl_id	number Идентификатор мероприятия КХЛ. Может принимать значение `null`, если поле не было заполнено.

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

{
  "status": "0",
  "result": {
    "id": 123,
    "name": "Название события",
    "venue_id": 123,
    "version_id": 123,
    "version_show": 1,
    "venue": "Название места проведения",
    "version": "Название версии зала",
    "address": "Адрес",
    "date": "2024-02-14 22:54:55",
    "image": "https://example.com/image.jpg",
    "image_list": "https://example.com/image_list.jpg",
    "image_poster": "https://example.com/image_poster.jpg",
    "descr": "Описание события",
    "status": 1,
    "activity_id": 123,
    "widget": "https://example.com/widget",
    "min_price": 123,
    "max_price": 321,
    "genres_id": [],
    "age": "12+",
    "meta_title": "Заголовок страницы",
    "meta_descr": "Описание страницы",
    "meta_kw": "Ключевые, слова",
    "close_to": 2,
    "open_to_date": "2024-02-10 00:00",
    "close_to_date": "2024-02-14 23:00",
    "organizer": {
      "id": 123,
      "name": "Организатор",
      "address": "Адрес",
      "inn": "123456789012"
    },
    "discounts": [
      {
        "start": "2024-02-10 00:00",
        "end": "2024-02-10 23:00",
        "discount_percent": 10,
        "discount_sum": null
      }
    ],
    "pro_culture_id": "123",
    "pro_culture_organization_id": 100,
    "has_document_verification": 1,
    "pro_culture_place_id": 12345,
    "khl_id": 21
  }
}

Была ли статья полезна?

Список городов

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