ITERIOS Travel API

GET tour/main-references/:country

47 views 02.03.2019 0

Метод для получения основных справочников для формы поиска.


GET tour/main-references
GET tour/main-references/:country

где :country — ISO alpha_2 код страны, для которой отобрать доступные города вылета. Если не передан, то будет возвращён полный набор данных, включая все города вылета.

Принимает GET параметры:

Параметр Тип Описание
lang string Язык на котором вернуть результаты. По умолчанию используется ‘en’. Если для запрошенного языка нет данных будет использоваться язык по умолчанию.
demo bool Передав этот параметр, можно получить все справочники, включая справочники из этапа «data mapping».

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

curl -i -H 'X-Api-Key: some_key_value' https://itapi.iterios.com/api/v1/tour/main-references/tr?lang=ru&demo=1

Описание возвращаемых данных
Возвращает в ответе под ключом data следующие данные:

Параметр Тип Описание
operators object Объект с информацией об операторах, доступных для поиска туров. Поля объекта соответствуют значению поля code для каждого оператора. Каждый элемент содержит такие ключи:

Параметр Тип Описание
id (deprecated) integer Идентификатор оператора
name* string Наименование оператора
code* string Код оператора, используемый в системе
countries object Объект с информацией о странах, доступных для поиска туров. Поля объекта соответствуют значению поля iso_alpha_2 для каждой страны. Каждый элемент содержит такие ключи:

Параметр Тип Описание
id (deprecated) int Идентификатор страны
name* string Название страны
iso_alpha_2* string Код страны, используемый в системе
ico* object Объект с ключами 1×1 и 4×3, содержащими ссылки на svg флаги стран в формате 1:1 и 4:3 соответственно
dep_cities object Объект с информацией о городах отправления. Поля объекта соответствуют значению поля id для каждого города. Каждый элемент содержит такие ключи:

Параметр Тип Описание
id* int Идентификатор города отправления
name* string Название города
country* object Объект, содержащий информацию о стране, в которой находится город. В объекте такие поля: id, name, iso_aplha_2, описание которых предоставлено выше. Обратите внимание, что в объекте countries может не быть страны, в которой находится город отправления.
hotel_categories object Объект с информацией о категориях отеля. Поля объекта соответствуют значению поля name для каждой категории отеля. Каждый элемент содержит такие ключи:

Параметр Тип Описание
id (deprecated) int Идентификатор категории
name* string Название категории
meals object Объект с информацией о питаниях. Поля объекта соответствуют значению поля name для каждого питания. Каждый элемент содержит такие ключи:

Параметр Тип Описание
id (deprecated) int Идентификатор питания
name* string Название питания
currencies object Объект с информацией о валютах. Поля объекта соответствуют значению поля iso_code для каждой валюты. Каждый элемент содержит такие ключи:

Параметр Тип Описание
id (deprecated) int Идентификатор валюты
name* string Название валюты
iso_code* string ISO код валюты

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

{
   "data": {
      "operators": {
         "abktourismkz": {
            "id": 30,
            "name": "Abktourism",
            "code": "abktourismkz"
         },
         "agriahitua": {
            "id": 26,
            "name": "AdriaHit",
            "code": "agriahitua"
         },
         "alfua": {
            "id": 24,
            "name": "ALF",
            "code": "alfua"
         }
      },
      "countries": {
         "BG": {
            "id": 22,
            "iso_alpha_2": "BG",
            "name": "Bulgaria",
            "ico": {
               "1x1": "https://static.iterios.com/country/flags/1x1/bg.svg",
               "4x3": "https://static.iterios.com/country/flags/4x3/bg.svg"
            }
         }
      },
      "dep_cities": {
         "44135": {
            "id": 44135,
            "name": "Kiev",
            "country": {
               "id": 231,
               "name": "Ukraine"
            }
         },
         "42857": {
            "id": 42857,
            "name": "Dnipro",
            "country": {
               "id": 231,
               "name": "Ukraine"
            }
         }
      },
      "hotel_categories": {
         "5": {
            "id": 5,
            "name": "5"
         },
         "2": {
            "id": 2,
            "name": "2"
         }
      },
      "meals": {
         "RO": {
            "id": 5,
            "name": "RO"
         },
         "BB": {
            "id": 2,
            "name": "BB"
         }
      },
      "currencies": {
         "UAH": {
            "id": 26,
            "name": "Ukrainian Hrivna",
            "iso_code": "UAH"
         },
         "USD": {
            "id": 28,
            "name": "US Dollar",
            "iso_code": "USD"
         }
      }
   }
}

Was this helpful?