Основные принципы API (обозначения, авторизация, запросы/ответы, баллы и другие общие моменты)
Новости: Telegram канал
Данное API предназначено для проверки/гашения кодов билетов/абонементов.
Вы сможете проверить/погасить коды билетов/абонементов, осуществить контроль.
Вы точно не сможете управлять билетами/абонементами.
Начало адреса запросов: https://api2.quicktickets.ru/control/v2/
get organisation/list 10
Параметры запроса:
Название | Тип | По умолчанию | Описание |
---|---|---|---|
signature | string | Нет | Подпись. |
Ответ по запросу:
Название | Тип | Описание |
---|---|---|
organisations | array | Список организаций (ключ — идентификатор организации). |
- id | integer | Идентификатор организации. |
- alias | string | Алиас организации. |
- name | string | Название организации. |
post ticket/control 1
Параметры запроса:
Название | Тип | По умолчанию | Описание |
---|---|---|---|
organisationId или organisationAlias | integer|string | Нет | Идентификатор или алиас организации. |
ticketCode | string | Нет | Код билета. |
controlBeforeSessionTimeStart | integer | 3600 | Время до начала проведения детализации, когда становиться разрешён контроль. Внимание! По билетам оплаченным с помощью Пушкинской банковской карты данный параметр автоматически уменьшается до двух часов, если указано значение больше. |
controlAfterSessionTimeStart | integer | 3600 | Время после начала проведения детализации, в течении которого остаётся разрешён контроль. |
control | string | null | Изменение факта контроля:
|
signature | string | Нет | Подпись. |
Ответ по запросу:
Название | Тип | Описание |
---|---|---|
result | string | Результат:
|
event | null|array | Мероприятие. |
- id | integer | Идентификатор. |
- name | string | Название. |
session | null|array | Детализация. |
- id | integer | Идентификатор. |
- timeStart | integer | Время начала проведени, в формате Unix timestamp. |
- timeEnd | integer | Время окончания проведения, в формате Unix timestamp
|
- workUntilTimeEnd | integer | Работа до окончания времени проведения |
- timezone | integer | Часовой пояс места проведения. |
- countEnterTickets | null|integer | Приблизительное количество погашенных билетов:
|
- countNotEnterTickets | null|integer | Приблизительное количество не погашенных билетов:
|
ticket | null|array | Билет. |
- id | integer | Идентификатор. |
- code | string | Код. |
- type | string | Тип билета:
|
- place | string | Место. |
- beforeControl | bool | Значение контроля до выполнения запроса:
|
- control | bool | Значение контроля после выполнения запроса:
|
- sesonticket | bool | Билет в составе абонемента. |
- puskinCard | bool | Билет куплен по Пушкинской банковской карте. |
- lavrentevCard | bool | Билет куплен по Лаврентьевской карте. |
- user | null|array | Пользователь. |
- - fullName | string | ФИО. |
- - birthday | string | День рождения. |
post ticket/pushkin_card_violation 1
Параметры запроса:
Название | Тип | По умолчанию | Описание |
---|---|---|---|
organisationId или organisationAlias | integer|string | Нет | Идентификатор или алиас организации. |
ticketId или ticketCode | integer|string | Нет | Идентификатор или код билета. |
description | string | Нет | Описание нарушения. |
signature | string | Нет | Подпись. |
Ответ по запросу:
Название | Тип | Описание |
---|---|---|
result | string | Результат:
|
get ticket/data_for_offline_control 10
Данный метод преднозначен для получения билетов и правил проведения контроля в случае необходимости осуществления автаномного контроля, например при отсуствии доступа к интернету.
После осуществления автономного контроля, при появлении доступа к интернету, необходимо передать данные с помощью метода ticket/offline_control.
По билетам, оплаченным с помощью Пушкинской банковской карты запрещено осуществлять контроль автономно, поэтому билеты этой категории не попадут в результат этого запроса.
Параметры запроса:
Название | Тип | По умолчанию | Описание |
---|---|---|---|
organisationId или organisationAlias | integer|string | Нет | Идентификатор или алиас организации. |
periodTimeStart | integer | Текущее время минус 1 день | Начало периода в котором проходят детализации, время в формате Unix timestamp. |
periodTimeEnd | integer | Текущее время плюс 30 дней | Окончание периода в котором проходят детализации, время в формате Unix timestamp. |
signature | string | Нет | Подпись. |
Ответ по запросу:
Название | Тип | Описание |
---|---|---|
events | array | Мероприятия (ключ — идентификатор). |
- id | integer | Идентификатор. |
- name | string | Название. |
- sessions | array | Детализации (ключ — идентификатор). |
- - id | integer | Идентификатор. |
- - timeStart | integer | Время начала проведения, в формате Unix timestamp. |
- - timeEnd | integer | Время окончания проведения, в формате Unix timestamp:
|
- - workUntilTimeEnd | bool | Работа до окончания времени проведения. |
- - timezone | integer | Часовой пояс места проведения. |
- - tickets | array | Билеты. |
- - - id | integer | Идентификатор. |
- - - code | string | Код. |
- - - type | string | Тип:
|
- - - place | string | Место. |
- - - control | string | Факт контроля:
|
- - - sesonticket | bool | Билет в составе абонемента. |
- - - puskinCard | bool | Билет куплен по Пушкинской банковской карте. |
- - - lavrentevCard | bool | Билет куплен по Лаврентьевской карте. |
- - - user | null|array | Пользователь. |
- - - - fullName | string | ФИО. |
- - - - birthday | string | День рождения. |
get ticket/offline_control 10
Данный метод преднозначен для передачи факта контроля по билетам, полученным с помощью метода ticket/data_for_offline_control, при появлении доступа к интернету.
Параметры запроса:
Название | Тип | По умолчанию | Описание |
---|---|---|---|
organisationId или organisationAlias | integer|string | Нет | Идентификатор или алиас организации. |
tickets | array | Нет | Билеты. |
- code | string | Нет | Код. |
- time | integer | Нет | Время контроля, в формате Unix timestamp. |
- control | string | Нет | Контроль:
|
signature | string | Нет | Подпись. |
Ответ по запросу:
Название | Тип | Описание |
---|---|---|
success | array | Массив успешно обработанных кодов билетов. |
notSuccess | array | Массив не успешно обработанных кодов билетов (ключ — код билета). |
- alias | array | Алиас проблемы. |
- text | array | Описание проблемы. |