Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • Фильтры

    • 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
languagejs
// обновлённая экскурсия, ставшая неактивной, отдаются только поля 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 за человека, если вас больше"
    },