Radario.Api

Текущая версия API 1.1.

Документация по версии v1 доступна по адресу https://radario.github.io/slate/radario.api/.

Обратите внимание, все новые клиенты должны использовать только версию API не ниже 1.1. Использование версии v1 новыми клиентами в любой момент может быть ограничено, без предварительного уведомления.

Изменения относительно версии v1

• версию API теперь следует передавать не в URL адресе запроса, а в отдельном заголовке api-version, передача данного атрибута является обязательной
• теперь все запросы требуют передачу заголовков авторизации api-id и api-key
• больше не требуется передавать атрибут onlyWithOrderCreationAvailableViaApi=true, все права будут учитываться автоматически, в отличие от версии v1 где из за сохранения обратной совместимости, следовало отдельно передавать атрибут onlyWithOrderCreationAvailableViaApi=true в некоторых запросах

Пример как было

curl -X GET "https://api.radario.ru/v1/events?onlyWithOrderCreationAvailableViaApi=true" \
  -H "api-id: XXX" \
  -H "api-key: XXX"

как стало

curl -X GET "https://api.radario.ru/events" -H "api-id: XXX" -H "api-key: XXX" -H "api-version: 1.1"

Общие сведения

Базовый адрес для всех запросов https://api.radario.ru/

При передаче данных на сервер, следует использовать формат application/json с указанием соответствующего заголовка Content-Type.

Для всех запросов и ответов используется кодировка UTF-8.

Для работы с API, с каждым запросом в HTTP заголовках app-id, app-key требуется передать ключи доступа, а в заголовке api-version используемую версию API .

Ключи доступа можно получить связавшись с представителем радарио.

Пример запроса

curl -X GET "https://api.radario.ru/events" -H "api-id: XXX" -H "api-key: XXX" -H "api-version: 1.1"

Categories

Get events categories

GET /categories

Response model

{
  "success": "bool",
  "data": [{
    "id": "int",
    "name": "string"
  }],
  "error": {
    "errorCode": "int",
    "message": "string",
    "requestId": "string"
  }
}

Attributes

Cities

Get cities

GET /cities

Parameters

Response model

{
  "success": "bool",
  "data": [{
    "id": "int",
    "name": "string",
    "latitude": "double",
    "longitude": "double",
    "gmtOffset": "int"
  }],
  "error": {
    "errorCode": "int",
    "message": "string",
    "requestId": "string"
  }
}

Attributes

Company

Get company by id

GET /hosts/{id}

Parameters

Response model

{
  "success": "bool",
  "data": {
    "id": "int",
    "title": "string",
    "logoUri": "string",
    "requisiteName": "string",
    "requisiteINN": "string",
    "requisiteAddress": "string",
    "supportEmail": "string",
    "supportPhone": "string",
    "visitingRules": "string",
    "refundRules": "string"
  },
  "error": {
    "errorCode": "int",
    "message": "string",
    "requestId": "string"
  }
}

Attributes

Events

Get events by query

GET /events

Parameters

Response model

{
  "success": "bool",
  "data": {
  "items": [{
    "id": "int",
    "title": "string",
    "description": "string",
    "age": "int",
    "beginDate": "datetime",
    "endDate": "datetime",
    "salesStopped": "bool",
    "videoUrl": "string",
    "images": "string",
    "category": "string",
    "placeId": "int",
    "placeTitle": "string",
    "placeAddress": "string",
    "companyId": "int",
    "companyTitle": "string",
    "eventProviderId": "int",
    "eventProviderName": "string",
    "cityId": "int",
    "cityName": "string",
    "placeSchemeId": "int",
    "groupId": "int",
    "currency": "string",
    "ticketCount": "int",
    "gmtOffset": "int",
    "barcodeType": "string",
    "onlineTranslation": "bool",
    "autoClosingSalesMinutes": "int", nullable
    "proCultureId": string
  }],
  "totalCount": "int"
  },
  "error": {
    "errorCode": "int",
    "message": "string",
    "requestId": "string"
  }
}

Attributes

Get event by id

GET /events/{eventId}

Parameters

Response model

{
  "success": "bool",
  "data": {
    "id": "int",
    "title": "string",
    "description": "string",
    "age": "int",
    "beginDate": "datetime",
    "endDate": "datetime",
    "salesStopped": "bool",
    "videoUrl": "string",
    "images": "string",
    "category": "string",
    "placeId": "int",
    "placeTitle": "string",
    "placeAddress": "string",
    "companyId": "int",
    "companyTitle": "string",
    "eventProviderId": "int",
    "eventProviderName": "string",
    "cityId": "int",
    "cityName": "string",
    "placeSchemeId": "int",
    "groupId": "int",
    "currency": "string",
    "ticketCount": "int",
    "gmtOffset": "int",
    "barcodeType": "string",
    "onlineTranslation": "bool",
    "autoClosingSalesMinutes": "int", nullable
    "proCultureId": string
  },
  "error": {
    "errorCode": "int",
    "message": "string",
    "requestId": "string"
  }
}

Attributes

Get event TicketType item

GET /events/{eventId}/ticket_types

Parameters

Response model

{
  "success": "bool",
  "data": {
    "items": [{
      "id": "int",
      "title": "string",
      "price": "decimal",
      "ticketCount": "int",
      "soldTicketCount": "int",
      "withSeats": "bool",
      "series": "string",
      "seatBeginNumber": "int",
      "seatEndNumber": "int",
      "zoneId": "int",
      "participantNameRequired": "bool",
      "seats": [{
        "isOccupied": "bool",
        "number": "int",
        "rowName": "string",
        "seatName": "string"
      }],
      "baseTicketTypeId": "int"
    }],
    "totalCount": "int"
  },
  "error": {
    "errorCode": "int",
    "message": "string",
    "requestId": "string"
  }
}

Attributes

ZoneId

Для квот на событие с SVG схемой и посадочными местами отсутствует понятие зоны. Для таких квот значение атрибута zoneId не должно учитываться и как правило содержит значение 0.

Для квот на событие с SVG схемой без посадочных мест в атрибуте ZoneId задается идентификатор объекта на схеме к которому привязана квота. Если квота не привязана к объекту, то атрибут ZoneId будет иметь значение null.

Get event Tariffs

GET /events/{eventId}/tariffs

Parameters

Response model

{
  "success": "bool",
  "data": {
    "items": [
      {
        "id" : "int",
        "title" : "string",
        "description" : "string",
        "ticketTypes": [
          {
            "id": "int",
            "title": "string",
            "price": "decimal",
            "ticketCount": "int",
            "soldTicketCount": "int",
            "withSeats": "bool",
            "series": "string",
            "seatBeginNumber": "int",
            "seatEndNumber": "int",
            "zoneId": "int",
            "participantNameRequired": "bool",
            "seats": [
              {
                "isOccupied": "bool",
                "number": "int",
                "rowName": "string",
                "seatName": "string"
              }
            ],
            "baseTicketTypeId": "int"
          }
        ]
      }
    ],
    "totalCount": "int"
  },
  "error": {
    "errorCode": "int",
    "message": "string",
    "requestId": "string"
  }
}

Attributes

О тарифах

Роут повторяет /events/{eventId}/ticket_types, за исключением того, что квоты обёрнуты в тарифы. Особенность тарифов в заключаются том, что на одно место могут быть заведены различные квоты с разными ценовыми категориями(прим. "Взрослый" - "Детский"). Следовательно, одни и те же места могут содержаться в нескольких квотах разных тарифов. Внутри одного тарифа места могут принадлежать только одной квоте.

ZoneId

Для квот на событие с SVG схемой и посадочными местами отсутствует понятие зоны. Для таких квот значение атрибута zoneId не должно учитываться и как правило содержит значение 0.

Для квот на событие с SVG схемой без посадочных мест в атрибуте ZoneId задается идентификатор объекта на схеме к которому привязана квота. Если квота не привязана к объекту, то атрибут ZoneId будет иметь значение null.

Get tickets (only bought or booked) by event id

GET /events/{eventId}/tickets

Parameters

Response model

{
  "success": "bool",
  "data": {
    "items": [{
      "id": "int",
      "ticketTypeId": "int",
      "userOrderId": "int",
      "ticketTypeTitle": "string",
      "ticketTypeZoneId": "int",
      "number": "string",
      "price": "double",
      "discount": "double",
      "isUsed": "bool",
      "barcodeKey": "string",
      "seatNumber": "string",
      "seatName": "string",
      "rowName": "string",
      "participantName": "string",
	  "email": "string",
      "seatInfo": "string"
    }],
    "totalCount": "int"
  },
  "error": {
    "errorCode": "int",
    "message": "string",
    "requestId": "string"
  }
}

Attributes

Get orders by event id

GET /events/{eventId}/orders

Parameters

Response model

{
  "success": "bool",
  "data": {
    "items": [{
      "id": "int",
      "isPaid": "bool",
      "eventId": "int",
      "creationDate": "datetime",
      "ticketCount": "int",
      "baseAmount": "double",
      "amount": "double",
      "tickets": [{
        "id": "int",
        "ticketTypeId": "int",
        "userOrderId": "int",
        "ticketTypeTitle": "string",
        "ticketTypeZoneId": "int",
        "number": "string",
        "price": "double",
        "discount": "double",
        "isUsed": "bool",
        "barcodeKey": "string",
        "seatNumber": "string",
        "seatName": "string",
        "rowName": "string",
        "participantName": "string",
        "seatInfo": "string"
      }],
      "orderNumber": "string",
      "distributionType": "string",
      "paymentType": "int"
    }],
    "totalCount": "int"
  },
  "error": {
    "errorCode": "int",
    "message": "string",
    "requestId": "string"
  }
}

Attributes

Get place scheme by event id

GET /events/{eventId}/place-scheme

Parameters

Response model

{
  "success": "bool",
  "data": {
    "id": "int",
    "name": "string",
    "seatCount": "int",
    "zones": [{
      "id": "int",
      "name": "string",
      "withSeats": "bool",
      "rowCount": "int",
      "colCount": "int",
      "capacity": "int",
      "seats": [ {
        "number": "int",
        "rowName": "string",
        "seatName": "string",
        "exists": "bool"
      }]
    }],
    "image": "string",
    "version": "int"
  }
  "error": {
    "errorCode": "int",
    "message": "string",
    "requestId": "string"
  }
}

Вместимость зон

В связи с введением тарифов, стала актуальным вместимость зон - общее количество мест, которые могут быть реализованны для конктертной зоны со входными местами. За вместимость зон отвечает параметр Capacity.

Пример: Входная зона "Входная". Для данной зоны заведено два тарифа: "Взрослый"(100 шт.) и "Детский"(100 шт.). Вместимость зоны - 100. В таком случае, сумма по реализованным взрослым и детским билетам не должна превышать 100.

Attributes

EventProviders

Get event provider by id

GET /event-providers/{eventProviderId}

Parameters

Response model

{
  "success": "bool",
  "data": {
    "id": "int",
    "companyId": "int",
    "cityId": "int",
    "Name": "string",
    "Description": "string",
    "Email": "string",
    "AdditionalEmails": "string",
    "Phone": "string",
    "INN": "string",
    "AllowSendSoldTicketReportForPrevDay": "bool"
    "AllowSendSoldTicketReportForAllTime": "bool",
    "CreationdDate": "datetime",
    "UpdateDate": "datetime",
    "Deleted": "bool",
    "CommissionFeePercent": "decimal",
    "Address": "string",
    "ContractNumber": "string",
    "ContractDate": "datetime"
  },
  "error": {
    "errorCode": "int",
    "message": "string",
    "requestId": "string"
  }
}

Attributes

Get event providers by company

GET /company/{companyId}/event-providers

Parameters

Response model

{
  "success": "bool",
  "data": [{
    "id": "int",
    "companyId": "int",
    "cityId": "int",
    "Name": "string",
    "Description": "string",
    "Email": "string",
    "AdditionalEmails": "string",
    "Phone": "string",
    "INN": "string",
    "AllowSendSoldTicketReportForPrevDay": "bool"
    "AllowSendSoldTicketReportForAllTime": "bool",
    "CreationdDate": "datetime",
    "UpdateDate": "datetime",
    "Deleted": "bool",
    "CommissionFeePercent": "decimal",
    "Address": "string",
    "ContractNumber": "string",
    "ContractDate": "datetime"
  }]
  "error": {
    "errorCode": "int",
    "message": "string",
    "requestId": "string"
  }
}

Attributes

Group

Get events groups by company id

GET /hosts/{hostId}/groups

Parameters

Response model

{
  "success": "bool",
  "data": {
    "items": [{
      "id": "int",
      "name": "string",
      "hostId": "int",
      "ticketCount": "int"
    }],
    "totalCount": "int"
  },
  "error": {
    "errorCode": "int",
    "message": "string",
    "requestId": "string"
  }
}

Attributes

Orders

Резервирование мест для оплаты (создание заказа)

Данный метод создает заказ в режиме ожидания подтверждения оплаты. Пока заказ не будет успешно подтвержден, выбранные места нельзя считать закрепленными за агентом, а билеты нельзя выдавать покупателю. Максимальное время на подтверждение заказа составляет 20 минут, но может быть изменено в индивидуальном порядке.

POST /orders/reserve

Parameters

Body parameter

{
  "eventId": "int",
  "tickets": [{
    "ticketTypeId": "int",
    "seatNumber": "int",
    "participantName": "string",
    "externalUserId": "string"
  }],
  "email": "string",
  "partnerId": "int",
  "promocode": "string",
  "utmData": {
    "utmSource": "string",
    "utmMedium": "string",
    "utmTerm": "string",
    "utmContent": "string",
    "utmCampaign": "string",
    "utmUserId": "string"
  },
  "IsPaymentUsingPushkinCard": "bool"
}

Attributes

Response model

{
  "success": "bool",
  "data": {
    "order": {
      "id": "int",
      "isPaid": "bool",
      "eventId": "int",
      "creationDate": "datetime",
      "ticketCount": "int",
      "baseAmount": "double",
      "amount": "double",
      "tickets": [{
        "id": "int",
        "ticketTypeId": "int",
        "userOrderId": "int",
        "ticketTypeTitle": "string",
        "ticketTypeZoneId": "int",
        "number": "string",
        "price": "double",
        "discount": "double",
        "isUsed": "bool",
        "barcodeKey": "string",
        "seatNumber": "string",
        "seatName": "string",
        "rowName": "string",
        "participantName": "string",
        "seatInfo": "string"
      }],
      "orderNumber": "string",
      "distributionType": "string",
      "paymentType": "int",
      "customData": "string",
      "resolveDate" : "datetime",
      "status" : "string"
    }
  },
  "error": {
    "errorCode": "int",
    "message": "string",
    "requestId": "string"
  }
}

Attributes

Предварительный резерв мест

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

POST /orders/add_pre_reserved_seat

Parameters

Body parameter

{
  "eventId": "int",
  "ticketTypeId": "int",
  "seatNumber": "int",
  "timeToLive": "int"
}

Attributes

Response model

{
  "success": "bool",
  "error": {
    "errorCode": "int",
    "message": "string",
    "requestId": "string"
  }
}

Снятие предварительного резерва с места

POST /orders/remove_pre_reserved_seat

Parameters

Body parameter

{
  "eventId": "int",
  "ticketTypeId": "int",
  "seatNumber": "int"
}

Attributes

Response model

{
  "success": "bool",
  "error": {
    "errorCode": "int",
    "message": "string",
    "requestId": "string"
  }
}

Подтверждение оплаты заказы

После создания заказа необходимо подтвердить его оплату. Только после успешного подтверждения оплаты заказа билеты закрепляются за агентом, т.е. только после выполнения данной операции билеты можно передавать покупателю. До подтверждения заказа по тем или иным причинам заказ может быть удален и билеты могут быть перепроданы другими агентами или через другие каналы продаж. Подтверждение оплаты заказа может быть вызвано только над еще не подвержденным заказом, не был удален или не был возвращен.

POST /orders/approve

Body parameter

{
  "orderId": "int"
}

Parameters

Attributes

Response model

{
  "success": "bool",
  "error": {
    "errorCode": "int",
    "message": "string",
    "requestId": "string"
  }
}

Update order information

POST /orders/update

Body parameter

{
  "orderId": "int",
  "email": "string",
  "tickets": [{
	"id": "int",
	"participantName": "string",
	"externalUserId": "string"
  }],
  "isPaymentUsingPushkinCard": "bool"
}

Parameters

Attributes

Response model

{
  "success": "bool",
  "data": {
    "id": "int",
    "isPaid": "bool",
    "eventId": "int",
    "creationDate": "datetime",
    "ticketCount": "int",
    "baseAmount": "double",
    "amount": "double",
    "tickets": [{
      "id": "int",
      "ticketTypeId": "int",
      "userOrderId": "int",
      "ticketTypeTitle": "string",
      "ticketTypeZoneId": "int",
      "number": "string",
      "price": "double",
      "discount": "double",
      "isUsed": "bool",
      "barcodeKey": "string",
      "seatNumber": "string",
      "seatName": "string",
      "rowName": "string",
      "participantName": "string",
      "seatInfo": "string"
    }],
    "orderNumber": "string",
    "distributionType": "string",
    "paymentType": "int",
    "customData": "string",
    "resolveDate" : "datetime",
    "status" : "string"
  },
  "error": {
    "errorCode": "int",
    "message": "string",
    "requestId": "string"
  }
}

Attributes

Отмена заказа

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

POST /orders/cancel

Body parameter

{
  "orderId": "int"
}

Parameters

Response model

{
  "success": "bool",
  "error": {
    "errorCode": "int",
    "message": "string",
    "requestId": "string"
  }
}

Send order to customer's email

POST /orders/send

Body parameter

{
  "orderId": "int"
}

Parameters

Response model

{
  "success": "bool",
  "error": {
    "errorCode": "int",
    "message": "string",
    "requestId": "string"
  }
}

Возврат подтвержденного заказа

POST /orders/refund

Body parameter

{
  "userOrderId": "string",
  "ticketNumber": "string",
  "refundInitiator": "string",
  "comment": "string",
  "reason": "string",
  "RefundPenaltyPercent": "decimal"
}

Parameters

Attributes

Response model

{
  "success": "bool",
  "data": { 
    "refundId": "int",
    "companyId": "int",
    "refundedMoney": "decimal",
    "refundedUserCash": "decimal",
    "refundMethod": "int",
    "refundType": "int",
    "tickets": [{
      "ticketTypeId": "int",
      "seatNumber": "int",
      "seatInfo": {
        "rowName" : "string",
        "colName" : "string",
        "zoneName" : "string"
      },
      "price": "decimal"
    }],
    "ticketNumbers": "string"
  },
  "error": {
    "errorCode": "int",
    "message": "string",
    "requestId": "string"
  }
}

Attributes

Получение информации о заказе

GET /orders/{id}

Parameters

Response model

{
  "success": "bool",
  "data": {
    "id": "int",
    "isPaid": "bool",
    "eventId": "int",
    "creationDate": "datetime",
    "ticketCount": "int",
    "baseAmount": "double",
    "amount": "double",
    "tickets": [{
      "id": "int",
      "ticketTypeId": "int",
      "userOrderId": "int",
      "ticketTypeTitle": "string",
      "ticketTypeZoneId": "int",
      "number": "string",
      "price": "double",
      "discount": "double",
      "isUsed": "bool",
      "barcodeKey": "string",
      "seatNumber": "string",
      "seatName": "string",
      "rowName": "string",
      "participantName": "string",
      "seatInfo": "string"
    }],
    "orderNumber": "string",
    "distributionType": "string",
    "paymentType": "int",
    "customData": "string",
    "resolveDate" : "datetime",
    "status" : "string"
  },
  "error": {
    "errorCode": "int",
    "message": "string",
    "requestId": "string"
  }
}

Attributes

Получение расширенной информации о заказе организатора

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

GET /host/orders/{orderId}

Get only orders that created for host current account belongs to

Parameters

Response model

{
  "success": "bool",
  "data": {
    "order": {
      "id": "int",
      "paymentType": "string",
      "paymentDate": "datetime",
      "amount": "decimal",
      "promoCode": "string",
      "psOrderId": "string",
      "orderUserPhone": string
    },
    "user": {
      "email": "string"
    },
    "event": {
      "id": "int",
      "title": "string"
    },
    "partnerTrack": {
      "id": "int",
      "email": "string"
    },
    "tickets": [{
      "id": "int",
      "barcode": "string",
      "participantName": "string",
      "price": "decimal",
      "discount": "decimal",
      "type": {
        "id": "int",
        "title": "string",
        "zoneId": "int"
      }
    }]
  },
  "error": {
    "errorCode": "int",
    "message": "string",
    "requestId": "string"
  }
}

Attributes

Получение расширенной информации о заказах организатора

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

GET /host/orders

Parameters

Response model

{
  "success": "bool",
  "data": {
    "orders": [{
      "order": {
        "id": "int",
        "paymentType": "string",
        "paymentDate": "datetime",
        "amount": "decimal",
        "promoCode": "string",
        "psOrderId": "string",
        "orderUserPhone": "string"
      },
      "user": {
        "email": "string"
      },
      "event": {
        "id": "int",
        "title": "string"
      },
      "partnerTrack": {
        "id": "int",
        "email": "string"
      },
      "tickets": [{
        "id": "int",
        "barcode": "string",
        "participantName": "string",
        "price": "decimal",
        "discount": "decimal",
        "type": {
          "id": "int",
          "title": "string",
          "zoneId": "int"
        }
      }]
    }]
  },
  "error": {
    "errorCode": "int",
    "message": "string",
    "requestId": "string"
  }
}

Attributes

Tickets

Get ticket in pdf format

GET /tickets/{ticketId}/pdf

Responses

Returns pdf file

Places

Get events places

GET /places

Parameters

Response model

{
  "success": "bool",
  "data": {
    "items": [{
      "id": "int",
      "title": "string",
      "address": "string",
      "latitude": "double",
      "longitude": "double",
      "cityId": "int",
      "cityName": "string"
    }],
    "totalCount": "int"
  },
  "error": {
    "errorCode": "int",
    "message": "string",
    "requestId": "string"
  }
}

Attributes

Get event place by id

GET /places/{id}

Parameters

Response model

{
  "success": "bool",
  "data": {
    "id": "int",
    "title": "string",
    "address": "string",
    "latitude": "double",
    "longitude": "double",
    "cityId": "int",
    "cityName": "string"
  }
  "error": {
    "errorCode": "int",
    "message": "string",
    "requestId": "string"
  }
}

Attributes

Promocodes

Get Promocode

GET /promocodes

Parameters

Response model

{
  "success": "bool",
  "data": {
  "value": "double",
  "currency": "string",
  "isPercent": "bool",
  "validUntil": "datetime",
  "eventTitle": "string"
  },
  "error": {
    "errorCode": "int",
    "message": "string",
    "requestId": "string"
  }
}

Attributes

Schemes

Get place schema by id

GET /schemes/{id}

Parameters

Response model

{
  "success": "bool",
  "data": {
    "id": "int",
    "name": "string",
    "seatCount": "int",
    "zones": [{
      "id": "int",
      "name": "string",
      "withSeats": "bool",
      "rowCount": "int",
      "colCount": "int",
      "seats": [ {
        "number": "int",
        "rowName": "string",
        "seatName": "string",
        "exists": "bool"
      }]
    }],
    "image": "string",
    "version": "int"
  }
  "error": {
    "errorCode": "int",
    "message": "string",
    "requestId": "string"
  }
}

Attributes

Get place schema raw descriptor by id

GET /schemes/{id}/raw

Parameters

Response model

{
  "success": "bool",
  "data": {
    "id": "int",
    "descriptor": "string",
    "version": "int"
  }
  "error": {
    "errorCode": "int",
    "message": "string",
    "requestId": "string"
  }
}

Attributes

Поддерживаемые типы квот

Входные на событие без схемы

• событие не имеет схемы (атрибут placeSchemeId у события имеет значение null)
• квота не имеет посадочного места (атрибут withSeats у квоты имеет значение false)

Посадочные места без схемы

• событие не имеет схемы (атрибут placeSchemeId у события имеет значение null)
• квота имеет посадочные места (атрибут withSeats у квоты имеет значение true)

Входные на событие со схемой, с привязкой к объекту на схеме

• событие имеет схему (атрибут placeSchemeId у события имеет значение, отличное от null)
• квота не имеет посадочных мест (атрибут withSeats у квоты имеет значение false)
• для квоты указана зона (атрибут zoneId у квоты имеет значение отличное от null)

Входные на событие со схемой, без привязкй к объекту на схеме

• событие имеет схему (атрибут placeSchemeId у события имеет значение, отличное от null)
• квота не имеет посадочных мест (атрибут withSeats у квоты имеет значение false)
• для квоты не указана зона (атрибут zoneId у квоты имеет значение null)

Посадочные места со схемой

• событие имеет схему (атрибут placeSchemeId у события имеет значение, отличное от null)
• квота имеет посадочные места (атрибут withSeats у квоты имеет значение true)

Особенности работы с датами

Даты возвращаются в формате ISO 8601 YYYY-MM-DDThh:mm:ss.[.sss]+00:00 в UTC (значение +00:00 будет приходить у всех дат)

Пример 2018-12-31T23:59:59.000+00:00

Чтобы получить локальное время после запроса, необходимо конвертировать его в соответствии со значением поля gmtOffset из запроса GET /cities следующим образом: значение gmtOffset сконверировать в минуты (умножить на 60) и прибавить к заданному времени.

Для передачи времени в запросе, необходимо указывать его в формате ISO 8601 YYYY-MM-DDThh:mm:ssZ

Пример 2018-12-31T23:59:59Z

Возвраты

API поддерживает как возврат отдельного билета по его номеру так и заказа целиком. Возврат отдельного билета возможен только в том случае, если после возврата в заказе остается еще хотя бы один билет, в противном случае следует использовать возврат всего заказа.

Коды ошибок

• 2000 заказ уже был отменен (удален). Ошибка может возникать при попытке выполнить операцию над отмененным заказом, например при повторной попытке отменить уже отмененный заказ.
• 2013 заказ уже был оплачен (подтвержден). Ошибка может возникать при попытке подтвердить уже ранее подтвержденный заказ

Powered by Radario Platform