5. Рубрики
Метод API для получения данных по рубрикам:
https://experience.tripster.ru/api/partners/<partner_name>/citytags/
Параметры запроса
Фильтры
updated_after - последнее обновление
city фильтр по ID города
city__iata фильтр по ATA коду города
city__name_ru фильтр по названию города на русском
city__name_en фильтр по названию города на английском
city__slug фильтр по строковому идентификатору города
Стандартные параметры format и page_size. Рубрик в городе не бывает много, так что их можно всегда выгрузить одним запросом с page_size=100.
Сортировки
experience_count по количеству экскурсий в рубрике
popularity по популярности рубрики (поумолчанию -popularity)
Примеры запросов
Рубрики в Санкт-Петербурге.
Фильтр city:
https://experience.tripster.ru/api/partners/<partner_name>/citytags/?city=144
Фильтр city__name_ru:
https://experience.tripster.ru/api/partners/<partner_name>/citytags/?city__name_ru=Санкт-Петербург
Фильтр city__iata:
https://experience.tripster.ru/api/partners/<partner_name>/citytags/?city__iata=LED
Структура ответа
Пример ответа API
{
"count": 1,
"next": null,
"previous": null,
"results": [
{
"id": 913,
"citytag_id": 20252,
"name": "Коммуналки",
"slug": "kommunalki",
"url": " ",
"is_hidden": true,
"experience_count": 5,
"review_count": 1959,
"title": "Экскурсии по коммуналкам Санкт-Петербурга 2022: цены в июне",
"header": "Экскурсии по коммуналкам Санкт-Петербурга",
"extra_header": "Необычные экскурсии от местных жителей",
"tag": {
"id": 913,
"name": "Коммуналки",
"slug": "kommunalki",
"is_common": false,
"is_attraction": false,
"is_auto": false,
"is_hidden": false,
"category": "Темы",
"icon": null
},
"image": {
"thumbnail": "https://554a875a-71dc-4f5f-b6bf-ae8967f137d5.selcdn.net/thumbs2/94696ec0-fbac-11ec-b3d5-12849d2fe5ff.384x289.jpeg",
"medium": "https://554a875a-71dc-4f5f-b6bf-ae8967f137d5.selcdn.net/thumbs2/94e5547c-fbac-11ec-b3d5-12849d2fe5ff.800x600.jpeg"
},
"icon": null
}
]
}
Описание ответа
Параметр | Описание | Тип |
id | ID рубрики | Число |
citytag_id | ID рубрики в городе | Число |
name | Название рубрики на русском | Строка |
slug | Строковый идентификатор рубрики | Строка |
url | Ссылка на страницу рубрики на Трипстере (прочитайте про правила формирования ссылок) | Строка
|
experience_count | Число экскурсий в рубрике | Строка |
review_count | Чило отзывов в рубрике | Число |
title | Актуальный на текущий момент заголовок (включает фразу вида “цены в сентябре 2022”) | Строка |
header | Заголовок | Строка |
extra_header | Подзаголовок | Строка |
tag | Объект служебной информации о рубрике | Объект |
image.thumbnail | Ссылка на картнику-превью для рубрики размером 384х289 | Строка |
image.medium | Ссылка на картнику-превью для рубрики размером 800х600 | Строка |