Структура ответа#

Детальное описание структуры ответа от /api/avia/ticket_refund.

Успешный ответ#

При успешном оформлении возврата API возвращает HTTP 200 и пустой объект.

1{}

Ответ с ошибкой#

Если операция не может быть выполнена, API возвращает объект error:

Поле	Тип	Описание
`code`	string	Код ошибки (см. таблицу ниже)
`message`	string	Сообщение об ошибке
`description`	string	Дополнительное описание (опционально)
`errorId`	guid	Уникальный идентификатор ошибки

1{
2  "error": {
3    "code": "SUPPLIER_ERROR",
4    "message": "REFUND NOT PERMITTED - FARE RULES",
5    "description": null,
6    "errorId": "018c5f2e-9b3a-7f4d-8e2c-1a2b3c4d5e6f"
7  }
8}

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

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

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

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

Войдирование билета - отмена без штрафов
Информация о билете - проверка статуса билета
Правила тарифа - просмотр условий возврата