Структура ответа#
Детальное описание структуры ответа от /avia/ticket_exchange.
Успешный ответ#
При успешном обмене API возвращает HTTP 200 и объект с новыми билетами.
Основная структура#
| Поле | Тип | Описание |
|---|
tickets | Ticket[] | Массив новых выписанных билетов |
Структура Ticket#
Каждый билет содержит:
| Поле | Тип | Описание |
|---|
id | string | Идентификатор билета |
number | string | Номер билета (без префикса vendor) |
vendor | string | Код BSP/ARC (префикс билета, например: “425”) |
passenger | TicketPassenger | Информация о пассажире |
Структура TicketPassenger#
| Поле | Тип | Описание |
|---|
id | string | Идентификатор пассажира в бронировании |
firstName | string | Имя пассажира |
lastName | string | Фамилия пассажира |
middleName | string | Отчество пассажира |
type | string | Тип пассажира (adt, chd, inf) |
title | string | Обращение (MR, MRS, MS и т.д.) |
Примеры ответов#
Успешный обмен одного пассажира#
1{
2 "tickets": [
3 {
4 "id": "ticket-id-1",
5 "number": "6170037302",
6 "vendor": "425",
7 "passenger": {
8 "id": "Pax-1",
9 "firstName": "IVAN",
10 "lastName": "KOZLOV",
11 "middleName": "PETROVICH",
12 "type": "adt",
13 "title": "MR"
14 }
15 },
16 {
17 "id": "ticket-id-2",
18 "number": "6160004938",
19 "vendor": "425",
20 "passenger": {
21 "id": "Pax-1",
22 "firstName": "IVAN",
23 "lastName": "KOZLOV",
24 "middleName": "PETROVICH",
25 "type": "adt",
26 "title": "MR"
27 }
28 }
29 ]
30}
Обмен с несколькими пассажирами#
1{
2 "tickets": [
3 {
4 "id": "ticket-id-1",
5 "number": "6170037302",
6 "vendor": "425",
7 "passenger": {
8 "id": "Pax-1",
9 "firstName": "IVAN",
10 "lastName": "KOZLOV",
11 "middleName": "PETROVICH",
12 "type": "adt",
13 "title": "MR"
14 }
15 },
16 {
17 "id": "ticket-id-2",
18 "number": "6170037303",
19 "vendor": "425",
20 "passenger": {
21 "id": "Pax-2",
22 "firstName": "MARIA",
23 "lastName": "KOZLOVA",
24 "middleName": "IVANOVNA",
25 "type": "adt",
26 "title": "MRS"
27 }
28 },
29 {
30 "id": "ticket-id-3",
31 "number": "6170037304",
32 "vendor": "425",
33 "passenger": {
34 "id": "Pax-3",
35 "firstName": "ANNA",
36 "lastName": "KOZLOVA",
37 "middleName": "IVANOVNA",
38 "type": "chd",
39 "title": "MISS"
40 }
41 }
42 ]
43}
Типичные ошибки#
| Код ошибки | Причина | Решение |
|---|
TICKET_NOT_FOUND | Билет не найден | Проверьте номер билета и bookingId |
EXCHANGE_NOT_ALLOWED | Обмен запрещен тарифом | Обмен невозможен по правилам тарифа |
INSUFFICIENT_BALANCE | Недостаточно средств | Пополните баланс на сумму обмена |
INVALID_EXCHANGE_DATA | Неверные данные обмена | Проверьте exchangeId и offerItemId из расчета |
OFFER_EXPIRED | Предложение истекло | Выполните новый расчет обмена |
Связанные операции#