Автокомплит городов и стран

1 Параметры запроса
2 Структура ответа
- 2.1 Пример ответа API
3 Описание ответа
4 Примеры использования

API позволяет искать по сайту страны, города, рубрики и экскурсии текстовым запросом. Для получения данных используйте метод https://experience.tripster.ru/api/partners/{partnername}/search/site/

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

Параметры
- query текст запроса
  - limit кол-во результатов (16 значений по умолчанию)
- types фильтр по типам объектов. Строка с запятой в качестве разделителя. Возможные значения:
  - country (страны)
  - city (города)
  - citytag (рубрики)
  - experience (экскурсии и туры)

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

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

[
    {
        "id": 130,
        "type": "country",
        "title": "Франция",
        "url": "https://experience.tripster.ru/destinations/france/",
        "score": 18.00821763664043,
        "experience_count": 281
    },
    {
        "id": 3,
        "type": "city",
        "title": "Париж",
        "url": "https://experience.tripster.ru/experience/Paris/",
        "score": 16.854508934275433,
        "experience_count": 224,
        "country": {
            "id": 130,
            "name_ru": "Франция"
        }
    },
    {
        "id": 310,
        "type": "citytag",
        "title": "Обзорные",
        "url": "https://experience.tripster.ru/experience/Paris/310-obzornyie/",
        "score": 10.360534288774225,
        "experience_count": 39,
        "city": {
            "id": 3,
            "name_ru": "Париж",
            "country": {
                "id": 130,
                "name_ru": "Франция"
            }
        }
    },
    {
        "id": 13216,
        "type": "experience",
        "title": "Главные сокровища Лувра за 2 часа",
        "url": "https://experience.tripster.ru/experience/13216/",
        "score": 8.832400703069453,
        "price": "от €35",
        "image": "https://experience-ireland.s3.amazonaws.com/thumbs2/f94a627c-73f7-11e8-87e2-6e714efd800d.384x289.jpg",
        "city": {
            "id": 3,
            "name_ru": "Париж",
            "country": {
                "id": 130,
                "name_ru": "Франция"
            }
        }
    }
]

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

Параметр	Описание	Тип
id	ID экскурсии в Трипстере	Число
type	Тип объекта: country, city, citytag, experience	Строка
title	Название объекта	Строка
url	Ссылка на страницу на Трипстере	Строка
score	Рейтинг — релевантность объекта поиска в выдаче	Число
experience_count	Число экскурсий в рубрике, городе или стране	Число
city	Объект с данными о городе	Объект
city.id	ID города в Трипстере	Число
city.name_ru	Название города на русском	Строка
country	Объект с данными о стране	Объект
country.id	ID страны в Трипстере	Число
country.name_ru	Название страны на русском	Строка
price	Минимальная цена за экскурсию	Число
image	Картинка экскурсии в виде превью	Строка

Примеры использования

Поисковый запрос без параметров отдает самые популярные города: https://experience.tripster.ru/api/partners/{partnername}/search/site/
Можно в реальном времени отправлять запросы при вводе пользователем в поисковое поле слова "париж": п, па, пар, пари, париж
Выдачу можно группировать на своей стороне по типам «types». Например, мы в шапке сайта группируем в выдаче экскурсии в блок «Популярные экскурсии»