...
Фильтры
city фильтр по ID города
city__name_ru фильтр по названию города на русском
city__name_en фильтр по названию города на английском
city__iata фильтр по коду IATA города
citytag фильтр по ID рубрики
guide фильтр по ID гида
exp_format фильтр по типу экскурсии (exp_format=9 – онлайн-экскурсии)
Сортировка
sorting=popularity по популярности экскурсии в городе (sorting=-popularity по убыванию, sorting=popularity по возрастанию)
sorting=price по цене
Набор данных
detailed=false сокращенный набор полей. Используйте для загрузки списка экскурсий и отображения его у себя в реальном времени.
detailed=true расширенный набор полей. Используйте для загрузки полных данных по экскурсиям к себе в БД, а также для отображения одной экскурсии в реальном времени. По умолчанию включен при запросе конкретной экскурсии по ID
Запрос обновленных данных
updated_after=YYYY-MM-DD или YYYY-MM-DD HH:MM:SS будут возвращены экскурсии, которые изменились с этого времени
Стандартные параметры format и page_size/per_page, прочитайте про постраничную загрузку данных
...
| Code Block | ||
|---|---|---|
| ||
// обновлённая экскурсия, ставшая неактивной, отдаются только поля id, status
{
"id": 13443,
"status": "inactive"
},
// обновлённая активная экскурсия, отдаются все поля
{
"id": 13526,
"title": "Отправить открытку из Эрмитажа",
"tagline": "Прикоснуться к великолепию дворца и музейных коллекций и найти среди экспонатов то, что по душе",
"url": "https://experience.tripster.ru/experience/13526/",
"type": "private",
"instant_booking": false,
"child_friendly": true,
"max_persons": 6,
"duration": 2.5,
"price": {
"value": 3500.0,
"currency": "RUB",
"currency_rate": "1.0",
"price_from": false,
"unit_string": "за экскурсию",
"value_string": "3500 руб. за экскурсию",
"discount": null
},
"review_count": 79,
"rating": 5.0,
"popularity": 94697,
"city": {
"id": 144,
"name_ru": "Санкт-Петербург",
"name_en": "Saint Petersburg",
"iata": "LED",
"country": {
"id": 238,
"name_ru": "Россия",
"name_en": "Russia",
"currency": "RUB",
"in_obj_phrase": "по России",
"experience_count": 956,
"url": "https://experience.tripster.ru/destinations/russia/"
},
"experience_count": 217,
"in_obj_phrase": "по Санкт-Петербургу",
"url": "https://experience.tripster.ru/experience/Saint_Petersburg/",
"image": {
"thumbnail": "https://experience-ireland.s3.amazonaws.com/photos/289a4107-da01-4842-9f14-c548eecaefe5.jpg"
},
"utc_offset": 10800.0
},
"guide": {
"id": 135416,
"first_name": "Александра",
"url": "https://experience.tripster.ru/guide/135416/",
"avatar": {
"small": "https://experience-ireland.s3.amazonaws.com/avatar/8946e753-99a9-11e8-b5d4-0ac55974a77a.31x31.jpg",
"medium": "https://experience-ireland.s3.amazonaws.com/avatar/8946e752-99a9-11e8-b5d4-0ac55974a77a.150x150.jpg"
},
"rating": 5.0,
"review_count": 84,
},
"tags": [
{
"id": 170,
"name": "Музеи и искусство",
"experience_count": 16,
"url": "https://experience.tripster.ru/experience/Saint_Petersburg/170-muzei-i-iskusstvo/"
}
],
"photos": [
{
"thumbnail": "https://experience-ireland.s3.amazonaws.com/thumbs2/b26010fc-90e7-11e8-b5d2-0ac55974a77a.384x289.jpg",
"medium": "https://experience-ireland.s3.amazonaws.com/thumbs2/a8e33a7e-90e7-11e8-b5d2-0ac55974a77a.800x600.jpg"
}
],
"links": {
"reviews": "https://experience.tripster.ru/api/experiences/13526/reviews/"
},
"status": "active"
}, |
...
Расширенный формат цены
Для того, чтобы получить альтернативное описание объекта price, сделайте запрос списка экскурсий с параметром price_format=detailed либо конкретной экскурсии с параметром price_format=detailed.
...
Параметр | Описание | Тип |
|---|---|---|
onsite_payment | Процент стоимости, оплачиваемой на сайте. Значение 0.2 означает, что 20% пользователь оплатит онлайн, а 80% гиду на месте | Float |
В зависимости от выбранной гидом ценовой модели (человек/группа) будет передаваться параметр per_person или per_group | ||
per_person | Объект, содержащий информацию о стоимости экскурсии за человека. Зачастую в объекте передается единственный элемент со стандартной ценой. Но в случае, если стоимость зависит от категории билета, то объект содержит несколько значений для разных категорий. Цена из первой категории - всегда основная. Список возможных категорий не фиксированный, гид добавляет свои варианты при добавлении экскурсии (id для вариантов эмулируется налету из названия) | Объект |
per_group | Объект с ценой за экскурсию | Объект |
Различные ценовые модели
1. Групповая экскурсия со стоимостью за человека
https://experience.tripster.ru/experience/8092/
| Code Block |
|---|
"price": {
"value": 60.0,
"currency": "EUR",
"currency_rate": 91.0,
"price_from": false,
"unit_string": "за человека",
"value_string": "€60 за человека"
}, |
?price_format=detailed
| Code Block |
|---|
"price": {
"currency": "EUR",
"currency_rate": 91.0,
"onsite_payment": 0.5,
"per_person": [
{
"id": 3917702062,
"title": "Стандартный билет",
"is_default": true,
"value": 60.0
},
{
"id": 3963018687,
"title": "Дети до 18 лет",
"is_default": false,
"value": 42.0
}
],
"value_string": "€60 за человека",
"unit_string": "за человека",
"price_description": "€60 за человека"
}, |
2. Индивидуальная со стоимостью “за экскурсию“. Стоимость фиксированная при любом числе участников
https://experience.tripster.ru/experience/21903/
| Code Block |
|---|
"price": {
"value": 7800.0,
"currency": "RUB",
"currency_rate": 1.0,
"price_from": false,
"unit_string": "за экскурсию",
"value_string": "7800 руб. за экскурсию"
}, |
?price_format=detailed
| Code Block |
|---|
"price": {
"currency": "RUB",
"currency_rate": 1.0,
"onsite_payment": 0.23,
"per_group": {
"value": 7800.0
},
"value_string": "7800 руб. за экскурсию",
"unit_string": "за экскурсию",
"price_description": "7800 руб. за экскурсию"
}, |
3. Индивидуальная со стоимостью за человека – тут общая стоимость зависит от числа участников
https://experience.tripster.ru/experience/20321/
| Code Block |
|---|
"price": {
"value": 400.0,
"currency": "RUB",
"currency_rate": 1.0,
"price_from": false,
"unit_string": "за человека",
"value_string": "400 руб. за человека"
}, |
?price_format=detailed
| Code Block |
|---|
"price": {
"currency": "RUB",
"currency_rate": 1.0,
"onsite_payment": 0.23,
"per_person": [
{
"id": 3917702062,
"title": "Стандартный билет",
"is_default": true,
"value": 400.0
},
{
"id": 193973751,
"title": "Дети до 7 лет",
"is_default": false,
"value": 0.0
}
],
"value_string": "400 руб. за человека",
"unit_string": "за человека",
"price_description": "400 руб. за человека"
}, |
4. Индивидуальная со стоимостью за человека и минимальной стоимостью (если людей меньше, то все равно заплатят мин.цену)
https://experience.tripster.ru/experience/16665/
| Code Block |
|---|
"price": {
"value": 150.0,
"currency": "EUR",
"currency_rate": 91.0,
"price_from": true,
"unit_string": "за экскурсию",
"value_string": "от €150 за экскурсию"
}, |
?price_format=detailed
| Code Block |
|---|
"price": {
"currency": "EUR",
"currency_rate": 91.0,
"onsite_payment": 0.23,
"per_group": {
"value": 150.0
},
"per_person": [
{
"id": 3917702062,
"title": "Стандартный билет",
"is_default": true,
"value": 50.0
},
{
"id": 2612817417,
"title": "Дети до 4 лет",
"is_default": false,
"value": 0.0
}
],
"value_string": "от €150 за экскурсию",
"unit_string": "за экскурсию",
"price_description": "€150 за 1-3 человек или €50 за человека, если вас больше"
}, |