getFlightData

URL
/v1/getFlightData
Метод
POST
Кодировка
UTF-8
Заголовок запроса
Заголовок X-Auth должен быть следующего содержания: {partnerCode}-SHA256({body}{key}), где {partnerCode} это ваш код партнера, {body} это тело POST-запроса, {key} это пароль партнера, SHA256() это стандартная функция получения хэша пример: 5937-151c7359de1b9590f29c6877675645de85a196c627fd43ec6e460d65f13ce590
Запрос
Поле
Тип
Обязат.
Макс. длина
Описание
externalNumber
String
1
100
Внешний номер запроса. Используется в дальнейшем в колбэках для обозначения, к какому запросу относится колбэк.
flightNumber
String
1
10
Номер рейса в формате XX-XXXX. Два символа до дефиса От 1 до 4 символов после дефиса
departureDate
LocalDateTime
1
20
Дата и время вылета по местному времени Независимо от указанного часового пояса, дата будет интерпретироваться как локальная дата аэропорта вылета рейса/первого сегмента рейса
responseType
String
1
1
Тип ответа. Возможные значения 1 или 2. В данный момент разницы между ними нет.
departureAirportCode
String
0
3
Код IATA аэропорта вылета. Поля departureAirportCode и arrivalAirportCode используются чтобы уточнить конкретный полетный сегмент для рейсов с несколькими сегментами в течение одного календарного дня.
arrivalAirportCode
String
0
3
Код IATA аэропорта прилета
Пример запроса
а) Рейс без пересадок:
{
    "flightNumber":"S7-5316",
    "departureDate":"2020-05-01T15:25:00Z",
    "responseType":"1",
    "externalNumber":"9BDDEB55-C792-EA11-B80A-8030E0409014"
}
б) Рейс с 1 пересадкой, отслеживаются оба сегмента (обе части рейса):
{
    "flightNumber":"PC-1519",
    "departureDate":"2020-05-01T15:25:00Z",
    "responseType":"1",
    "externalNumber":"9BDDEB55-C792-EA11-B80A-8030E0409014"
}
в) Рейс с 1 пересадкой, отслеживается один сегмент (одна часть рейса):
{
    "flightNumber":"PC-1519",
    "departureDate":"2020-05-01T15:25:00Z",
    "responseType":"1",
    "departureAirportCode":"SAW",
    "arrivalAirportCode":"ADB",
    "externalNumber":"9BDDEB55-C792-EA11-B80A-8030E0409014"
}
Успешный ответ
Поле
Тип
Обязат.
Макс. длина
Описание
id
String
1
36
Номер запроса
{"id": "5cc01933dc895a25d4a627ea"}
Ответ в случае ошибки
Поле
Тип
Обязат.
Макс. длина
Описание
code
String
1
20
Код ошибки
message
String
1
100
Описание ошибки
{"message":"Duplicate key: AAA-BBB","code":"ERR_CONFLICT"}
Пример колбэка с данными
{
        "id": "61f65f4964a3d00b0e788b6d",
        "externalNumber": "7AE4935E-B181-EC11-B80F-8030E0409014",
        "status": "OK",
        "errorCode": "null",
        "errorText": "null",
        "flightData":
        {
            "flightNumber": "SU-1731",
            "carrierCode": "SU",
            "scheduledDepartureDate": "2022-08-04T11:30:00+05:00",
            "scheduledArrivalDate": "2022-08-04T12:15:00+03:00",
            "expectedDepartureDate": "2022-08-04T11:35:00+03:00",
            "expectedArrivalDate": "2022-08-04T11:46:00+03:00",
            "actualDepartureDate": "2022-08-04T11:35:00+05:00",
            "actualArrivalDate": "2022-08-04T11:46:00+04:00",
            "departureAirportCode": "SVX",
            "arrivalAirportCode": "KUF",
            "baggageBeltNumber": "5",
            "departureTerminal": "A",
            "arrivalTerminal": "B",
            "aircraftName": "Boeing 777-300ER",
            "flightStatus": "L",
            "departureGate": "16",
            "arrivalGate": "1",
            "departureAirportName": "Ekaterinburg International Airport",
            "arrivalAirportName": "Samara International Airport",
            "actualCarrierName": "null",
            "divertedAirportCode": "GOJ",
            "divertedAirportName": "Nizhny Novgorod International Airpoirt",
            "checkInDesk": "14, 15, 16",
            "checkIn": false,
            "checkInStart": "2022-08-04T08:32:00+05:00",
            "checkInEnd": "2022-08-04T10:50:00+05:00",
            "boardingStart": "2022-08-04T10:54:00+05:00",
            "boardingEnd": "2022-08-04T11:05:00+05:00",
            "commonStatus": "Departed"
        }
    }
В случае успеха в ответе от партнёра ожидаем статус 200, в теле: application/json; charset=utf-8, пример месседжа {"result":"success"} или {"result":"OK"}.