4. Города

Метод API для получения данных по городам:

https://experience.tripster.ru/api/partners/<partner_name>/cities/

По одному городу:

https://experience.tripster.ru/api/partners/<partner_name>/cities/<ID>

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

Фильтры
- updated_after - последнее обновление
- iata фильтр по IATA коду города. Например, iata=TBS найдет Тбилиси.
- name_ru фильтр по названию города на русском
- name_en фильтры по названию города на английском
- country фильтр по ID страны
- country__name_ru фильтр по названию страны на русском
- country__name_en фильтр по названию страны на английском
Стандартные параметры format и page_size, прочитайте про постраничную загрузку данных

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

Список всех городов:

https://experience.tripster.ru/api/partners/<partner_name>/cities/

Данные по конкретному городу.

Параметр <ID>:

https://experience.tripster.ru/api/partners/<partner_name>/cities/238/

Список городов с фильтрацией по названию на русском языке.

Фильтр name_ru:

https://experience.tripster.ru/api/partners/<partner_name>/cities/?name_ru=Санкт-Петербург

Список городов с фильтрацией по названию страны на английском языке.

Фильтр name_en:

https://experience.tripster.ru/api/partners/<partner_name>/cities/?name_en=Saint Petersburg

Структура ответа

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

{

    "count": 426,

    "next": "https://experience.tripster.ru/api/partners/<partner_name>/cities/?page=2",

    "previous": null,

    "results": [

        {

            "id": 60,

            "name_ru": "Тбилиси",

            "name_en": "Tbilisi",

            "iata": "TBS",

            "country": {

                "id": 136,

                "name_ru": "Грузия",

                "name_en": "Georgia",

                "currency": "EUR",

                "in_obj_phrase": "в Грузии",

                "across_obj_phrase": "по Грузии",

                "experience_count": 287,

                "tours_count": 15,

                "url": " ",

                "region": "CIS"

            },

            "experience_count": 230,

            "in_obj_phrase": "в Тбилиси",

            "from_obj_phrase": "из Тбилиси",

            "name_prepositional": "Тбилиси",

            "url": "https://experience.tripster.ru/experience/Tbilisi/",

            "image": {

                "thumbnail": "https://554a875a-71dc-4f5f-b6bf-ae8967f137d5.selcdn.net/photos/e82d4032-68a7-4e2a-8644-35017cc40326.jpg",

                "cover": "https://554a875a-71dc-4f5f-b6bf-ae8967f137d5.selcdn.net/photos/a2998b43-5585-4347-9fa4-88d9d646b011.jpg"

            },

            "utc_offset": 14400.0,

"guides_count": 143,

"slug": "Tbilisi"

        }

    ]

}

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

Параметр	Описание	Тип
id	ID города в Трипстере	Число
name_ru	Название на русском	Строка
name_en	Название на английском	Строка
iata	IATA-код города	Строка
country	Объект с данными о стране, в которой расположен город	Объект
experience_count	Количество экскурсий в городе	Число
in_obj_phrase	Название города с предлогом в/во/на для фразы "Экскурсии в городе"	Строка
from_obj_phrase	Название города с предлогом для фразы “из города”	Строка
name_prepositional	Название города в предложном падеже без предлога (в городе)	Строка
url	Ссылка на страницу города на Трипстере	Строка
image.thumbnail	Ссылка на картинку-превьюшку города размером 384x289px	Строка
image.cover	Ссылка на картинку-превьюшку города размером 1348x260px	Строка
guides_count	Количество гидов, чьи экскурсии представлены в городе	Число
utc_offset	Смещение по Гринвичу в секундах	Число
slug	Строковый индентификатор города	Строка