1. Travelpayouts - партнёрская сеть для туристического трафика
  2. Работа с API
  3. Архив

Старая версия API доступа к данным (более не поддерживается)

Уважаемые партнеры! Данная документации более не актуальна, в связи с изменением адреса API. Актуальная документация находится здесь.

 

Для получения токена (token) к АПИ доступа к данным зайдите на страницу http://www.travelpayouts.com/developers/api.

Для доступа к API вам необходимо передавать свой токен в заголовке X-Access-Token или параметром token.

Даты принимаются в форматах YYYY-MM и YYYY-MM-DD

Ответ от сервера всегда отдается в формате json и имеет следующую структуру:

success — принимает значения true для успешного запроса и false в случае ошибки

data — результат выполнения запроса, в случае ошибки будет иметь значение null

error — краткое описание ошибки, помешавшей выполнить запрос, в случае успешного запроса будет иметь значение null

Даты и время в UTC и отформатированы по стандарту ISO 8601. Цены указаны в рублях и актуальны на момент попадания билета в результаты поиска. Не рекомендуется использовать цены, срок актуальности которых истек (примерная дата указывается в значении параметра expires_at).

Важно!

Настоятельно рекомендуется получать данные сжатыми в gzip, это существенно сократит время получения ответа. Чтобы получить данные в сжатом виде, необходимо передать заголовок Accept-Encoding: gzip, deflate.

 

Для получения доступа к API поиска авиабилетов и отелей необходимо оставить заявку.

Самые дешевые авиабилеты

 

Уважаемые партнеры! Данная документации более не актуальна, в связи с изменением адреса API. Актуальная документация находится здесь.

 

http://api.aviasales.ru/v1/cities/{origin}/directions/{destination}/prices.json?{departure_at,return_at,currency,token} – возвращает самые дешевые билеты без пересадок, а так же с 1 и 2 пересадками для выбранного направления с фильтрами по датам вылета и возвращения.

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

  • origin – IATA код города вылета
  • destination – IATA код города назначения (укажите "-" для любых направлений)
  • departure_at(не обязательно) – День или месяц вылета (yyyy-mm-dd или yyyy-mm)
  • return_at (не обязательно) – День или месяц возвращения (yyyy-mm-dd или yyyy-mm)
  • currency – Валюта ответа (USD, EUR, RUB)
  • token – Индивидуальный токен доступа

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

http://api.aviasales.ru/v1/cities/BER/directions/BCN/prices.json?departure_at=2014-03&return_at=2014-04&currency=USD

Обратите внимание! В запросе могут быть указаны старые даты. А значит в результате его ошибки не будет, но и  данных никаких не вернется.

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

{
   "success": true,
   "data": {
      "BCN": {
         "0": {
            "price": 211,
            "airline": "U2",
            "flight_number": 4533,
            "departure_at": "2014-08-05T15:50:00Z",
            "return_at": "2014-08-21T15:10:00Z",
            "expires_at": "2014-03-02T15:59:09Z"
         },
         "1": {
            "price": 228,
            "airline": "9B",
            "flight_number": 3958,
            "departure_at": "2014-05-23T12:50:00Z",
            "return_at": "2014-05-28T17:10:00Z",
            "expires_at": "2014-03-02T16:56:35Z"
         },
         "2": {
            "price": 408,
            "airline": "KL",
            "flight_number": 3758,
            "departure_at": "2014-05-24T06:50:00Z",
            "return_at": "2014-05-28T08:50:00Z",
            "expires_at": "2014-03-02T12:56:35Z"
         }
      }
   },
   "error": null,"currency":"usd"
}

 

Описание ответа

  • 0, 1, 2 – Количество пересадок
  • price – Цена билета (в заданной валюте, параметр currency)
  • airline – IATA код авиакомпании, выполняющей перелет
  • flight_number – Номер рейса
  • departure_at – Дата вылета
  • return_at – Дата возвращения
  • expires_at – Дата истечения актуальности найденной цены (UTC+0)

Билеты без пересадок

 

Уважаемые партнеры! Данная документации более не актуальна, в связи с изменением адреса API. Актуальная документация находится здесь.

 

http://api.aviasales.ru/v1/cities/{origin}/directions/{destination}/prices/direct.json?{departure_at,return_at,currency,token} – возвращает самый дешевый билет без пересадок для выбранного направления с фильтрами по датам вылета и возвращения.

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

  • origin – IATA код города вылета
  • destination – IATA код города назначения (укажите "-" для любых направлений)
  • departure_at(не обязательно) – День или месяц вылета (yyyy-mm-dd или yyyy-mm)
  • return_at (не обязательно) – День или месяц возвращения (yyyy-mm-dd или yyyy-mm)
  • currency – Валюта ответа (USD, EUR, RUB)
  • token – Индивидуальный токен доступа

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

http://api.aviasales.ru/v1/cities/BER/directions/PAR/prices/direct.json?departure_at=2014-10&return_at=2014-10&currency=USD

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

{
   "success": true,
   "data": {
      "PAR": {
         "0": {
            "price": 104,
            "airline": "AB",
            "flight_number": 8154,
            "departure_at": "2014-10-01T06:10:00Z",
            "return_at": "2014-10-06T10:25:00",
            "expires_at": "2014-03-06T18:10:19Z"
         }
      }
   },
   "error": null,"currency":"usd"
}

Описание ответа

  • price – Цена билета (в заданной валюте)
  • airline – IATA код авиакомпании, выполняющей перелет
  • flight_number – Номер рейса
  • departure_at – Дата вылета
  • return_at – Дата возвращения
  • expires_at – Дата истечения актуальности найденной цены (UTC+0)

Билеты за каждый день месяца

 

Уважаемые партнеры! Данная документации более не актуальна, в связи с изменением адреса API. Актуальная документация находится здесь.

 

http://api.aviasales.ru/v1/cities/{origin}/directions/{destination}/prices/calendar.json?{departure_at,return_at,calendar_type,length,currency,token} – возвращает самые дешевые билеты без пересадок, а так же с 1 и 2 пересадками для выбранного направления для каждого дня выбранного месяца.

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

  • origin – IATA код города вылета
  • destination – IATA код города назначения
  • departure_at – День или месяц вылета (yyyy-mm-dd или yyyy-mm)
  • return_at (не обязательно) – День или месяц возвращения (yyyy-mm-dd или yyyy-mm)
  • calendar_type – поле, по которому будет строиться календарь. Одно из двух значений: departure_date или return_date
  • length (optional) – Длительность пребывания в городе назначения
  • currency – Валюта ответа (USD, EUR, RUB)
  • token – Индивидуальный токен доступа

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

http://api.aviasales.ru/v1/cities/MOW/directions/BCN/prices/calendar.json?departure_at=2013-03&calendar_type=departure_date&length=20&currency=RUB

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

{
   "success": true,
   "data": {
      "2013-03-01": {
         "origin": "MOW",
         "destination": "BCN",
         "price": 19353,
         "transfers": 1,
         "airline": "LH",
         "flight_number": 1447,
         "departure_at": "2013-03-01T17:35:00Z",
         "return_at": "2013-03-21T15:50:00Z",
         "expires_at": "2013-03-02T10:46:48Z"
      },
      "2013-03-02": {
         "origin": "MOW",
         "destination": "BCN",
         "price": 16561,
         "transfers": 1,
         "airline": "TK",
         "flight_number": 418,
         "departure_at": "2013-03-02T17:40:00Z",
         "return_at": "2013-03-22T16:35:00Z",
         "expires_at": "2013-03-02T10:46:48Z"
      },
      ...
     "2013-03-31": {
         "origin": "MOW",
         "destination": "BCN",
         "price": 14691,
         "transfers": 1,
         "airline": "AY",
         "flight_number": 154,
         "departure_at": "2013-03-31T13:50:00Z",
         "return_at": "2013-04-20T12:05:00Z",
         "expires_at": "2013-03-02T16:48:53Z"
      }
   },
   "error": null,"currency":"rub"
}

Описание ответа

  • origin – IATA код города вылета
  • destination – IATA код города назначения
  • price – Цена билета в заданной валюте
  • transfers – Количество пересадок
  • airline – IATA код авиакомпании
  • flight_number – Номер рейса
  • departure_at – Дата вылета
  • return_at – Дата возвращения
  • expires_at – Срок истечения актуальности цены (UTC+0)

Популярные направления авиакомпании

 

Уважаемые партнеры! Данная документации более не актуальна, в связи с изменением адреса API. Актуальная документация находится здесь.

 

http://api.aviasales.ru/v1/airlines/{airline}/directions.json?{limit,token} – возвращает направления, по которым авиакомпания осуществляет перелеты, отсортированные по популярности.

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

  • airline – IATA код авиакомпании
  • limit (не обязательно) – Количество маршрутов (по умолчанию 100)
  • token – Индивидуальный токен доступа

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

http://api.aviasales.ru/v1/airlines/KL/directions.json?limit=10

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

{
   "success": true,
   "data": {
      "MOW-BKK": 187491,
      "MOW-BCN": 113764,
      "MOW-PAR": 91889,
      "MOW-NYC": 77417,
      "MOW-PRG": 71449,
      "MOW-ROM": 67190,
      "MOW-TLV": 62132,
      "MOW-HKT": 58549,
      "MOW-GOI": 47341,
      "MOW-IST": 45553
   },
   "error": null
}

Описание ответа

Возвращает список популярных направлений авиакомпании, отсортированный по популярности, количество направлений – не более заданного лимита (limit).

Данные о странах, городах, аэропортах, авиакомпаниях, самолетах в json формате

Данные о странах

Запрос http://api.travelpayouts.com/data/countries.json возвращает файл со списком стран из базы данных. 

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

[{
"code":"NC",
"name":"New Caledonia",
"currency":"XPF",
"name_translations":{
"de":"Neukaledonien",
"en":"New Caledonia",
"zh-CN":"新喀里多尼亚",
"tr":"Yeni Kaledonya",
"ru":"Новая Каледония",
"fr":"Nouvelle-Calédonie",
"es":"Nueva Caledonia",
"it":"Nuova Caledonia",
"th":"ประเทศนิวแคลิโดเนีย"
}},
{
"code":"MT",
"name":"Malta",
"currency":"EUR",
"name_translations":{
"de":"Malta",
"en":"Malta",
"zh-CN":"马耳他",
"tr":"Malta",
"ru":"Мальта",
"fr":"Malte",
"es":"Malta",
"it":"Malta",
"th":"ประเทศมอลตา"
}}
]

Описание ответа

  • code - IATA код страны.
  • name - название страны.
  • currency - валюта страны.
  • name_translations - название страны на различных языках.

Данные о городах

Запрос http://api.travelpayouts.com/data/cities.json возвращает файл со списком городов из базы данных. 

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

[{
"code":"SCE",
"name":"State College",
"coordinates":{
"lon":-77.84823,
"lat":40.85372
},
"time_zone":"America/New_York",
"name_translations":{
"de":"State College",
"en":"State College",
"zh-CN":"大学城",
"tr":"State College",
"ru":"Стейт Колледж",
"it":"State College",
"es":"State College",
"fr":"State College",
"th":"สเตทคอลเลจ"
},
"country_code":"US"
},
{
"code":"AAB",
"name":"Arrabury",
"coordinates":{
"lon":141.04167,
"lat":-26.7
},
"time_zone":"Australia/Brisbane",
"name_translations":{
"de":"Arrabury",
"en":"Arrabury",
"zh-CN":"阿拉伯里",
"ru":"Аррабури"
},
"country_code":"AU"
}]

Описание ответа

  • code - IATA код города.
  • name - название города.
  • coordinates - координаты города.
  • time_zone - часовой пояс относительно гринвича.
  • name_translations - название города на разных языках.
  • country_code - IATA код страны, в которой находится город.

Данные об аэропортах

Запрос http://api.travelpayouts.com/data/airports.json возвращает файл со списком аэропортов из базы данных. 

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

[{
"code":"MQP",
"name":"Kruger Mpumalanga International Airport",
"coordinates":{
"lon":31.098131,
"lat":-25.384947
},
"time_zone":"Africa/Johannesburg",
"name_translations":{
"de":"Nelspruit",
"en":"Kruger Mpumalanga International Airport",
"tr":"International Airport",
"it":"Kruger Mpumalanga",
"fr":"Kruger Mpumalanga",
"es":"Kruger Mpumalanga",
"th":"สนามบินเนลสปรุต"
},
"country_code":"ZA",
"city_code":"NLP"
}]

Описание ответа

  • code - iata-код аэропорта.
  • name - название аэропорта.
  • coordinates - координаты аэропорта.
  • time_zone - часовой пояс относительно гринвича.
  • name_translations - название аэропорта на разных языках.
  • country_code - iata-код страны.
  • city_code - iata-код города.

Данные об авиакомпаниях

Запрос http://api.travelpayouts.com/data/airlines.json возвращает файл со списком авиакомпаний из базы данных. 

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

[{
"name":"Private flight",
"alias":null,
"iata":null,
"icao":null,
"callsign":null,
"country":null,
"is_active":true
},
{
"name":"135 Airways",
"alias":null,
"iata":null,
"icao":"GNL",
"callsign":"GENERAL",
"country":"United States",
"is_active":false
}]

Описание ответа

  • name - название авиакомпании.
  • alias - название альянса (если авиакомпания входит в какой-либо альянс).
  • iata - iata-код авиакомпании.
  • icao - icao-код авиакомпании.
  • callsign - позывной авиакомпании.
  • country - страна регистрации авиакомпании.
  • is_active - true: компания работает, false: нет.

Данные об альянсах

Запрос http://api.travelpayouts.com/data/airlines_alliances.json возвращает файл со списком альянсов из базы данных. 

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

[{
"name":"Star Alliance",
"airlines":["A3","AC","AV","CA","CM","ET","JJ","JP","KF","LH","LO","LX","MS","NH","NZ","OS","OU","OZ","PZ","SA","SK","SN","SQ","TA","TG","TK","TP","UA","US"]}]

Описание ответа

  • name - название альянса.
  • airlines - коды компаний, входящих в альянс.

Данные о самолетах

Запрос http://api.travelpayouts.com/data/planes.json возвращает файл со списком самолетов из базы данных. 

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

[{
"code":"100",
"name":"Fokker 100"
},
{
"code":"141",
"name":"British Aerospace BAe 146-100"
},
{
"code":"142",
"name":"British Aerospace BAe 146-200"
},
{
"code":"143",
"name":"British Aerospace BAe 146-300"
}]

Описание ответа

  • code - iata-код самолета.
  • name - название самолета.

Данные о маршрутах

Запрос http://api.travelpayouts.com/data/routes.json возвращает файл со списком маршрутов из базы данных. 

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

[{
"airline_iata":"2B",
"airline_icao":null,
"departure_airport_iata":"AER",
"departure_airport_icao":null,
"arrival_airport_iata":"DME",
"arrival_airport_icao":null,
"codeshare":false,
"transfers":0,
"planes":[
"CR2"
]
},
{
"airline_iata":"2B",
"airline_icao":null,
"departure_airport_iata":"ASF",
"departure_airport_icao":null,
"arrival_airport_iata":"LED",
"arrival_airport_icao":null,
"codeshare":false,
"transfers":0,
"planes":[
"CR2"

Описание ответа

  • airline_iata - IATA-код авиакомпании.
  • airline_icao - ICAO-код авиакомпании.
  • departure_airport_iata - IATA-код аэропорта отправления.
  • departure_airport_icao - ICAO-код аэропорта отправления.
  • arrival_airport_iata - IATA-код аэропорта прибытия.
  • arrival_airport_icao - ICAO-код аэропорта прибытия.
  • codeshare - показывает осуществляет ли рейс та же компания, что продает билет.
  • transfers - количество пересадок.
  • planes - IATA-код самолета.

Была ли эта статья полезной?

Еще есть вопросы? Отправить запрос

Похожие статьи