Основные принципы API (обозначения, авторизация, запросы/ответы, баллы и другие общие моменты)
Обновления: Telegram канал
Данное API предназначено для формирования афиши мероприятий на сторонних ресурсах.
Вы сможете получить афишу мероприятий, конфигурацию залов и информацию о свободных местах.
Вы точно не сможете управлять мероприятиями, билетами и др.
Начало адреса запросов: https://api2.quicktickets.ru/afisha/v2/
get area/list 10
Параметры запроса:
| Название | Тип | По умолчанию | Описание |
|---|---|---|---|
| areaId | integer | Нет | Идентификатор области. |
| offset | integer | 0 | Количество пропускаемых областей. |
| limit | integer | 10 | Количество возвращаемых областей. Максимум 100. |
| signature | string | Нет | Подпись. |
Ответ по запросу:
| Название | Тип | Описание |
|---|---|---|
| areas | array | Список областей (ключ — идентификатор). |
| - id | integer | Идентификатор. |
| - name | string | Название. |
get district/list 10
Параметры запроса:
| Название | Тип | По умолчанию | Описание |
|---|---|---|---|
| areaId | integer | Нет | Идентификатор области. |
| offset | integer | 0 | Количество пропускаемых областей. |
| limit | integer | 10 | Количество возвращаемых областей. Максимум 100. |
| signature | string | Нет | Подпись. |
Ответ по запросу:
| Название | Тип | Описание |
|---|---|---|
| districts | array | Список муниципальных образовани (ключ — идентификатор). |
| - id | integer | Идентификатор. |
| - name | string | Название. |
| - oktmo | string | ОКТМО. |
| - area | array | Область |
| - - ... | ... | Cтруктура одного элемента поля areas из запроса area/list. |
get city/list 10
Параметры запроса:
| Название | Тип | По умолчанию | Описание |
|---|---|---|---|
| areaId | integer | Нет | Идентификатор области. |
| cityId | integer | Нет | Идентификатор города. |
| offset | integer | 0 | Количество пропускаемых городов. |
| limit | integer | 10 | Количество возвращаемых городов. Максимум 100. |
| signature | string | Нет | Подпись. |
Ответ по запросу:
| Название | Тип | Описание |
|---|---|---|
| cities | array | Список городов (ключ — идентификатор). |
| - id | integer | Идентификатор. |
| - alias | string | Алиас. |
| - name | string | Название. |
| - timezone | string | Часовой пояс. |
| - urlOrganisations | string | Ссылка на список организаций. |
| - urlAfisha | string | Ссылка на афишу. |
| - area | array | Область |
| - - ... | ... | Cтруктура одного элемента поля areas из запроса area/list. |
| - district | array | Муниципальное образование |
| - - ... | ... | Cтруктура одного элемента поля districts из запроса district/list. |
get organisation/list 10
Параметры запроса:
| Название | Тип | По умолчанию | Описание |
|---|---|---|---|
| cityId | integer | Нет | Идентификатор города. |
| organisationId или organisationAlias | integer|string | Нет | Идентификатор или алиас организации. |
| offset | integer | 0 | Количество пропускаемых организаций. |
| limit | integer | 10 | Количество возвращаемых организаций. Максимум 100. |
| signature | string | Нет | Подпись. |
Ответ по запросу:
| Название | Тип | Описание |
|---|---|---|
| organisations | array | Список организаций (ключ — идентификатор). |
| - id | integer | Идентификатор. |
| - alias | string | Алиас. |
| - name | string | Название. |
| - urlAvatar | string | Ссылка на фото. |
| - urlAvatarSmall | string | Ссылка на фото меньшего размера. |
| - urlAfisha | string | Ссылка на афишу. |
| - area | array | Область. |
| - - ... | ... | Cтруктура одного элемента поля areas из запроса area/list. |
| - district | array | Муниципальное образование |
| - - ... | ... | Cтруктура одного элемента поля districts из запроса district/list. |
| - city | array | Город. |
| - - ... | ... | Cтруктура одного элемента поля cities из запроса city/list. |
| - address | string | Адрес. |
| - phones | array | Телефоны. |
| - - number | string | Номер. |
| - - description | string | Описание. |
| - inn | string | ИНН. |
| - ogrn | string | ОГРН/ОГРНИП. |
| - kpp | null|string | КПП:
|
get event/list 20
Мероприятия попадают в список, если содержат хотя бы одну детализацию, детализация состоит в мероприятии, если:
Обратите внимание на запрос списка детализаций session/list, он содержит те же данные, но в другой структуре.
Параметры запроса:
| Название | Тип | По умолчанию | Описание |
|---|---|---|---|
| organisationId или organisationAlias | integer|string | Нет | Идентификатор или алиас организации. |
| eventId | integer | Нет | Идентификатор мероприятия. |
| sessionId | integer | Нет | Идентификатор детализации. |
| signature | string | Нет | Подпись. |
Ответ по запросу:
| Название | Тип | Описание |
|---|---|---|
| organisation | array | Организация. |
| - - ... | ... | Cтруктура одного элемента поля organisations из запроса organisation/list. |
| events | array | Список мероприятий (ключ — идентификатор). |
| - id | integer | Идентификатор. |
| - name | string | Название. |
| - ageRestriction | integer | Возрастное ограничение. |
| - shortDescription | string | Краткое описание. |
| - urlAvatar | string | Ссылка на фото. |
| - urlAvatarSmall | string | Ссылка на фото меньшего размера. |
| - url | string | Ссылка. |
| - sessions | array | Список детализаций (ключ — идентификатор). |
| - - id | integer | Идентификатор. |
| - - area | array | Область. |
| - - - ... | ... | Cтруктура одного элемента поля areas из запроса area/list. |
| - - district | array | Муниципальное образование |
| - - - ... | ... | Cтруктура одного элемента поля districts из запроса district/list. |
| - - city | array | Город. |
| - - - id | integer | Идентификатор. |
| - - - name | string | Название. |
| - - address | string | Адрес места проведения. |
| - - timeStart | integer | Время начала проведения. |
| - - timeEnd | integer | Время окончания проведения:
|
| - - workUntilTimeEnd | integer | Работа до окончания времени проведения. |
| - - timezone | integer | Часовой пояс места проведения. |
| - - url | string | Ссылка. |
| - - changeEvent | bool | Замена мероприятия. |
| - - changeTimeStart | bool | Перенос (смена времени проведения). |
| - - jointSaleOfAnyplaces | null|string | Совместная продажа разных мест:
|
| - - countAvailableAnyplaces | null|integer | Примерное количество мест, доступных для продажи:
|
| - - minPrice | null|float | Минимальная цена среди мест, доступных для продажи:
|
| - - maxPrice | null|float | Максимальная цена среди мест, доступных для продажи:
|
| - - pushkincard | bool | Возможность оплаты Пушкинской картой. |
get session/list 20
Детализации попадают в список, если:
Обратите внимание на запрос списка мероприятий event/list, он содержит те же данные, но в другой структуре.
Параметры запроса:
| Название | Тип | По умолчанию | Описание |
|---|---|---|---|
| organisationId или organisationAlias | integer|string | Нет | Идентификатор организации или алиас организации. |
| eventId | integer | Нет | Идентификатор мероприятия. |
| sessionId | integer | Нет | Идентификатор детализации. |
| signature | string | Нет | Подпись. |
Ответ по запросу:
| Название | Тип | Описание |
|---|---|---|
| organisation | array | Организация. |
| - - ... | ... | Cтруктура одного элемента поля organisations из запроса organisation/list. |
| sessions | array | Список детализаций. |
| - id | integer | Идентификатор. |
| - area | array | Область. |
| - - ... | ... | Cтруктура одного элемента поля areas из запроса area/list. |
| - - district | array | Муниципальное образование |
| - - - ... | ... | Cтруктура одного элемента поля districts из запроса district/list. |
| - city | array | Город. |
| - - - id | integer | Идентификатор. |
| - - - name | string | Название. |
| - address | string | Адрес места проведения. |
| - timeStart | integer | Время начала проведения. |
| - timeEnd | integer | Время окончания проведения:
|
| - workUntilTimeEnd | integer | Работа до окончания времени проведения. |
| - timezone | integer | Часовой пояс места проведения. |
| - url | string | Ссылка. |
| - changeEvent | bool | Замена мероприятия. |
| - changeTimeStart | bool | Перенос (смена времени проведения). |
| - jointSaleOfAnyplaces | string|null | Совместная продажа разных мест:
|
| - - countAvailableAnyplaces | null|integer | Примерное количество мест, доступных для продажи:
|
| - - minPrice | null|float | Минимальная цена среди мест, доступных для продажи:
|
| - - maxPrice | null|float | Максимальная цена среди мест, доступных для продажи:
|
| - pushkincard | bool | Возможность оплаты Пушкинской картой |
| - otherSessionsIds | array | Идентификаторы других детализаций того же мероприятия. |
| - event | array | Мероприятие. |
| - - id | integer | Идентификатор. |
| - - name | string | Название. |
| - - ageRestriction | integer | Возрастное ограничение. |
| - - shortDescription | string | Краткое описание. |
| - - urlAvatar | string | Ссылка на фото. |
| - - urlAvatarSmall | string | Ссылка на фото меньшего размера. |
| - - url | string | Ссылка. |
get anyplace/list 10
Параметры запроса:
| Название | Тип | По умолчанию | Описание |
|---|---|---|---|
| organisationId или organisationAlias | integer|string | Нет | Идентификатор или алиас организации. |
| sessionId | integer | Нет | Идентификатор детализации. |
| signature | string | Нет | Подпись. |
Ответ по запросу:
| Название | Тип | Описание |
|---|---|---|
| organisation | array | Организация. |
| - - ... | ... | Cтруктура одного элемента поля organisations из запроса organisation/list. |
| session | array | Детализация. |
| - - ... | ... | Cтруктура одного элемента поля sessions из запроса session/list. |
| hallplaces | array | Места в зале. |
| - - id | integer | Идентификатор. |
| - - block | string | Название блока. |
| - - series | string | Название ряда (чаще номер). |
| - - place | string | Название места (чаще номер). |
| - - x | integer | Координата по горизонтали (отступ слева). |
| - - y | integer | Координата по вертикали (отступ сверху). |
| - - width | integer | Ширина. |
| - - height | integer | Высота. |
| - - rotate | integer | Угол поворота. |
| - - type | string | Тип места в зале:
|
| - - priceOriginal | float | Исходная цена. |
| - - price | float | Цена. |
| - - status | integer | Статус:
|
| entranceplaces | array | Входные места. |
| - - id | integer | Идентификатор. |
| - - name | string | Название. |
| - - count | integer | Количество доступных. |
| - - priceOriginal | float | Исходная цена. |
| - - price | float | Цена. |