Параметры запроса#

Детальное описание всех параметров для запроса /api/avia/ticket_info.

Обязательные параметры#

Параметр	Тип	Описание
`bookingId`	guid	Идентификатор бронирования (формат UUID)
`ticketNumber`	string	Номер билета, не более 14 символов. Ожидаемый формат — `{vendor}-{number}` (например, `425-6170037281`), но кодом строго не проверяется

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

curl

1curl -X POST https://test.travelplatform.ru/api/avia/ticket_info \
2  -H "Authorization: Bearer YOUR_TOKEN" \
3  -H "Content-Type: application/json" \
4  -d '{
5    "bookingId": "019a0c82-5d2b-7a5e-84fe-56357a57df66",
6    "ticketNumber": "425-6170037281"
7  }'

Типичные ошибки#

Код ошибки	Причина	Решение
`BOOKING_NOT_FOUND`	Бронирование не найдено или не принадлежит клиенту	Проверьте `bookingId`
`CURRENCY_RATE_NOT_AVAILABLE`	Нет курса для конвертации сумм в валюту отображения	Повторите запрос позже
`VALIDATION_ERROR`	Ошибка валидации запроса (HTTP 400)	Проверьте обязательные поля и форматы значений
`NO_TARGETS`	Под запрос не нашлось ни одного поставщика: ни один не настроен либо все отсеяны на этапе подготовки запроса	Проверьте настройки офисов и пресетов в личном кабинете; при сохранении ошибки обратитесь в поддержку
`SUPPLIER_ERROR`	Поставщик вернул ошибку. Причина — текстом поставщика в поле `message`	Разберите `message`; при необходимости повторите запрос позже
`SYSTEM_ERROR`	Внутренняя ошибка Travel API	Повторите запрос позже; при повторении обратитесь в поддержку с `errorId`

Ошибки, пришедшие от GDS/NDC-поставщика, возвращаются под кодом SUPPLIER_ERROR: отдельного кода на каждую причину отказа Travel API не формирует, причина передаётся текстом поставщика в поле message. Не завязывайте логику на разбор message — его формат зависит от поставщика и не фиксирован.

Связанные операции#

Выписка билета - создание билета
Обмен билета - обмен билета на новый
Возврат билета - оформление возврата
Получение PNR - получение списка билетов