АГЕНТСКИЙ API ПЛАТФОРМЫ
(All Powerful Incantation)
Версия от 02.08.2024

ОПИСАНИЕ
ОСОБЕННОСТИ ИСПОЛЬЗОВАНИЯ КОМАНД ПРОТОКОЛА
ОБЩАЯ СХЕМА ИСПОЛЬЗОВАНИЯ ПРОТОКОЛА
ВИД ОТВЕТА
ПОЛЯ ПРИ КАЖОМ ЗАПРОСЕ
АВТОРИЗАЦИЯ (command = AUTH)
СОЗДАНИЕ ПОЛЬЗОВАТЕЛЯ (command = CREATE_USER)*
ПОЛУЧЕНИЕ СПИСКА СТРАН (command = GET_COUNTRIES)
ПОЛУЧЕНИЕ СПИСКА ГОРОДОВ (command = GET_CITIES)
ПОЛУЧЕНИЯ СПИСКА ТИПОВ МЕСТ ПРОВЕДЕНИЯ (command = GET_VENUE_TYPES)
ПОЛУЧЕНИЕ СПИСКА МЕСТ ПРОВЕДЕНИЯ (command = GET_VENUES)
ПОЛУЧЕНИЕ СПИСКА ВИДОВ ПРЕДСТАВЛЕНИЙ (command = GET_KINDS)
ПОЛУЧЕНИЕ СПИСКА ЖАНРОВ (command = GET_GENRES)
ПОЛУЧЕНИЕ СПИСКА МЕРОПРИЯТИЙ (command = GET_ALL_ACTIONS)
ПОЛУЧЕНИЕ СПИСКА МЕРОПРИЯТИЙ (command = GET_ACTIONS_V2)
ПОЛУЧЕНИЕ ИНФОРМАЦИИ О МЕРОПРИЯТИИ, РАСШИРЕННЫЙ МЕТОД (command = GET_ACTION_EXT)
ПОЛУЧЕНИЕ СПИСКА МЕСТ ПО ID СЕАНСА (command = GET_SEAT_LIST)
ПОЛУЧЕНИЕ КООРДИНАТ МЕСТ ПО ID СЕАНСА (command = GET_SCHEMA)
ДОБАВЛЕНИЕ ПРОМОКОДОВ (command = ADD_PROMO_CODES)
РЕЗЕРВИРОВАНИЕ (БРОНИРОВАНИЕ) МЕСТ (command = RESERVATION)
РAЗБРОНИРОВАНИЕ МЕСТ (command = RESERVATION)
РАЗБРОНИРОВАНИЕ ВСЕХ МЕСТ (command = RESERVATION)
ПОЛУЧЕНИЕ СПИСКА ЗАБРОНИРОВАННЫХ МЕСТ (command = GET_CART)
СОЗДАНИЕ ЗАКАЗА (command = CREATE_ORDER)
СОЗДАНИЕ ЗАКАЗА (command = CREATE_ORDER_EXT)*
ОТМЕНА ЗАКАЗА (command = CANCEL_ORDER)*
ОПЛАТА ЗАКАЗА (command = PAY_ORDER)*
ПОЛУЧЕНИЕ ЗАКАЗОВ ПОЛЬЗОВАТЕЛЯ (command = GET_ORDERS)
ПОЛУЧЕНИЕ ЗАКАЗОВ ПОЛЬЗОВАТЕЛЯ (command = GET_ORDERS_EXT)
ПОЛУЧЕНИЕ СПИСКА СЕАНСОВ, ПО КОТОРЫМ БЫЛИ КУПЛЕНЫ БИЛЕТЫ (command = GET_ACTION_EVENTS_GROUPED_BY_TICKETS)
ПОЛУЧЕНИЕ КУПЛЕННЫХ БИЛЕТОВ ПО ID ПРЕДСТАВЛЕНИЯ (command = GET_TICKETS_BY_ACTION_EVENT)
ПОЛУЧЕНИЕ КУПЛЕННЫХ БИЛЕТОВ ПО ID ЗАКАЗА (command = GET_TICKETS_BY_ORDER)
ПОЛУЧЕНИЕ ИНФОРМАЦИИ ПО ПРОДАННЫМ БИЛЕТАМ ЗА КОНКРЕТНЫЙ ДЕНЬ (command = GET_TICKETS_BY_DAY)
ПЕЧАТЬ БИЛЕТОВ (command = PRINT_TICKETS)
ПОЛУЧЕНИЕ ИНФОРМАЦИИ О ПОЛЬЗОВАТЕЛЕ (command = GET_USER_INFO)
ОТПРАВКА БИЛЕТОВ НА ПОЧТУ (command = SEND_TICKETS_TO_EMAIL)
УДАЛЕНИЕ (command = DELETE)
ПОЛУЧЕНИЕ ИНФОРМАЦИИ О ЗАКАЗЕ (command = GET_ORDER_INFO)
ПОЛУЧЕНИЕ ПОЧТЫ (command = GET_EMAIL)
ОТПРАВКА GCM ТОКЕНА НА СЕРВЕР (command = SET_PUSH_TOKEN)
ПОЛУЧИТЬ НОВОСТИ (command = GET_NEWS)
ПРОВЕРКА КДП (command = CHECK_KDP)
ПОЛУЧЕНИЕ ДАННЫХ ДЛЯ ФИЛЬТРА (command = GET_FILTER)
ПРИВЯЗКА ПОЧТЫ (command = BIND_EMAIL)
ПОДТВЕРЖДЕНИЕ ПОЧТЫ (command = CONFIRM_EMAIL)
ПОЛУЧЕНИЕ КАРТ (МЭК) (command = GET_MECS)
ПОЛУЧЕНИЕ ПРОМОКОДОВ (command = GET_PROMO_CODES)
ВОЗВРАТ БИЛЕТОВ (command = REFUND_TICKETS)*
ПОЛУЧЕНИЕ РЕКОМЕНДУЕМОЙ TICKETRAIN СУММЫ ВОЗВРАТА (command = GET_TR_REFUND_AMOUNT)*
СТАТУС ЗАКАЗА
ПРОТОКОЛ В ФАЙЛЕ docx
ИЗМЕНЕНИЯ ПРОТОКОЛА ОТ 09.05.2016
ИЗМЕНЕНИЯ ПРОТОКОЛА ОТ 20.05.2016
ИЗМЕНЕНИЯ ПРОТОКОЛА ОТ 15.06.2016
ИЗМЕНЕНИЯ ПРОТОКОЛА ОТ 22.06.2016
ИЗМЕНЕНИЯ ПРОТОКОЛА ОТ 23.06.2016
ИЗМЕНЕНИЯ ПРОТОКОЛА ОТ 08.07.2016
ИЗМЕНЕНИЯ ПРОТОКОЛА ОТ 22.07.2016
ИЗМЕНЕНИЯ ПРОТОКОЛА ОТ 16.08.2016
ИЗМЕНЕНИЯ ПРОТОКОЛА ОТ 02.09.2016
ИЗМЕНЕНИЯ ПРОТОКОЛА ОТ 25.10.2016
ИЗМЕНЕНИЯ ПРОТОКОЛА ОТ 25.11.2016
ИЗМЕНЕНИЯ ПРОТОКОЛА ОТ 15.12.2016
ИЗМЕНЕНИЯ ПРОТОКОЛА ОТ 27.12.2016
ИЗМЕНЕНИЯ ПРОТОКОЛА ОТ 04.02.2017
ИЗМЕНЕНИЯ ПРОТОКОЛА ОТ 05.05.2017
ИЗМЕНЕНИЯ ПРОТОКОЛА ОТ 18.05.2017
ИЗМЕНЕНИЯ ПРОТОКОЛА ОТ 08.06.2017
ИЗМЕНЕНИЯ ПРОТОКОЛА ОТ 06.07.2017
ИЗМЕНЕНИЯ ПРОТОКОЛА ОТ 13.07.2017
ИЗМЕНЕНИЯ ПРОТОКОЛА ОТ 22.07.2017
ИЗМЕНЕНИЯ ПРОТОКОЛА ОТ 09.08.2017
ИЗМЕНЕНИЯ ПРОТОКОЛА ОТ 23.08.2017
ИЗМЕНЕНИЯ ПРОТОКОЛА ОТ 02.10.2017
ИЗМЕНЕНИЯ ПРОТОКОЛА ОТ 18.02.2018
ИЗМЕНЕНИЯ ПРОТОКОЛА ОТ 01.03.2018
ИЗМЕНЕНИЯ ПРОТОКОЛА ОТ 12.03.2018
ИЗМЕНЕНИЯ ПРОТОКОЛА ОТ 19.08.2018
ИЗМЕНЕНИЯ ПРОТОКОЛА ОТ 16.10.2018
ИЗМЕНЕНИЯ ПРОТОКОЛА ОТ 06.12.2018
ИЗМЕНЕНИЯ ПРОТОКОЛА ОТ 12.12.2018
ИЗМЕНЕНИЯ ПРОТОКОЛА ОТ 23.04.2019
ИЗМЕНЕНИЯ ПРОТОКОЛА ОТ 21.05.2019
ИЗМЕНЕНИЯ ПРОТОКОЛА ОТ 10.06.2019
ИЗМЕНЕНИЯ ПРОТОКОЛА ОТ 23.07.2019
ИЗМЕНЕНИЯ ПРОТОКОЛА ОТ 13.08.2019
ИЗМЕНЕНИЯ ПРОТОКОЛА ОТ 24.09.2019
ИЗМЕНЕНИЯ ПРОТОКОЛА ОТ 11.06.2020
ИЗМЕНЕНИЯ ПРОТОКОЛА ОТ 14.12.2020
ИЗМЕНЕНИЯ ПРОТОКОЛА ОТ 16.03.2021
ИЗМЕНЕНИЯ ПРОТОКОЛА ОТ 23.03.2021
ИЗМЕНЕНИЯ ПРОТОКОЛА ОТ 05.06.2021
ИЗМЕНЕНИЯ ПРОТОКОЛА ОТ 10.11.2021
ИЗМЕНЕНИЯ ПРОТОКОЛА ОТ 10.01.2022
ИЗМЕНЕНИЯ ПРОТОКОЛА ОТ 28.04.2022
ИЗМЕНЕНИЯ ПРОТОКОЛА ОТ 19.07.2022
ИЗМЕНЕНИЯ ПРОТОКОЛА ОТ 15.09.2022
ИЗМЕНЕНИЯ ПРОТОКОЛА ОТ 09.01.2023
ИЗМЕНЕНИЯ ПРОТОКОЛА ОТ 14.02.2023
ИЗМЕНЕНИЯ ПРОТОКОЛА ОТ 11.04.2024
ИЗМЕНЕНИЯ ПРОТОКОЛА ОТ 03.05.2024
ИЗМЕНЕНИЯ ПРОТОКОЛА ОТ 07.06.2024
ИЗМЕНЕНИЯ ПРОТОКОЛА ОТ 02.08.2024

ОПИСАНИЕ

Для взаимодействия осуществляются HTTPS POST запросы в формате JSON в кодировке UTF-8. Ответ возвращается в формате JSON в кодировке UTF-8.

Чтобы большие ответы в формате JSON приходили в сжатом виде, в заголовке HTTPS POST запроса в поле accept-encoding следует передавать параметр gzip.

URL тестовой зоны https://api.bil24.pro:1240/json
URL реальной зоны https://api.bil24.pro/json
Веб интерфейс для применения команд протокола

API in Swagger

Типы полей:
число int - целое значение в диапазоне от -2 147 483 648 до 2 147 483 647
число Uint - целое беззнаковое значение в диапазоне от 0 до 2 147 483 647
число long - целое значение в диапазоне от -9 223 372 036 854 775 808 до 9 223 372 036 854 775 807
число Ulong - целое беззнаковое значение в диапазоне от 0 до 9 223 372 036 854 775 807
число cur - вещественное значение, содержащее до 4 знаков после точки, например 134.7445
boolean - литерал принимающий значения true или false
строка - строковое значение неограниченной длины

Как выбрать правильный ТИП ИНТЕРФЕЙСА при использовании API BIL24.

ОБЩАЯ СХЕМА ИСПОЛЬЗОВАНИЯ ПРОТОКОЛА

Команды протокола делятся на сессионные и несессионные.
Список несессионных команд:
1. GET_FILTER
2. GET_CITIES
3. GET_VENUE_TYPES
4. GET_VENUES
5. GET_ALL_ACTIONS
6. GET_ACTIONS_V2
7. GET_ACTION_EXT
8. GET_SEAT_LIST
9. GET_TICKETS_BY_DAY

Нет необходимости выполнять команду AUTH раньше какой-либо из перечисленных команд. Для их выполнения не нужен идентификатор сессии (sessionId).

Для выполнения сессионных команд нужно иметь sessionId. Получить его первоначально нужно с помощью команды AUTH (для билетных систем CREATE_USER). Полученные данные пользователя рекомендуется сохранить и использовать повторно. Сессия пользователя определяется sessionId и действует бессрочно.

В общем случае, sessionId понадобится перед командой BIND_EMAIL (RESERVATION для билетных систем).

Можно использовать fid, token, userId и sessionId из примеров для запросов при доступе в тестовую зону по адресу https://api.bil24.pro:1240/json.

Интерфейс "Билетная система"
fid: 1184
token: 24d3b97b64dfab187a5f
userId: 18109
sessionId: d6035a755bd0862e713e03f337505bd0

Интерфейс "Браузер"
fid: 1185
token: 2f1173e2b12fd5a111b6
userId: 6104
sessionId: 19c517c212bf173b44558308149db8ca

Посмотреть все события, товары и услуги, подписанные на интерфейс 1185 можно на этом сайте.

Интерфейс "Билетный агент"
fid: 1271
token: 7c696b4af364928202dd
userId: 33922
sessionId: 7c696b4af364928202dd

ВИД ОТВЕТА

На все запросы возвращается результат в формате JSON:
{
 "resultCode": 0,
 "description": "OK"
 "command": "COMMAND"
 …………………………
}

Данные поля присутствуют в каждом ответе.
Если resultCode не равен 0, то поле description содержит описание ошибки, поле cause может содержать причину ошибки. Других полей не будет.
Значения поля resultCode:

ПРИ КАЖДОМ ЗАПРОСЕ указываются поля:

Полезные инструменты для работы с API BIL24:
- Веб-форма для API BIL24
- Json Editor

АВТОРИЗАЦИЯ (command = AUTH)

Описание: авторизация пользователя. Для интерфейсов Билетный агент и Билетная система вместо данного метода необходимо использовать метод CREATE_USER.
Поля запроса:

Состав полей ответа:

Данные для запроса брать из cookies, если ранее уже выполнялся данный запрос. Если запрос выполняется первый раз, то userId и sessionId в запросе не передавать.
Пример запроса:
{
 "userId": 6104,
 "sessionId": "19c517c212bf173b44558308149db8ca",
 "command": "AUTH",
 "fid": 1185,
 "token": "2f1173e2b12fd5a111b6"
}
Пример ответа:
{
 "userId": 6104,
 "sessionId": "19c517c212bf173b44558308149db8ca",
 "command": "AUTH",
 "frontendType": 4,
 "resultCode": 0,
 "description": "OK"
}
После получения ответа, сохранить данные и использовать в запросах, где необходимы эти поля.

СОЗДАНИЕ ПОЛЬЗОВАТЕЛЯ (command = CREATE_USER)*

Описание: метод создает нового пользователя, который в дальнейшем может использоваться для бронирования мест, создания и оплаты заказа и получения билетов. Используется вместо метода AUTH для интерфейсов Билетный агент и Билетная система.
*только для интерфейсов Билетный агент и Билетная система

Поля запроса:

Состав полей ответа:

Пример запроса:
{
 "command": "CREATE_USER",
 "fid": 1184,
 "token": "24d3b97b64dfab187a5f"
}
Пример ответа:
{
 "userId": 18109,
 "sessionId": "d6035a755bd0862e713e03f337505bd0",
 "command": "CREATE_USER",
 "resultCode": 0,
 "description": "OK"
}
После получения ответа, сохранить данные и использовать в запросах, где необходимы эти поля.

ПОЛУЧЕНИЕ СПИСКА СТРАН (command = GET_COUNTRIES)

Описание: Получение списка всех стран, присутствующих в системе. Для получения списка только тех стран, в которых есть актуальные события, необходимо использовать метод GET_FILTER. Использование метода GET_FILTER является предпочтительным.
Поля запроса:

Состав полей ответа:

countryList:

ПОЛУЧЕНИЕ СПИСКА ГОРОДОВ (command = GET_CITIES)

Описание: получение списка всех городов, присутствующих в системе. Для получения списка только тех городов, в которых есть актуальные события, необходимо использовать метод GET_FILTER. Использование метода GET_FILTER является предпочтительным.
Поля запроса:

Состав полей ответа:

cityList:

Пример запроса:
{
 "command": "GET_CITIES",
 "fid": 1185,
 "token": "2f1173e2b12fd5a111b6"
}
Пример ответа:
{
 "cityList": [
  {
   "cityId": 1,
   "cityName": "Сочи"
  },
  {
   "cityId": 2,
   "cityName": "Краснодар"
  }
 ],
 "command": "GET_CITIES",
 "resultCode": 0,
 "description": "OK"
}

ПОЛУЧЕНИЕ СПИСКА ТИПОВ МЕСТ ПРОВЕДЕНИЯ (command = GET_VENUE_TYPES)

Описание: получение списка всех типов мест проведения, присутствующих в системе.
Поля запроса:

Состав полей ответа:

venueTypeList:

ПОЛУЧЕНИЕ СПИСКА МЕСТ ПРОВЕДЕНИЯ (command = GET_VENUES)

Описание: получение списка всех мест проведения, присутствующих в системе. Для получения актуальных мест проведения, необходимо использовать метод GET_FILTER.
Поля запроса:

Состав полей ответа:

venueList:

ПОЛУЧЕНИЕ СПИСКА ВИДОВ ПРЕДСТАВЛЕНИЙ (command = GET_KINDS)

Описание: Получение списка всех видов представлений, присутствующих в системе. Для получения актуальных видов представлений, необходимо использовать метод GET_FILTER. Использование метода GET_FILTER является предпочтительным.
Поля запроса:

Состав полей ответа:

kindList:

ПОЛУЧЕНИЕ СПИСКА ЖАНРОВ (command = GET_GENRES)

Описание: Получение списка всех жанров, присутствующих в системе. Для получения актуальных жанров, необходимо использовать метод GET_FILTER. Использование метода GET_FILTER является предпочтительным.
Поля запроса:

Состав полей ответа:

genreList:

ПОЛУЧЕНИЕ СПИСКА МЕРОПРИЯТИЙ (command = GET_ALL_ACTIONS)

Описание: метод возвращает все данные метода GET_FILTER, плюс список всех доступных мероприятий. Метод позволяет отказаться от использования методов GET_FILTER, GET_ACTIONS_V2 и GET_ACTION_EXT.


Поля запроса:

Состав полей ответа:

countryList:

cityList:

venueList:

kindList:

genreList:

actionList:

actionEventList:

tariffPlanList:

categoryLimitList:

categoryList:

ПОЛУЧЕНИЕ СПИСКА МЕРОПРИЯТИЙ (command = GET_ACTIONS_V2)

Описание: метод возвращает список представлений по городу. Для интерфейса Билетная система рекомендуется использовать GET_ALL_ACTIONS вместо данного метода.
Поля запроса:

Состав полей ответа:

actionList:

genreList:

* КДП (код доступа к представлению - временное решение). Перед открытием схемы зала или нажатием кнопки забронировать (в схеме зала без размещения) пользователь должен ввести КДП (метод для проверки КДП - CHECK_KDP)
Пример запроса:
{
 "cityId": 1,
 "command": "GET_ACTIONS_V2"
 "fid": 1185,
 "token": "2f1173e2b12fd5a111b6"
}
Пример ответа:
{
 "actionList": [
  {
    "actionId": 193,
    "actionName": "Любовь Успенская",
    "fullActionName": "Королева городского романса",
    "duration": 120,
    "kindId": 0,
    "kindName": "События",
    "posterName": "Название постера",
    "smallPosterUrl": "https://api.bil24.pro:1240/image?type=smallPoster&actionId=193&hash=gznpw8zi9rog7k7e923ko32ap",
    "bigPosterUrl": "https://api.bil24.pro:1240/image?type=bigPoster&actionId=193&hash=hwyb7h53x926q0tiiopdgjpp0",
    "minSum": 1500,
    "firstEventDate": "27.05.2016",
    "lastEventDate": "27.05.2016",
    "rating": 10,
    "kdp": false,
    "cityId": 1,
    "cityName": "Сочи",
    "actionEventTime": "19:30",
    "venueMap": {
     "1": "Зимний театр"
    }
  },
  {
    "actionId": 219,
    "actionName": "Кармен",
    "fullActionName": "Ледовый мюзикл",
    "duration": 180,
    "kindId": 0,
    "kindName": "События",
    "posterName": "Название постера",
    "smallPosterUrl": "https://api.bil24.pro:1240/image?type=smallPoster&actionId=219&hash=sc8zn3tgamlvtpdjbgprv3dy2",
    "bigPosterUrl": "https://api.bil24.pro:1240/image?type=bigPoster&actionId=219&hash=qwejy8em5q5clku76dyxshd58",
    "minSum": 1000,
    "firstEventDate": "10.06.2016",
    "lastEventDate": "02.10.2016",
    "rating": 10,
    "kdp": false,
    "cityId": 1,
    "cityName": "Сочи",
    "actionEventTime": "18:30",
    "venueMap": {
     "7": "ЛД \"Айсберг\""
    }
  }
 ],
  "command": "GET_ACTIONS_V2",
  "resultCode": 0,
  "description": "OK"
}

ПОЛУЧЕНИЕ ИНФОРМАЦИИ О МЕРОПРИЯТИИ, РАСШИРЕННЫЙ МЕТОД (command = GET_ACTION_EXT)

Описание: метод возвращает информацию о представлении в конкретном городе, места где оно проводится и сеансы. Для интерфейса Билетная система рекомендуется использовать GET_ALL_ACTIONS вместо данного метода.
Поля запроса:

* userId - на схеме зала будут окрашены места данного пользователя
Состав полей ответа:

action:

*kdp - Код доступа к представлению (КДП). Если параметр равен true, то забронировать места можно только если ввести КДП
genreList:

venueList:

actionEventList:

Существует 3 вида схем:
1. Только без размещения. placementUrl будет отсутствовать, смотрим categoryLimitList.
2. Только с размещением. Смотрим placementUrl, categoryLimitList будет пустой.
3. Комбинированная. Смотрим placementUrl и categoryLimitList.

tariffPlanList:

categoryLimitList:

categoryList:

*availability - количество доступных мест в категории. Если remainder отсутствует, то ориентируемся на availability. Если remainder присутствует, то нужно внимательно использовать эти параметры. К примеру общее ограничение remainder на 3 категории может быть 100, но и в каждой категории availability также может быть 100.

Список сеансов actionEventList возвращается в отсортированном виде по дате проведения.

Пример запроса:
{
 "cityId": 1,
 "actionId": 80,
 "userId": 6104,
 "command": "GET_ACTION_EXT",
 "fid": 1185,
 "token": "2f1173e2b12fd5a111b6"
}
Пример ответа:
{
 "action": {
  "actionId": 193,
  "actionName": "Любовь Успенская",
  "fullActionName": "Королева городского романса",
  "kindId": 0,
  "kindName": "События",
  "cityId": 1,
  "cityName": "Сочи",
  "duration": 120,
  "posterName": "Королева городского романса",
  "description": ""Настоящая Любовь"",
  "smallPosterUrl": "https://api.bil24.pro:1240/image?type=smallPoster&actionId=193&hash=gznpw8zi9rog7k7e923ko32ap",
  "bigPosterUrl": "https://api.bil24.pro:1240/image?type=bigPoster&actionId=193&hash=hwyb7h53x926q0tiiopdgjpp0",
  "rating": 10,
  "kdp": false,
  "venueList": [
    {
    "venueId": 1,
    "venueName": "Зимний театр",
    "address": "г. Сочи, ул. Театральная, 2",
    "geoLat": "43.572313",
    "geoLon": "39.730626",
    "imageUrl": "https://api.bil24.pro:1240/image?type=venue&id=1&hash=rrre3fih28k8n68kmjwkdhe91",
    "description": "У каждого города есть своя "визитная карточка".",
    "actionEventList": [
     {
      "actionEventId": 681,
      "day": "27.05.2016",
      "time": "19:30",
      "placementUrl": "https://api.bil24.pro:1240/image?type=seatingPlan&userId=21173&actionEventId=681",
      "eTicket": true,
      "categoryLimitList": []
     }
     ]
   }
   ]
 },
 "command": "GET_ACTION_EXT",
 "resultCode": 0,
 "description": "OK"
}

ПОЛУЧЕНИЕ СПИСКА МЕСТ ПО ID СЕАНСА (command = GET_SEAT_LIST)

Режим ограничения обслуживания команд GET_SEAT_LIST (режим "Опроса", GSL-ограничение).

Поля запроса:

Состав полей ответа:

tariffPlanList:

categoryList:

categoryLimitList:

seatList:

location:

ПОЛУЧЕНИЕ КООРДИНАТ МЕСТ ПО ID СЕАНСА (command = GET_SCHEMA)

Описание: Метод возвращает информацию обо всех местах с размещением, с координатами каждого места, включая координаты x,y. Метод дает возможность построить собственную схему зала. Рекомендуется использовать только если нет возможности использовать готовые схемы svg, которые можно получить по протоколу.

Поля запроса:

Состав полей ответа:

seatList:

ДОБАВЛЕНИЕ ПРОМОКОДОВ (command = ADD_PROMO_CODES)

Описание: Добавление промокодов для применения пользователем. За один раз можно добавить до 10 промокодов включительно. Регистр символов промокода значения не имеет. В ответе будет столько же промокодов и в том же регистре, как в запросе, поделенные на 3 группы: новые промокоды для пользователя, уже существующие у пользователя промокоды и ошибочные промокоды.

Поля запроса:

Состав полей ответа:

РЕЗЕРВИРОВАНИЕ (БРОНИРОВАНИЕ) МЕСТ(command = RESERVATION)

Описание: Перед созданием заказа необходимо забронировать хотя бы одно место. При получении ошибки в ответе гарантируется, что ни одно место из списка не было забронировано (транзакционные свойства бронирования). Все места в списке должны принадлежать одному сеансу. В ответе присутствуют все места корзины, причем новые (последние забронированные) помечены специальным флагом (поле new).

Подробная информация о процессе бронирования в статье РЕЗЕРВИРОВАНИЕ МЕСТ.

Поля запроса:

seatList:

categoryList:

Состав полей ответа:

seatList:

location:

Пример запроса:
{
 "type": "RESERVE",
 "userId": 6104,
 "sessionId": "19c517c212bf173b44558308149db8ca",
 "command": "RESERVATION",
 "fid": 1185,
  "token": "2f1173e2b12fd5a111b6"
 "seatList": [
 {
    "seatId": 8759500
 },
 {
   "seatId": 8759501,
   "expectedPrice": 100
 },
 {
  "seatId": 8759502,
  "tariffPlanId": 120,
  "expectedPrice": 50
 }
 ],
 "categoryList": [
 {
  "categoryPriceId": 26811,
  "tariffPlanId": 120,
  "expectedPrice": 200,
  "quantity": 1
 },
 {
  "categoryPriceId": 26811,
  "tariffPlanId": 121,
  "expectedPrice": 150,
  "quantity": 2
  }
 ]
}
Пример ответа:
{
 "type": "RESERVE",
 "currency": "RUB",
 "seatList": [
 {
  "seatId": 8759500,
  "categoryPriceId": 26793,
  "price": 100,
  "placement": true,
  "location": {
   "sector": "Партер",
   "row": "3",
   "number": "1"
  },
  "new": true
 },
 {
  "seatId": 8759501,
  "categoryPriceId": 26793,
  "price": 100,
  "placement": true,
  "location": {
   "sector": "Партер",
   "row": "3",
   "number": "2"
  },
 "new": true
 },
 {
  "seatId": 8759502,
  "categoryPriceId": 26794,
  "tariffPlanId": 120,
  "price": 50,
  "placement": true,
  "location": {
   "sector": "Партер",
   "row": "3",
   "number": "3"
  },
 "new": true
 },
 {
   "seatId": 8760681,
   "categoryPriceId": 26812,
   "tariffPlanId": 120,
   "price": 200,
   "placement": false,
   "new": true
 },
 {
   "seatId": 8760682,
   "categoryPriceId": 26812,
   "tariffPlanId": 121,
   "price": 150,
   "placement": false,
   "new": true
 },
 {
  "seatId": 8760683,
  "categoryPriceId": 26812,
  "tariffPlanId": 121,
  "price": 150,
  "placement": false,
  "new": true
 }
 ],
 "cartTimeout": 390,
 "command": "RESERVATION",
 "resultCode": 0,
 "description": "OK"
}

РАЗБРОНИРОВАНИЕ МЕСТ (command = RESERVATION)

Описание: Разбронирование выбранных мест. В ответе присутствуют все оставшиеся после разбронирования места корзины.

Поля запроса:

seatList:

categoryList:

Состав полей ответа:

seatList:

location:

Пример запроса:
{
 "type": "UN_RESERVE",
 "userId": 6104,
 "sessionId": "19c517c212bf173b44558308149db8ca",
 "command": "RESERVATION",
 "fid": 1185,
 "token": "2f1173e2b12fd5a111b6"
 "seatList": [
  {
   "seatId": 8759501
  },
  {
   "seatId": 8759502
  }
 ],
 "categoryList": [
  {
   "categoryPriceId": 26811,
   "tariffPlanId": 121,
   "quantity": 2
  }
 ]
}

Пример ответа:
{
 "type": "UN_RESERVE",
 "currency": "RUB",
 "seatList": [
  {
   "seatId": 8759500,
   "categoryPriceId": 26793,
   "price": 100,
   "placement": true,
   "location": {
    "sector": "Партер",
    "row": "3",
    "number": "1"
   },
   "new": false
  },
  {
   "seatId": 8760681,
   "categoryPriceId": 26812,
   "tariffPlanId": 120,
   "price": 200,
   "placement": false,
   "new": false
  }
 ],
 "cartTimeout": 200,
 "command": "RESERVATION",
 "resultCode": 0,
 "description": "OK"
}

РАЗБРОНИРОВАНИЕ ВСЕХ МЕСТ (command = RESERVATION)

Описание: Разбронирование всех мест либо всех мест конкретного сеанса. В ответе присутствуют все оставшиеся после разбронирования места корзины.

Поля запроса:

Состав полей ответа:

seatList:

location:

Пример запроса:
{
 "type": "UN_RESERVE_ALL",
 "userId": 6104,
 "sessionId": "19c517c212bf173b44558308149db8ca",
 "command": "RESERVATION",
 "fid": 1185,
 "token": "2f1173e2b12fd5a111b6"
}

Пример ответа:
{
 "type": "UN_RESERVE_ALL",
 "currency": "RUB",
 "seatList": [],  "cartTimeout": 0,
 "command": "RESERVATION",
 "resultCode": 0,
 "description": "OK"
}

ВНИМАНИЕ! Далее идет описание устаревшей версии команды RESERVATION:

БРОНИРОВАНИЕ МЕСТ В СХЕМЕ ЗАЛА С РАЗМЕЩЕНИЕМ (command = RESERVATION)

Описание: Бронирование мест в схеме зала с размещением. Перед созданием заказа необходимо забронировать хотя бы одно место. При получении ошибки в ответе гарантируется, что ни одно место из списка не было забронировано (транзакционные свойства бронирования). Если список мест содержит ранее успешно забронированные места, они исключаются из списка. Все места в списке должны принадлежать одному сеансу.

Поля запроса:

Состав полей ответа:

seatList:

location:

Пример запроса:
{
 "type": "RESERVE_BY_PLACE",
 "seatList": [
    100
 ],
 "userId": 6104,
 "sessionId": "19c517c212bf173b44558308149db8ca",
 "command": "RESERVATION",
 "fid": 1185,
  "token": "2f1173e2b12fd5a111b6"
}
Пример ответа:
{
 "type": "RESERVE_BY_PLACE",
 "command": "RESERVATION",
 "resultCode": 0,
 "description": "OK"
}

БРОНИРОВАНЕ МЕСТ В СЗЕМЕ ЗАЛА БЕЗ РАЗМЕЩЕНИЯ (Команда устарела) (command = RESERVATION)

Описание: Бронирование мест в схеме зала без размещения. Перед созданием заказа необходимо забронировать хотя бы одно место. При получении ошибки в ответе гарантируется, что ни одно место из списка не было забронировано (транзакционные свойства бронирования). Бронирование производится указанием ценовой категории и количества мест в данной категории. При одновременном бронировании мест в нескольких ценовых категориях, все ценовые категории должны принадлежать одному сеансу. Ценовые категории должны быть без размещения, в противном случае необходимо использовать метод бронирования мест в схеме зала с размещением.

Поля запроса:

Состав полей ответа:

seatList:

location:

Пример запроса:
{
 "type": "RESERVE",
 "categoryQuantityMap": {
   "1072": 1
 },
 "userId": 6104,
 "sessionId": "19c517c212bf173b44558308149db8ca",
 "command": "RESERVATION",
 "fid": 1185,
 "token": "2f1173e2b12fd5a111b6",
 "kdp": 123
}
Пример ответа:
{
 "type": "RESERVE",
 "command": "RESERVATION",
 "resultCode": 0,
 "description": "OK"
}

РАЗБРОНИРОВАНИЕ МЕСТА (устарело) (command = RESERVATION)

Поля запроса:

Состав полей ответа:

seatList:

location:

Пример 1. запроса снятия брони со всех мест:
{
 "type": "UN_RESERVE_ALL",
 "userId": 6104,
 "sessionId": "19c517c212bf173b44558308149db8ca",
 "command": "RESERVATION",
 "fid": 1185,
 "token": "2f1173e2b12fd5a111b6"
}
Пример 2. запроса снятия брони со всех мест конкретного сеанса:
{
 "type": "UN_RESERVE_ALL",
 "userId": 6104,
 "sessionId": "19c517c212bf173b44558308149db8ca",
 "actionEventId": 5,
 "command": "RESERVATION"
}
Пример 3. запроса снятия брони со списка мест:
{
 "type": "UN_RESERVE",
 "seatList": [
   4790
 ],
 "userId": 6104,
 "sessionId": "19c517c212bf173b44558308149db8ca",
 "command": "RESERVATION",
 "fid": 1185,
 "token": "2f1173e2b12fd5a111b6"
}
Пример ответа:
{
 "command": "RESERVATION",
 "type": "UN_RESERVE",
 "resultCode": 0,
 "description": "OK"
}

ПОЛУЧЕНИЕ СПИСКА ЗАБРОНИРОВАННЫХ МЕСТ (command = GET_CART)

Описание: метод возвращает места, забронированные пользователем, сгруппированные по сеансам.

Поля запроса:

Состав полей ответа:

actionEventList:

seatList:

*Если схема зала местовая, то поля sector, row, number будут присутствовать в ответе.

Пример запроса:
{
 "userId": 6104,
 "sessionId": "19c517c212bf173b44558308149db8ca",
 "command": "GET_CART",
 "fid": 1185,
 "token": "2f1173e2b12fd5a111b6"
}
Пример ответа:
{
 "time": 588,
 "totalSum": 1200,
 "totalServiceCharge": 0,
  "actionEventList": [
  {
   "actionEventId": 344,
   "day": "02.06.2016",
   "time": "18:00",
   "actionName": "SOPRANO ШОУ",
   "fullActionName": "Михаил Турецкий представляет вечер любви",
   "smallPosterUrl": "https://api.bil24.pro:1240/image?type=smallPoster&actionId=80&hash=r9qfi771jid3pf0or7vxc8xrb",
   "bigPosterUrl": "https://api.bil24.pro:1240/image?type=bigPoster&actionId=80&hash=m3b37t9tynyes52fxx7zw6gdl",
   "cityId": 1,
   "cityName": "Сочи",
   "venueId": 10,
   "venueName": "Зимний театр",
   "serviceCharge": 0,
   "seatList": [
    {
      "seatId": 524692,
     "categoryPriceName": "Шестая",
     "price": 600,
     "sector": "Сектор Партер",
     "row": "Ряд 9",
     "number": "Место 11",
     "serviceCharge": 0
     },
    {
     "seatId": 524691,
     "categoryPriceName": "Шестая",
      "price": 600,
     "sector": "Сектор Партер",
     "row": "Ряд 9",
      "number": "Место 10",
     "serviceCharge": 0
    }
    ]
   }
  ],
 "command": "GET_CART",
 "resultCode": 0,
 "description": "OK"
}

СОЗДАНИЕ ЗАКАЗА (command = CREATE_ORDER)

Описание: cоздание заказа из забронированных мест. Для интерфейса Билетная система вместо данного метода необходимо использовать метод CREATE_ORDER_EXT.

Поля запроса:

Состав полей ответа:

Пример запроса:
{
 "userId": 6104,
 "sessionId": "19c517c212bf173b44558308149db8ca",
 "successUrl": "https://site.ru/success.php",
 "failUrl": "https://site.ru/fail.php",
 "command": "CREATE_ORDER",
 "fid": 1185,
 "token": "2f1173e2b12fd5a111b6"
}
Пример ответа:
{
 "formUrl": "https://test.paymentgate.ru/testpayment/merchants/bil24/mobile_payment_ru.html?mdOrder=b8bb4b76-3a73-4816-92d4-954aa7d01e&pageView=MOBILE",
 "statusExtStr": "NEW",
 "statusExtInt": 0,
 "command": "CREATE_ORDER",
 "resultCode": 0,
 "description": "OK"
}

СОЗДАНИЕ ЗАКАЗА (command = CREATE_ORDER_EXT)*

Описание: Создание заказа из забронированных мест. Используется вместо метода CREATE_ORDER для интерфейса Билетная система. После создания заказ принимает статус NEW.
*только для интерфейса Билетная система

Поля запроса:

Состав полей ответа:

Пример запроса:
{
 "userId": 18109,
 "sessionId": "d6035a755bd0862e713e03f337505bd0",
 "command": "CREATE_ORDER_EXT",
 "fid": 1184,
 "token": "24d3b97b64dfab187a5f"
}
Пример ответа:
{
 "orderId": 64,
 "discount": 10,
 "serviceCharge": 99,
 "sum": 1000,
 "totalSum": 1089,
 "quantity": 5,
 "command": "CREATE_ORDER_EXT",
 "resultCode": 0,
 "description": "OK"
}

ОТМЕНА ЗАКАЗА (command = CANCEL_ORDER)*

Описание: отмена ранее созданного заказа. Отменить можно только заказ со статусом NEW. В результате запроса заказ примет статус CANCELLING или CANCELLED. При попытке отменить заказ не со статусом NEW, ошибки не произойдет, статус заказа не изменится, а в ответе придет актуальный статус заказа. Когда статус заказа примет значение CANCELLED, места, входящие в заказ, станут свободными.
*только для интерфейса Билетная система

Поля запроса:

Состав полей ответа:

Пример запроса:
{
 "orderId": 64,
 "userId": 18109,
 "sessionId": "d6035a755bd0862e713e03f337505bd0",
 "command": "CANCEL_ORDER",
 "fid": 1184,
 "token": "24d3b97b64dfab187a5f"
}
Пример ответа:
{
 "orderId": 64,
 "statusExtStr": "CANCELLED",
 "statusExtInt": -2,
 "command": "CANCEL_ORDER",
 "resultCode": 0,
 "description": "OK"
}

ОПЛАТА ЗАКАЗА (command = PAY_ORDER)*

Описание: оплата ранее созданного заказа. Оплатить можно только заказ со статусом NEW. В результате запроса заказ примет статус PROCESSING или PAID. При попытке оплатить заказ не со статусом NEW, ошибки не произойдет, статус заказа не изменится, а в ответе придет актуальный статус заказа.
*только для интерфейса Билетная система

Поля запроса:

Состав полей ответа:

Пример запроса:
{
 "orderId": 64,
 "userId": 18109,
 "sessionId": "d6035a755bd0862e713e03f337505bd0",
 "command": "PAY_ORDER",
 "fid": 1184,
 "token": "24d3b97b64dfab187a5f"
}
Пример ответа:
{
 "orderId": 64,
 "statusExtStr": "PAID",
 "statusExtInt": 2,
 "command": "PAY_ORDER",
 "resultCode": 0,
 "description": "OK"
}

ПОЛУЧЕНИЕ ЗАКАЗОВ ПОЛЬЗОВАТЕЛЯ (command = GET_ORDERS)

Поля запроса:

Состав полей ответа:

orderList:

Пример запроса:
{
 "userId": 6104,
 "sessionId": "19c517c212bf173b44558308149db8ca",
 "command": "GET_ORDERS",
 "fid": 1185,
 "token": "2f1173e2b12fd5a111b6"
}
Пример ответа:
{
 "orderList": [
  {
   "orderId": 64,
   "date": "06.08.2015 18:48",
   "datePattern": "dd.MM.yyyy HH:mm",
   "discount": 0,
   "serviceCharge": 0,
   "sum": 600,
   "quantity": 4,
    "statusExtStr": "PAID",
    "statusExtInt": 2,
    "formUrl": "https://test.paymentgate.ru/testpayment/merchants/bil24/mobile_payment_ru.html?mdOrder=2a2637b4-3d2b-44c4-b29f-4c3b39d17722&pageView=MOBILE",
  }
  ],
 "command": "GET_ORDERS",
 "resultCode": 0,
 "description": "OK"
}

ПОЛУЧЕНИЕ ЗАКАЗОВ ПОЛЬЗОВАТЕЛЯ (command = GET_ORDERS_EXT)

Поля запроса:

Состав полей ответа:

orderList:

Пример запроса:
{
 "fromDate": "01.01.2016 00:00:00",
 "userId": 6104,
 "sessionId": "19c517c212bf173b44558308149db8ca",
 "command": "GET_ORDERS_EXT",
 "fid": 1185,
 "token": "2f1173e2b12fd5a111b6"
}
Пример ответа:
{
 "orderDatePattern": "dd.MM.yyyy HH:mm:ss",
 "ticketDatePattern": "dd.MM.yyyy HH:mm",
 "orderList": [
  {
   "orderId": 3037,
   "date": "12.12.2016 13:29:53",
   "discount": 0,
   "serviceCharge": 30.00,
   "sum": 630.00,
   "quantity": 2,
   "ticketList": [
    {
     "ticketId": 29965,
     "date": "09.01.2017 10:00",
     "actionName": "Звёздные войны: Пробуждение силы",
     "venueName": "Кинотеатр Люксор",
     "sector": "Сектор Партер",
     "row": "Ряд 2",
     "number": "Место 12",
      "categoryName": "Категория: Третья",
     "price": 300
    },
    {
     "ticketId": 29966,
     "date": "09.01.2017 10:00",
     "actionName": "Звёздные войны: Пробуждение силы",
     "venueName": "Кинотеатр Люксор",
     "sector": "Сектор Партер",
     "row": "Ряд 1",
     "number": "Место 13",
     "categoryName": "Категория: Третья",
     "price": 300
    }
   ],
   "statusExtStr": "PAID",
   "statusExtInt": 2,
  },
  {
   "orderId": 2438,
   "date": "30.08.2016 00:14:55",
   "discount": 0,
   "serviceCharge": 0.00,
   "sum": 0.00,
   "quantity": 1,
   "ticketList": [
    {
     "ticketId": 29095,
     "date": "31.07.2017 09:00",
     "actionName": "КЛУБ ЛЮБИМЫХ",
     "venueName": "территория Сочи",
     "categoryName": "Категория: Золотая",
     "price": 0
    }
   ],
   "status": 1
  }
 ],
 "command": "GET_ORDERS_EXT",
 "resultCode": 0,
 "description": "OK"
}

ПОЛУЧЕНИЕ СПИСКА СЕАНСОВ, ПО КОТОРЫМ БЫЛИ КУПЛЕНЫ БИЛЕТЫ (command = GET_ACTION_EVENTS_GROUPED_BY_TICKETS)

Поля запроса:

Состав полей ответа:

list:

Пример запроса:
{
 "userId": 6104,
 "sessionId": "19c517c212bf173b44558308149db8ca",
 "command": "GET_ACTION_EVENTS_GROUPED_BY_TICKETS",
 "fid": 1185,
 "token": "2f1173e2b12fd5a111b6"
}
Пример ответа:
{
 "dayPattern": "dd.MM.yyyy",
 "timePattern": "HH:mm",
 "list": [
  {
   "actionEventId": 5,
   "actionName": "Балет Спящая красавица",
   "day": "28.09.2015",
   "time": "11:01",
   "bigPosterUrl": "https://api.bil24.pro:1240/image?type=bigPoster&actionId=2&hash=lpmbkeg1lae6najf2zd099kgs"
  },
  {
   "actionEventId": 22,
   "actionName": "Кино Эверест",
   "day": "30.09.2015",
   "time": "15:00",
   "bigPosterUrl": "https://api.bil24.pro:1240/image?type=bigPoster&actionId=11&hash=rf8qt7yz5z4s96hmko0kmkuf8"
  },
  {
   "actionEventId": 8,
   "actionName": "Концерт группы Scooter",
   "day": "12.10.2015",
   "time": "21:05",
   "bigPosterUrl": "https://api.bil24.pro:1240/image?type=bigPoster&actionId=3&hash=mtpqe8hih74wyla45p983zmt3"
  }
 ],
 "command": "GET_ACTION_EVENTS_GROUPED_BY_TICKETS",
 "resultCode": 0,
 "description": "OK"
}

ПОЛУЧЕНИЕ КУПЛЕННЫХ БИЛЕТОВ ПО ID ПРЕДСТАВЛЕНИЯ (command = GET_TICKETS_BY_ACTION_EVENT)

Поля запроса:

Состав полей ответа:

ticketList:

Пример запроса:
{
 "actionEventId": 5,
 "sizeQrCode": 500,
 "widthBarCode": 500,
 "heightBarCode": 100,
 "type": "PNG",
 "userId": 6104,
 "sessionId": "19c517c212bf173b44558308149db8ca",
 "command": "GET_TICKETS_BY_ACTION_EVENT",
 "fid": 1185,
 "token": "2f1173e2b12fd5a111b6"
}
Пример ответа:
{
 "datePattern": "dd.MM.yyyy HH:mm",
 "actionEventId": 5,
 "actionName": "Кармен",
 "ticketList": [
   {
    "ticketId": 10075,
    "date": "28.09.2015 11:01",
    "venueName": "Зимний театр",
    "venueAddress": "ул. Театральная, 2",
    "actionName": "Кармен",
    "sector": "Сектор Партер",
    "row": "Ряд 1",
    "number": "Место 22",
    "categoryName": "Категория Х",
    "price": 1000,
    "totalPrice": 0,
    "serviceCharge": 0,
    "qrCodeImg": "iVBORw0KGgoAAAANSUhEUgAAAfQAAAH0AQAAAADjreInAAACwElEQVR42u3dS27jMBBFUe2A+99l7YCdjmjWq6KCbiCjJ1zDA1n2YUaEWB8y1/zVKy53H9d+fX1eV2N9/XXx9/25s34mBI939zqVEse1J9c9xH2h979nDx5v7mPNijUxRv5uz6v91R76Jnj8e/z3/FkfZebk4+S+xuPf6sfMOTPLmml/xONf5WsonaulHUvcYCT+cf2Fx7v5jJ/jf98/xN94vJuv2VCNk/dESvmP/Cse7+ajpkTHLNGyhNY57h4Uj3+F32kjTZWWKFrvy1d4vLeXqHgVyXacMCVbOmSgkWkmPN7b6zpJEqalYNZWXJETCY+39zVI0OVRqyu3MkPmj",
    "barCodeImg": "iVBORw0KGgoAAAANSUhEUgAAAfQAAABkAQAAAABYvP/QAAAAYklEQVR42u3LsQ2AIBBG4TMWVzICm+hiJDAabMIIV1KY/GpcwuI1r3n5TFGyK3atLer0njQ1dNk6o5iPJ+qpmUZYXsd323urfCgMj8fj8Xg8Ho/H4/F4PB6Px+PxeDz+Z/4GLPLRZ1RHc5UAAAAASUVORK5CYII="
    "barCodeNumber": "0123456789123",
    "smallPosterUrl": "https://..."
    "legalOwner": "Организатор...",
    "age": "18+",
    }
 ],
 "command": "GET_TICKETS_BY_ACTION_EVENT",
 "resultCode": 0,
 "description": "OK"
}

ПОЛУЧЕНИЕ КУПЛЕННЫХ БИЛЕТОВ ПО ID ЗАКАЗА (command = GET_TICKETS_BY_ORDER)

Поля запроса:

Состав полей ответа:

ticketList:

Статус билета:

Пример запроса:
{
 "orderId": 5,
 "sizeQrCode": 500,
 "widthBarCode": 500,
 "heightBarCode": 100,
 "type": "PNG",
 "userId": 6104,
 "sessionId": "19c517c212bf173b44558308149db8ca",
 "command": "GET_TICKETS_BY_ORDER",
 "fid": 1185,
 "token": "2f1173e2b12fd5a111b6"
}
Пример ответа:
{
 "orderDatePattern": "dd.MM.yyyy HH:mm:ss",
 "actionEventDatePattern": "dd.MM.yyyy HH:mm",
 "orderId": 5,
 "date": "27.09.2015 10:01:01",
 "discount": 0,
 "serviceCharge": 0,
 "sum": 1000,
 "totalSum": 1000,
 "quantity": 5,
 "statusExtStr": "PAID",
 "statusExtInt": 2,
 "ticketList": [
    {
    "ticketId": 10075,
    "date": "28.09.2015 11:01",
    "venueName": "Зимний театр",
    "venueAddress": "ул. Театральная, 2",
    "actionName": "Кармен",
    "sector": "Сектор Партер",
    "row": "Ряд 1",
    "number": "Место 22",
    "categoryName": "Категория Х",
    "price": 1000,
    "totalPrice": 0,
    "serviceCharge": 0,
     "qrCodeImg": "iVBORw0KGgoAAAANSUhEUgAAAfQAAAH0AQAAAADjreInAAACwElEQVR42u3dS27jMBBFUe2A+99l7YCdjmjWq6KCbiCjJ1zDA1n2YUaEWB8y1/zVKy53H9d+fX1eV2N9/XXx9/25s34mBI939zqVEse1J9c9xH2h979nDx5v7mPNijUxRv5uz6v91R76Jnj8e/z3/FkfZebk4+S+xuPf6sfMOTPLmml/xONf5WsonaulHUvcYCT+cf2Fx7v5jJ/jf98/xN94vJuv2VCNk/dESvmP/Cse7+ajpkTHLNGyhNY57h4Uj3+F32kjTZWWKFrvy1d4vLeXqHgVyXacMCVbOmSgkWkmPN7b6zpJEqalYNZWXJETCY+39zVI0OVRqyu3MkPmj",
     "barCodeImg": "iVBORw0KGgoAAAANSUhEUgAAAfQAAABkAQAAAABYvP/QAAAAYklEQVR42u3LsQ2AIBBG4TMWVzICm+hiJDAabMIIV1KY/GpcwuI1r3n5TFGyK3atLer0njQ1dNk6o5iPJ+qpmUZYXsd323urfCgMj8fj8Xg8Ho/H4/F4PB6Px+PxeDz+Z/4GLPLRZ1RHc5UAAAAASUVORK5CYII="
    "barCodeNumber": "0123456789123",
    "smallPosterUrl": "https://..."
    "legalOwner": "Организатор...",
    "age": "18+",
    }
 ],
 "command": "GET_TICKETS_BY_ACTION_ORDER",
 "resultCode": 0,
 "description": "OK"
}

ПОЛУЧЕНИЕ ИНФОРМАЦИИ ПО ПРОДАННЫМ БИЛЕТАМ ЗА КОНКРЕТНЫЙ ДЕНЬ (command = GET_TICKETS_BY_DAY)

Поля запроса:

Состав полей ответа:

cityList:

actionList:

actionEventList:

ticketList:

Пример запроса:
{
 "date": "08.06.2017",
 "command": "GET_TICKETS_BY_DAY",
 "fid": 1185,
 "token": "2f1173e2b12fd5a111b6"
}
Пример ответа:
{
 "date": "07.06.2017",
 "cityList": [
  {
   "cityId": 3,
   "actionList": [
    {
     "actionId": 323,
     "actionEventList": [
      {
       "actionEventId": 1814,
       "ticketList": [
        {
         "ticketId": 30935,
         "seatId": 2943773,
         "date": "07.06.2017 12:57:01",
         "price": 3000,
         "discount": 0,
         "serviceCharge": 0,
         "totalPrice": 3000.00,
         "refunded": false
        },
       ]
      }
     ]
    }
   ]
  }
 ],
 "command": "GET_TICKETS_BY_DAY",
 "resultCode": 0,
 "description": "OK"
}

ПЕЧАТЬ БИЛЕТОВ (command = PRINT_TICKETS)

Описание: позволяет создать файл с билетами конкретного пользователя. Билеты помещаются в один файл в переданном порядке.
*только для интерфейсов Билетный агент и Билетная система
Поля запроса:

Состав полей ответа:

ПОЛУЧЕНИЕ ИНФОРМАЦИИ О ПОЛЬЗОВАТЕЛЕ (command = GET_USER_INFO)

Поля запроса:

Состав полей ответа:

Пример запроса:
{
 "userId": 6104,
 "sessionId": "19c517c212bf173b44558308149db8ca",
 "command": "GET_USER_INFO",
 "fid": 1185,
 "token": "2f1173e2b12fd5a111b6"
}
Пример ответа:
{
 "seatInReserve": 2,
 "orderInWait": 0,
 "command": "GET_USER_INFO",
 "resultCode": 0,
 "description": "OK"
}

ОТПРАВКА БИЛЕТОВ НА ПОЧТУ (command = SEND_TICKETS_TO_EMAIL)

Поля запроса:

Пример запроса:
{
 "email": "email@list.ru",
 "ticketIdList": [
  10261
 ],
 "userId": 6104,
 "sessionId": "19c517c212bf173b44558308149db8ca",
 "command": "SEND_TICKETS_TO_EMAIL",
 "fid": 1185,
 "token": "2f1173e2b12fd5a111b6"
}

Пример ответа:
{
 "command": "SEND_TICKETS_TO_EMAIL",
 "resultCode": 0,
 "description": "OK"
}

УДАЛЕНИЕ (command = DELETE)

Описание: Метод помечает билет/заказ пользователя как удаленный, чтобы на интерфейсах в дальнейшем их не подгружать.

Поля запроса:

* destination = TICKETS_BY_ACTION_EVENT - помечаются как удаленные все билеты пользователя на конкретный сеанс.

Состав полей ответа:

Пример запроса удаления заказа:
{
 "userId": 6104,
 "sessionId": "19c517c212bf173b44558308149db8ca",
 "id": 1, //id заказа
 "destination": "ORDER"
 "command": "DELETE",
 "fid": 1185,
 "token": "2f1173e2b12fd5a111b6"
}

Пример ответа успешного удаления:
{
 "command": "DELETE",
 "id": 1, //id удаленного заказа
 "destination": "ORDER"
 "resultCode": 0,
 "description": "OK"
}

ПОЛУЧЕНИЕ ИНФОРМАЦИИ О ЗАКАЗЕ (command = GET_ORDER_INFO)

Поля запроса:

Состав полей ответа:

orderInfoList:

Пример запроса:
{
 "userId": 6104,
 "sessionId": "19c517c212bf173b44558308149db8ca",
 "orderId": 829,
 "command": "GET_ORDER_INFO",
 "fid": 1185,
 "token": "2f1173e2b12fd5a111b6"
}

Пример ответа:
{
 "orderId": 829,
 "statusExtStr": "NEW",
 "statusExtInt": 0,
 "orderInfoList": [
   {
     "actionId": 80,
     "actionName": "В сердце моря",
     "quantity": 1,
     "sum": 200,
     "smallPosterUrl": "https://api.bil24.pro:1240/image?type=smallPoster&actionId=80&hash=q823uap2k22aj0da1hbktd0ch"
   }
  ],
 "command": "GET_ORDER_INFO",
 "resultCode": 0,
 "description": "OK"
}

ПОЛУЧЕНИЕ ПОЧТЫ (command = GET_EMAIL)

Поля запроса:

Состав полей ответа:

Пример запроса:
{
"userId": 6104,
"sessionId": "19c517c212bf173b44558308149db8ca",
"command": "GET_EMAIL",
"fid": 1185,
"token": "2f1173e2b12fd5a111b6"
}

Пример ответа:
{
"email": "westleyy@rambler.ru",
"needSendTicketEmail": true,
"command": "GET_EMAIL",
"resultCode": 0,
"description": "OK"
}

ОТПРАВКА GCM ТОКЕНА НА СЕРВЕР (command = SET_PUSH_TOKEN)

Поля запроса:

Пример запроса:
{
 "userId": 6104,
 "sessionId": "19c517c212bf173b44558308149db8ca",
 "pushToken": "ec7c5ae54051c60a219d672c4b7d743",
 "command": "SET_PUSH_TOKEN",
 "fid": 1185,
 "token": "2f1173e2b12fd5a111b6"
}

Пример ответа:
{
 "command": "SET_PUSH_TOKEN",
 "resultCode": 0,
 "description": "OK"
}

ПОЛУЧИТЬ НОВОСТИ (command = GET_NEWS)

Поля запроса:

Состав полей ответа:

newsList:

Пример запроса (получить 10 новостей младше текущей даты):
{
 "time": 0,
 "count": 10,
 "cursorMode": "backward",
 "userId": 6104,
 "sessionId": "19c517c212bf173b44558308149db8ca",
 "command": "GET_NEWS",
 "fid": 11851,
 "token": "2f1173e2b12fd5a111b6"
}
* time используется либо 0, либо unixTime пришедшей новости, либо serverUnixTime. Локальное время устройства не использовать!

Если time = 0, то на сервере используется значение текущего времени

Если cursorMode = forward, то новости приходят отсортированные по возрастанию даты
Если cursorMode = backward, то новости приходят отсортированные по убыванию даты.

Пример ответа:
{
 "datePattern": "dd.MM.yyyy HH:mm",
 "newsList": [
  {
   "id": 91,
   "unixTime": 1458571320000,
   "date": "21.03.2016 17:42",
   "header": "Заголовок 1",
   "fullDescription": "Описание 1"
  },
  {

   "id": 72,
   "unixTime": 1457989200000,
   "date": "15.03.2016 00:00",
   "header": "Заголовок 2",
   "fullDescription": "Описание 2"
  }
  ],
 "cursorMode": "backward",
 "serverUnixTime": 1459769342975,
 "last": false,
 "command": "GET_NEWS",
 "resultCode": 0,
 "description": "OK"
}

ПРОВЕРКА КДП (command = CHECK_KDP)

Поля запроса:

Пример запроса:
{
 "userId": 6104,
 "sessionId": "19c517c212bf173b44558308149db8ca",
 "actionId": 10,
 "kdp": 12345,
 "command": "CHECK_KDP",
 "fid": 1185,
 "token": "2f1173e2b12fd5a111b6"
}

Пример положительного ответа:
{
 "command": "CHECK_KDP",
 "resultCode": 0,
 "description": "OK"
}

Пример ответа с неверным КДП:
{
 "command": "CHECK_KDP",
 "resultCode": 101,
 "description": "неверный КДП"
}

ПОЛУЧЕНИЕ ДАННЫХ ДЛЯ ФИЛЬТРА (command = GET_FILTER).

Поля запроса:

Состав полей ответа:

countryList:

cityList:

venueList:

kindList:

genreList:

Пример запроса:
{
 "command": "GET_FILTER",
 "fid": 1185,
 "token": "2f1173e2b12fd5a111b6"
}

Пример ответа:
{
 "cityList": [
   {
     "cityId": 1,
     "cityName": "Сочи",
     "venueList": [
       {
          "venueId": 1,
         "venueName": "Зимний театр"
       },
       {
         "venueId": 24,
         "venueName": "Зеленый театр парка \"Ривьера\""
       }
     ]
   },
   {
     "cityId": 2,
     "cityName": "Москва",
     "venueList": [
       {
         "venueId": 4,
         "venueName": "Малая Спортивная Арена Лужники"
       },
        {
         "venueId": 20,
         "venueName": "SCANDINAVIA CLUB"
       }
     ]
   },
 ],
 "kindList": [
   {
     "kindId": 0,
     "kindName": "События"
   },
    {
      "kindId": 1,
     "kindName": "Карты (МЭК)"
   },
   {
     "kindId": 2,
     "kindName": "Экскурсии"
   },
   {
     "kindId": 3,
     "kindName": "Рестораны"
   },
   {
     "kindId": 4,
     "kindName": "Отели"
   }
 ],
 "command": "GET_FILTER",
 "resultCode": 0,
 "description": "OK"
}

ПРИВЯЗКА ПОЧТЫ (command = BIND_EMAIL)

Чтобы подтвердить почту, необходимо:
1. выполнить метод BIND_EMAIL. На указанную почту придет код подтверждения.
2. выполнить CONFIRM_EMAIL с кодом, пришедшим на почту. В ответе придут данные аккаунта (userId, sessionId), к которым успешно прикреплена почта. С этими данными необходимо выполнять все последующие запросы.

Поля запроса:

Пример запроса:
{
 "userId": 6104,
 "sessionId": "19c517c212bf173b44558308149db8ca",
 "command": "BIND_EMAIL",
 "email": "email@list.ru",
 "fid": 1185,
 "token": "2f1173e2b12fd5a111b6"
}

Пример положительного ответа:
{
 "command": "BIND_EMAIL",
 "resultCode": 0,
 "description": "OK"
}

ПОДТВЕРЖДЕНИЕ ПОЧТЫ (command = CONFIRM_EMAIL)

Поля запроса:

Состав полей ответа:

Пример запроса:
{
 "userId": 6104,
 "sessionId": "19c517c212bf173b44558308149db8ca",
 "command": "CONFIRM_EMAIL",
 "code": 123456,
 "fid": 1185,
 "token": "2f1173e2b12fd5a111b6"
}

Пример положительного ответа:
{
 "command": "CONFIRM_EMAIL",
 "userId": 2,
 "sessionId": "2e4566051c60a219d672c4b7a12d129",
 "email": "email@list.ru",
 "resultCode": 0,
 "description": "OK"
}

ПОЛУЧЕНИЕ КАРТ (МЭК) (command = GET_MECS)

Поля запроса:

*mecId - Поле используется для экономии трафика в основном на мобильных фронтендах. Если передать данное поле в запросе, то в ответ вернутся карты с id большим чем переданный в запросе. Подразумевается, что карты с id <= mecId хранятся локально и не требуются в повторной загрузке.

Состав полей ответа:

list: