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

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

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

ПараметрТипОписание
bookingIdguidИдентификатор бронирования (формат UUID)
ticketNumberstringНомер билета для войдирования в формате {vendor}-{number} (например, 555-6170036872)

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

1curl -X POST https://test.travel-api.ru/avia/ticket_cancel \
2  -H "Authorization: Bearer YOUR_TOKEN" \
3  -H "Content-Type: application/json" \
4  -d '{
5    "bookingId": "019a0b6e-47eb-7157-926e-80691497ebfc",
6    "ticketNumber": "555-6170036872"
7  }'
 1var request = new TicketCancelRequest
 2{
 3    BookingId = "019a0b6e-47eb-7157-926e-80691497ebfc",
 4    TicketNumber = "555-6170036872"
 5};
 6
 7var response = await httpClient.PostAsJsonAsync(
 8    "https://test.travel-api.ru/avia/ticket_cancel",
 9    request
10);
11
12if (response.IsSuccessStatusCode)
13{
14    var content = await response.Content.ReadAsStringAsync();
15
16    // Пустой ответ {} означает успех
17    if (content.Trim() == "{}")
18    {
19        Console.WriteLine("Билет успешно войдирован");
20    }
21}

Процесс войдирования#

Отмена выписанного билета без штрафов в день выписки.

Действия:

  1. Проверить, что билет выписан сегодня (в пределах суток по времени GDS)
  2. Отправить запрос на войдирование
  3. Получить подтверждение и автоматический возврат средств

Альтернатива: Если прошло более суток - использовать возврат билета (со штрафами по правилам тарифа).

sequenceDiagram
    participant Client
    participant API

    Note over Client,API: В день выписки

    Client->>API: POST /avia/ticket_cancel<br/>{bookingId, ticketNumber}
    API-->>Client: Войдирование успешно<br/>(полный возврат средств)

    Note over Client,API: Если прошло более суток:<br/>используйте /avia/ticket_refund<br/>(возврат со штрафами)