API
1. Общий WorkFlow
С помощью API каталога экскурсий вы можете создать витрину экскурсий у себя на сайте в своем дизайне.
Путешественник на вашем сайте выбирает экскурсию и формирует заказ
Вы создаете новый заказ на своей стороне и передаете в Трипстер через API создания заказов.
Вы принимаете оплату от пользователя на своем сайте и передаете информацию об оплате заказа по API в Трипстер
При отмене заказа
С вашей стороны (путешественником) - необходимо передать информацию об отмене заказа по API
Со стороны Трипстера (гида) - если заказ по какой-то причине отменяется, то меняется его статус в списке заказов при запросе к API заказов.
Сверка и взаиморасчеты
Список недавно обновлённых заказов можно получить с помощью API заказов
В API по каждому заказу приходит поле profit с суммой, которую вы забираете себе с каждого заказа
Также со стороны Трипстера формируется отчет по пришедшим от вас заказам, который является основанием для взаиморасчетов.
Поддержка
Все вопросы с путешественником решает ваш саппорт. При каких-то необходимых действиях со стороны гида, вам необходимо связаться с нашим саппортом по почте support@tripster.ru
2. Общие положения
Организационные
Пользователь из заказа, созданного на вашем сайте, не сможет авторизоваться на сайте Трипстер (мы не проводим регистрацию ваших пользователей у нас при создании заказа)
Такие пользователи также не получают уведомлений от Трипстер
Гид не сможет вести переписку с пользователями в заказах, созданных через партнерское API.
Если после 24 часов гид не подтвердил заказ, то заказ автоматически отменяется.
Требуемая цена при создании заказа - полная цена в рублях.
Если в экскурсии есть несколько типов билетов, то стоимость каждого билета будет округляться, однако при вычислении общей стоимости заказа, округляться будет общая сумма. Из-за этого возможно небольшое расхождение.
Технические
Запросы к API делаются по протоколу HTTP.
Аргументы в GET запросах передаются через query params
Аргументы в POST запросах передаются через BODY в формате JSON
В каждом запросе должен быть обязательным заголовок X-REQUESTID
Генерация request_id
uuid = любая уникальная строка, рекомендуется uuid version4
now_timestamp = int(utc_now()) - целое число секунд unix_timestamp на момент запроса
request_id = <uuid>_<now_timestamp>
Запросы с request_id старше 30 минут не обрабатываются и возвращаются с кодом 400.
3. Доступы к методам
API методы для получения данных об экскурсиях, расписании и ценах являются общедоступными и не требуют авторизации.
API методы для работы с заказами можно выполнять только с авторизацией:
создание заказа
оплата заказа
получение статуса заказа
4. Для начала интеграции
Мы создадим для вас тестовую среду для обкатки подключения.
Выдадим персональный secret_key для доступа к среде
После обкатки на тестовой среде, так же выдадим новый secret_key для доступа уже к боевому API
On this page: