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 | Строковый индентификатор города | Строка |