Возвращает доступные для сеанса места

Request

GET

/available-seats

Query parameters

Name	Description
additional	Type: object Служебное поле.
eventId	Type: string Идентификатор события.
hallId	Type: string Идентификатор зала.
sessionId	Type: string Идентификатор сессии.
sessionTime	Type: string<date-time> Время сеанса, в формате UNIX-времени.
venueId	Type: string Идентификатор площадки.

Responses

200 OK

Body

application/json

{
    "seatCategories": [
        {
            "id": "string",
            "name": "string",
            "cost": {
                "price": {
                    "value": "string",
                    "currencyCode": "string"
                },
                "fee": {
                    "value": "string",
                    "currencyCode": "string"
                },
                "total": {
                    "value": "string",
                    "currencyCode": "string"
                }
            },
            "availableAdditions": [
                {
                    "id": "string",
                    "type": "UNDEFINED_SUPPLEMENT_TYPE",
                    "cost": {
                        "price": {
                            "value": "string",
                            "currencyCode": "string"
                        },
                        "fee": {
                            "value": "string",
                            "currencyCode": "string"
                        },
                        "total": {
                            "value": "string",
                            "currencyCode": "string"
                        }
                    }
                }
            ],
            "additionLimits": {},
            "discount": {
                "percent": 0
            },
            "costChanges": [
                {
                    "newCost": {
                        "price": {
                            "value": "string",
                            "currencyCode": "string"
                        },
                        "fee": {
                            "value": "string",
                            "currencyCode": "string"
                        },
                        "total": {
                            "value": "string",
                            "currencyCode": "string"
                        }
                    },
                    "startDate": "2022-12-29T18:02:01Z",
                    "endDate": "2022-12-29T18:02:01Z",
                    "description": "string"
                }
            ],
            "description": "string",
            "type": "REGULAR"
        }
    ],
    "gatewayLevelStates": [
        {
            "id": "string",
            "name": "string",
            "admission": false,
            "seatStates": [
                {
                    "id": "string",
                    "available": false,
                    "categoryId": "string",
                    "seat": {
                        "id": "string",
                        "row": "string",
                        "place": "string",
                        "fragment": "string",
                        "x": 0,
                        "y": 0
                    },
                    "categories": [
                        "string"
                    ]
                }
            ],
            "admissionStates": [
                {
                    "categoryId": "string",
                    "availableSeatCount": 0
                }
            ],
            "entranceId": "string",
            "entranceName": "string"
        }
    ],
    "deliveries": [
        {
            "type": "UNDEFINED_DELIVERY_TYPE",
            "paymentTypes": [
                "UNDEFINED_PAYMENT_TYPE"
            ],
            "price": {
                "value": "string",
                "currencyCode": "string"
            }
        }
    ],
    "additional": {}
}

Name	Description
additional	Type: object Служебное поле.
deliveries	Type: Delivery[] Список возможных способов покупки билета.
gatewayLevelStates	Type: LevelState[] Список уровней с информацией о доступных для продажи местах.
seatCategories	Type: SeatCategory[] Список доступных категорий мест.

Delivery

Name	Description
paymentTypes	Type: PaymentType[] Доступные способы оплаты билета. - UNDEFINED_PAYMENT_TYPE: Тип оплаты не определен. STANDARD: Стандартная оплата на сайте или в приложении. POSTPONED: Оплата отложена. Для заказов в статусе BOOKED. Default: `UNDEFINED_PAYMENT_TYPE` Enum: `UNDEFINED_PAYMENT_TYPE`, `STANDARD`, `POSTPONED`
price	Type: Money Стоимость доставки.
type	Type: DeliveryType Способ доставки билета покупателю. Default: `UNDEFINED_DELIVERY_TYPE` Enum: `UNDEFINED_DELIVERY_TYPE`, `E_TICKET`, `TICKET_OFFICE`, `DELIVERY`

LevelState

Name	Description
name*	Type: string Название уровня.
admission	Type: boolean<boolean> Указывает, что на уровне нет привязки к местам. True — для уровня без мест, false — для уровня с местами. Значение по умолчанию — false.
admissionStates	Type: AdmissionState[] Список состояний уровня без доступных мест. Обязательно при отсутствии мест на уровне.
entranceId	Type: string Идентификатор входа в базе данных. Например, для подъезда в Олимпийском.
entranceName	Type: string Название входа. Например, "4 подъезд в Олимпийском".
id	Type: string Идентификатор уровня. Он должен быть согласован с идентификатором уровня в зале, который приходит при импорте залов, и с идентификатором уровня билета в заказ.
seatStates	Type: SeatState[] Список состояний мест для уровня с местами. В этом списке достаточно только указать доступные для продажи места. Обязательно для уровня с местами.

SeatCategory

Name

Description

additionLimits

Type: object

[additional]

Type: AdditionLimits

Ограничения на покупку дополнений. Обязательно при наличии доступных дополнений.

availableAdditions

Type: Addition[]

Доступные дополнения.

cost

Type: Cost

Стоимость одного места в категории.

costChanges

Type: SeatCategoryCostChange[]

Ожидаемые изменения стоимости.

description

Type: string

Описание категории.

discount

Type: SeatCategoryDiscount

Скидка, учтенная в стоимости.

Type: string

Идентификатор категории.

name

Type: string

Название категории.

type

Type: SeatCategoryType

REGULAR: Обычный билет.
CHILD: Детское место.
PERSON_WITH_SPECIAL_NEEDS: Место для людей с ограниченными возможностями.

Default: REGULAR

Enum: REGULAR, CHILD, PERSON_WITH_SPECIAL_NEEDS

PaymentType

UNDEFINED_PAYMENT_TYPE: Тип оплаты не определен.
STANDARD: Стандартная оплата на сайте или в приложении.
POSTPONED: Оплата отложена. Для заказов в статусе BOOKED.

Type

Description

PaymentType

Default: UNDEFINED_PAYMENT_TYPE

Enum: UNDEFINED_PAYMENT_TYPE, STANDARD, POSTPONED

Money

Name

Description

currencyCode

Type: string

Код валюты согласно ISO 4217, например RUB, USD, EUR.

value

Type: string<int64>

Сумма в минимальной единице валюты. Например, для рубля — копейки, для доллара — центы.

DeliveryType

UNDEFINED_DELIVERY_TYPE: Тип доставки билета не определен.
E_TICKET: Электронный билет.
TICKET_OFFICE: Выкуп в кассе площадки или в кассах партнера.
DELIVERY: Доставка курьером.

Type

Description

DeliveryType

Default: UNDEFINED_DELIVERY_TYPE

Enum: UNDEFINED_DELIVERY_TYPE, E_TICKET, TICKET_OFFICE, DELIVERY

AdmissionState

Name

Description

availableSeatCount

Type: integer<int32>

Число доступных для продажи мест.

categoryId

Type: string

Идентификатор категории. Должен совпадать с id в SeatCategory.

SeatState

Name	Description
available	Type: boolean<boolean> Указывает, что место доступно для продажи. Если место доступно, вернется значение true, в противном случае — false. Значение по умолчанию: true.
categories	Type: string[] Список всех доступных категорий места. Указывается, если доступно более одной категории. Помимо дополнительных, должен содержать `category_id`, который будет считаться основной категорией.
categoryId	Type: string Идентификатор категории места в базе данных.
id	Type: string Идентификатор места в базе данных.
seat	Type: Seat Информация о месте.

AdditionLimits

Name

Description

max

Type: integer<int32>

Максимальное число дополнений.

min

Type: integer<int32>

Минимальное число дополнений.

Addition

Name	Description
cost	Type: Cost Стоимость дополнения.
id	Type: string Идентификатор дополнения.
type	Type: SupplementType Тип дополнения. Default: `UNDEFINED_SUPPLEMENT_TYPE` Enum: `UNDEFINED_SUPPLEMENT_TYPE`, `PRESENT`, `TENT`, `PARKING_SPOT`, `TRANSFER`, `CAMPING`, `GLASSES_3D`, `GLASSES_3D_RENT`, `ICE_SKATES`, `SKATE_PROTECTION`, `SKATE_SHARPENING`, `TICKET`

Cost

Name	Description
fee	Type: Money Сервисный сбор.
price	Type: Money Номинальная стоимость.
total	Type: Money Общая стоимость с учетом сервисного сбора и промокода.

SeatCategoryCostChange

Name	Description
description	Type: string Описание изменений в стоимости.
endDate	Type: string<date-time> Дата окончания действия новой стоимости.
newCost	Type: Cost Новая стоимость.
startDate	Type: string<date-time> Дата начала действия новой стоимости.

SeatCategoryDiscount

Name

Description

percent

Type: number<double>

Процент скидки.

SeatCategoryType

REGULAR: Обычный билет.
CHILD: Детское место.
PERSON_WITH_SPECIAL_NEEDS: Место для людей с ограниченными возможностями.

Type

Description

SeatCategoryType

Default: REGULAR

Enum: REGULAR, CHILD, PERSON_WITH_SPECIAL_NEEDS

Seat

Name	Description
fragment	Type: string Идентификатор фрагмента. Места, объединенные одним фрагментом, нельзя купить по отдельности.
id	Type: string Идентификатор места в базе данных.
place	Type: string Номер места.
row	Type: string Номер ряда.
x	Type: integer<int32> Координата X на плане зала, в количестве мест от самого левого места в зале. В отличие от `row`, учитывается только абсолютное положение места. Например, в дугообразном зале места с одинаковым X могут оказаться в разных рядах.
y	Type: integer<int32> Координата Y на плане зала, в количестве мест от самого верхнего места в зале. В отличие от `place`, учитывается только абсолютное положение места. Например, в дугообразном зале места с одинаковым Y могут оказаться в разных рядах.

SupplementType

UNDEFINED_SUPPLEMENT_TYPE: Тип дополнительных услуг для заказа не определен или дополнительные услуги отсутствуют.
PRESENT: Подарок.
TENT: Палатка.
PARKING_SPOT: Место на парковке.
TRANSFER: Трансфер.
CAMPING: Кемпинг.
GLASSES_3D: 3D-очки.
GLASSES_3D_RENT: Аренда 3D-очков.
ICE_SKATES: Коньки.
SKATE_PROTECTION: Защита для катания на коньках.
SKATE_SHARPENING: Заточка.
TICKET: Дополнительный билет.

Type

Description

SupplementType

Default: UNDEFINED_SUPPLEMENT_TYPE

Enum: UNDEFINED_SUPPLEMENT_TYPE, PRESENT, TENT, PARKING_SPOT, TRANSFER, CAMPING, GLASSES_3D, GLASSES_3D_RENT, ICE_SKATES, SKATE_PROTECTION, SKATE_SHARPENING, TICKET

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

Overview

Бронирует билеты на короткий срок для выполнения оплаты