Мы собрали для вас информацию об API для использования в мобильных приложениях в этой статье.
Уважаемые партнёры! Обратите внимание, что по умолчанию установлено ограничение: 200 запросов в час. Если требуется обрабатывать больше запросов, напишите на support@travelpayouts.com. API доступа к данным без ограничения на количество запросов описано в статье Travelpayouts API доступа к данным для участников партнёрской программы.
Для создания собственного приложения с поиском авиабилетов рекомендуется использовать Travelpayouts Travel 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 }