Возвращает список площадок в городе

Request

GET

/venues

Query parameters

Name	Description
cityId	Type: string Идентификатор города в базе данных.
limit	Type: string<int64> Количество элементов в ответе.
offset	Type: string<int64> Смещение первого элемента списка относительно его начала. Например, при значении "offset 5" список будет начинаться с 6 элемента.
updatedAfter	Type: string<date-time> События, обновленные после этого времени попадут в ответ. Заполняется в формате UNIX времени. Если поле заполнено, пагинация не работает.
venueId	Type: string[] Идентификатор площадки в базе данных.

Responses

200 OK

Body

application/json

{
    "venues": [
        {
            "id": "string",
            "name": "string",
            "cityId": "string",
            "address": "string",
            "description": "string",
            "urls": [
                "string"
            ],
            "images": [
                {
                    "url": "string",
                    "type": "string"
                }
            ],
            "videos": [
                {
                    "url": "string",
                    "type": "string",
                    "language": "string"
                }
            ],
            "subwayStations": [
                "string"
            ],
            "phones": [
                {
                    "number": "string",
                    "type": "string"
                }
            ],
            "workTimes": [
                {
                    "time": "string",
                    "type": "string"
                }
            ],
            "coordinates": {
                "latitude": 0,
                "longitude": 0
            },
            "synonyms": [
                "string"
            ],
            "tags": [
                {
                    "name": "string",
                    "type": "string"
                }
            ],
            "types": [
                "OTHER_VENUE"
            ],
            "cancelAllowance": "UNDEFINED_CANCEL_ALLOWANCE",
            "saleOpening": "string",
            "saleClosing": "string",
            "saleCanceling": "string",
            "reservationTimeout": "string",
            "integrations": [
                {
                    "serviceId": "string",
                    "sourceId": "string"
                }
            ],
            "additional": {}
        }
    ],
    "paging": {
        "limit": "string",
        "offset": "string",
        "total": "string"
    }
}

Name

Description

paging

Type: ListInfo

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

venues

Type: Venue[]

Список площадок.

ListInfo

Name	Description
limit*	Type: string<int64> Максимальное число элементов на странице.
offset*	Type: string<int64> Смещение первого элемента списка относительно его начала. Например, при значении "offset 5" список будет начинаться с 6 элемента.
total*	Type: string<int64> Общее количество элементов в списке.

Venue

Name	Description
cancelAllowance*	Type: CancelAllowance Указывает, что на площадке разрешена отмена билетов. Default: `UNDEFINED_CANCEL_ALLOWANCE` Enum: `UNDEFINED_CANCEL_ALLOWANCE`, `CANCEL_ALLOWED`, `BY_ADMINISTRATOR`, `BY_SUPPORT`, `BY_PARTNER`, `SESSION_CANCEL`
cityId*	Type: string Идентификатор города в базе данных.
id*	Type: string Идентификатор площадки в базе данных.
name*	Type: string Название площадки.
additional	Type: object Служебное поле.
address	Type: string Адрес площадки.
coordinates	Type: Coordinates Географические координаты площадки.
description	Type: string Текстовое описание площадки.
images	Type: Image[] Связанные изображения.
integrations	Type: SourceRef[] Идентификаторы площадки в сторонних базах данных (например, Яндекс.Карты).
phones	Type: Phone[] Телефоны площадки.
reservationTimeout	Type: string Сколько времени держится бронь во время покупки билета.
saleCanceling	Type: string За сколько времени до начала события закрывается возможность отмены купленных билетов (если она возможна).
saleClosing	Type: string За сколько времени до начала события продажи закрываются.
saleOpening	Type: string За сколько времени до начала события открываются продажи.
subwayStations	Type: string[] Список ближайших станций метро.
synonyms	Type: string[] Список синонимов для поисковых систем.
tags	Type: Tag[] Связанные с площадкой теги.
types	Type: VenueType[] Список доступных типов площадок. - OTHER_VENUE: Тип площадки по умолчанию. CINEMA: Кинотеатр. THEATRE_VENUE: Театр. MUSEUM: Музей. CLUB: Клуб. CONCERT_STAGE: Концертная площадка. CIRCUS: Цирк. SPORT_BUILDING: Спортивный комплекс. EXHIBITION_HALL: Выставочный зал. Default: `OTHER_VENUE` Enum: `OTHER_VENUE`, `CINEMA`, `THEATRE_VENUE`, `MUSEUM`, `CLUB`, `CONCERT_STAGE`, `CIRCUS`, `SPORT_BUILDING`, `EXHIBITION_HALL`
urls	Type: string[] Ссылки на сайт площадки.
videos	Type: Video[] Связанные видео.
workTimes	Type: WorkTime[] Время работы площадки.

CancelAllowance

UNDEFINED_CANCEL_ALLOWANCE: Возможность отмены не определена.
CANCEL_ALLOWED: Отмена заказа разрешена.
BY_ADMINISTRATOR: Отмена заказа возможна только через администратора заведения.
BY_SUPPORT: Отмена заказа возможна через службу поддержки.
BY_PARTNER: Отмена заказа возможна только по согласованию с партнером.
SESSION_CANCEL: Отмена заказа возможна возможна только при отмене сеанса.

Type

Description

CancelAllowance

Default: UNDEFINED_CANCEL_ALLOWANCE

Enum: UNDEFINED_CANCEL_ALLOWANCE, CANCEL_ALLOWED, BY_ADMINISTRATOR, BY_SUPPORT, BY_PARTNER, SESSION_CANCEL

Coordinates

Name

Description

latitude*

Type: number<double>

Широта точки на карте.

longitude*

Type: number<double>

Долгота точки на карте.

Image

Name

Description

type*

Type: string

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

url*

Type: string

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

SourceRef

Name

Description

serviceId

Type: string

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

sourceId

Type: string

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

Phone

Name

Description

number*

Type: string

Номер телефона.

type*

Type: string

Текстовое описание типа телефона, например "Мобильный" или "Касса".

Tag

Name

Description

name*

Type: string

Имя тега.

type*

Type: string

Тип тега.

VenueType

OTHER_VENUE: Тип площадки по умолчанию.
CINEMA: Кинотеатр.
THEATRE_VENUE: Театр.
MUSEUM: Музей.
CLUB: Клуб.
CONCERT_STAGE: Концертная площадка.
CIRCUS: Цирк.
SPORT_BUILDING: Спортивный комплекс.
EXHIBITION_HALL: Выставочный зал.

Type

Description

VenueType

Default: OTHER_VENUE

Enum: OTHER_VENUE, CINEMA, THEATRE_VENUE, MUSEUM, CLUB, CONCERT_STAGE, CIRCUS, SPORT_BUILDING, EXHIBITION_HALL

Video

Name	Description
language*	Type: string Язык видео.
type*	Type: string Тип видео. Например, "Трейлер".
url*	Type: string Ссылка на видеофайл.

WorkTime

Name

Description

time*

Type: string

Время работы в произвольном формате. Например, "с 8 до 12".

type*

Type: string

Текстовое описание времени работы. Например "по будням".

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

Возвращает список городов

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