API

Owned by Anastasia Vakulova
Last updated: Jun 25, 2021
2 min read

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: