API для использования в мобильных приложениях

Уважаемые партнёры! Обратите внимание, что по умолчанию установлено ограничение: 200 запросов в час. Если требуется обрабатывать больше запросов, напишите на support@travelpayouts.com. API доступа к данным без ограничения на количество запросов описано в статье Travelpayouts API доступа к данным для участников партнёрской программы.

Для создания собственного приложения с поиском авиабилетов рекомендуется использовать White Label App. 

Логотипы авиакомпаний

Получение логотипа авиакомпании в виде png-файла нужного размера.

Запрос

Метод: GET.

URL: http://ios.aviasales.ru/logos/{Density}/{IATA}.png

где {Density} — размер логотипа, {IATA} — IATA-код авиакомпании.

Например: http://ios.aviasales.ru/logos/nonretina/SU.png

{Density} может принимать следующие значения (в скобках указаны соответствующие максимальные размеры изображения в пикселях, в запросе их указывать не надо):

  • nonretina (66×22).
  • mdpi (88×29).
  • hdpi (132×44).
  • xhdpi (176×59).
  • xxhdpi (264×87).

Логотипы для retina-дисплеев iPhone находятся в папке hdpi.

Также логотипы авиакомпаний доступны по адресу: http://pics.avs.io/width/height/iata.png

где, width — ширина логотипа, height — высота логотипа, iata — иата-код авиакомпании. Размер может быть любым.

Пример: http://pics.avs.io/200/200/UN.png.

Карта цен. Поддерживаемые направления

Запрос

Метод: GET.

URL: http://map.aviasales.ru/supported_directions.json?origin_iata=LED&one_way=false&locale=ru

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

  • origin_iata — IATA-код аэропорта/города, из которого ищутся билеты. IATA-код указывается буквами верхнего регистра, например, MOW.
  • one_way — «true» для перелетов в одну сторону, «false» — для туда-обратно.
  • locale — язык поиска.

Ответ

{
   "origin":{
      "iata":"LED",
      "name":"Санкт-Петербург",
      "country":"RU",
      "coordinates":[30.315785,59.939039]
   },
   "directions":[{
      "direct":false,
      "iata":"AAL",
      "name":"Ольборг",
      "country":"DK",
      "coordinates":[9.917771,57.028811]
   },
   {
      "direct":true,
      "iata":"AAQ",
      "name":"Анапа",
      "country":"RU",
      "coordinates":[37.316666,44.9]
   }   
}

Параметры ответа

  • iata — IATA-код города отправления.
  • name — название города отправления.
  • country — буквенный код страны.
  • coordinates — координаты города отправления.
  • directions — информация о направлении.
    • direct — указывает на наличие перелётов без пересадок.
    • name — название города прибытия.
    • country — страна прибытия.
    • coordinates — координаты.

Карта цен. Цены

Запрос

Метод: GET.

URL: http://map.aviasales.ru/prices.json?origin_iata=LED&period=2021-12-01:season&direct=true&one_way=false&price=50000&no_visa=true&schengen=true&need_visa=true&locale=ru&min_trip_duration_in_days=13&max_trip_duration_in_days=15

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

  • origin_iata — IATA-код пункта отправления. IATA-код указывается буквами верхнего регистра, например, MOW.
  • period — период дат для поиска.
  • direct — указывает на наличие перелётов без пересадок.
  • one_way — «true» для перелетов в одну сторону, «false» — для туда-обратно.
  • price — максимальная цена билета.
  • no_visa — оплата не картой виза.
  • schengen — возможность поменять билет.
  • need_visa — требуется ли Visa.
  • locale — язык поиска.
  • min_trip_duration_in_days — минимальная продолжительность поездки (дней).
  • max_trip_duration_in_days — максимальная продолжительность поездки (дней).

Ответ

[{
    "show_to_affiliates":false,
    "trip_class":0,
    "destination":"PSA",
    "depart_date":"2021-05-30",
    "return_date":"2021-06-12",
    "number_of_changes":0,
    "value":43785,
    "created_at": 1407716354,
    "ttl": 1407889154,
    "distance":2247,
    "actual":false
},
{
    "show_to_affiliates":false,
    "trip_class":0,
    "destination":"PRG",
    "depart_date":"2021-03-01",
    "return_date":"2021-03-15",
    "number_of_changes":0,
    "value":12060,
    "created_at": 1407716354,
    "ttl": 1407889154,
    "distance":1485,
    "actual":true
}]

Параметры ответа

  • show_to_affiliates — true: цена доступна партнёрам, false: цена недоступна партнёрам.
  • trip_class — класс путешествия (1 — бизнес-класс, 0 — стандарт).
  • destination — IATA-код пункта назначения.
  • depart_date — дата отправления.
  • return_date — дата возвращения.
  • number_of_changes — количество пересадок.
  • value — стоимость перелёта.
  • created_at — время, когда цена была найдена (unix timestamp)*.
  • ttl — время, до которого действует предложение (unix timestamp)*.
  • distance — расстояние между пунктом отправления и прибытия.
  • actual — принимает значения 0 или 1. 0 — цена была найдена давно и могла устареть. 1 — цена была найдена недавно и является актуальной.

* — При переводе с помощью php date(«c», «значение UNIX-time») берется время сервера, и поэтому не учитываются часовые пояса. Поэтому требуется учитывать время сервера или принудительно приводить его к времени Гринвича с помощью функции date_default_timezone_set('GMT').

Перевод цены в другую валюту

Чтобы перевести цену из рублей в другую валюту, воспользуйтесь запросом:

http://yasen.aviasales.ru/adaptors/currency.json

В ответ вы получите значения курсов всех популярных валют к рублю на текущий момент.

{
    "cny":8.24394,
    "eur":57.1578,
    "mzn":1.49643,
    "nio":1.97342,
    "usd":51.1388,
    "hrk":7.48953
}