Города#

Получение справочника городов заданной страны.

Описание#

Эндпоинт: GET /api/dictionary/cities

Возвращает справочник городов заданной страны, используемый для расшифровки города расположения отеля в карточке отеля и в других данных отельного домена. Справочник не зависит от клиента или языка запроса, но фильтруется по стране — обязательный параметр countryId.

Использование#

Используйте этот запрос для получения списка городов конкретной страны, например для построения выбора города в интерфейсе поиска.

Основной сценарий#

1. Получите id нужной страны из справочника Страны
2. Отправьте запрос GET /api/dictionary/cities?countryId={countryId}
3. Получите список городов этой страны, отсортированный по id

Базовый пример#

1GET /api/dictionary/cities?countryId=1

Ответ содержит:

 1[
 2  {
 3    "id": 1,
 4    "nameRu": "Москва",
 5    "nameEn": "Moscow",
 6    "latitude": 55.7558,
 7    "longitude": 37.6173,
 8    "country": { "id": 1, "nameRu": "Россия", "nameEn": "Russia" }
 9  }
10]

Если countryId не соответствует ни одной существующей стране (включая countryId = 0) — возвращается 200 OK с пустым массивом, а не ошибка.

Детальная документация#

• Параметры запроса — полное описание параметров
• Структура ответа — детальное описание структуры ответа

Типичные ошибки#