GET tour/main-references/:country

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

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"
         }
      }
   }
}

ITERIOS Travel API

Related Articles