Главная › Партнёрам
OrbiTrip для партнёров: актуальные цены на трансферы по Грузии
OrbiTrip — маркетплейс частных водителей в Грузии: более 120 маршрутов с актуальными предложениями, более 470 мест посадки и высадки, одна фиксированная цена за всю машину. Турагентства, отели, туроператоры, приложения и ИИ-ассистенты могут показывать эти цены и вести клиента на готовую форму бронирования. Открытые данные работают уже сейчас без ключа; ключ партнёрского API выдаётся по запросу.
Кому это подходит
- Турагентствам и туроператорамРассчитайте частный трансфер в составе тура за секунды — на любую дату в ближайшие 180 дней.
- Отелям и гостевым домамПредлагайте гостям трансферы из аэропорта и между городами с фиксированной ценой и местным водителем.
- Приложениям, сайтам и ИИ-ассистентамПоказывайте актуальные предложения по маршруту и дате и ведите клиента на форму бронирования с уже выбранным водителем.
1Попробуйте сейчас: открытые данные без ключа
У каждого маршрута есть открытый файл с актуальными предложениями: машина каждого водителя, класс, число мест, языки и окончательная цена за всю машину. Откройте файл в браузере или читайте его из своего кода.
| Что нужно | Адрес |
|---|---|
| Предложения по маршруту (завтра, 2 пассажира) | https://orbitrip.ge/data/offers/tbilisi-to-batumi.json |
| То же самое простым текстом | https://orbitrip.ge/data/offers/tbilisi-to-batumi.txt |
| Предложения на вашу дату и группу | https://orbitrip.ge/data/offers/<route>/<YYYY-MM-DD>/<passengers>.jsonДаты от сегодня до 180 дней вперёд, от 1 до 20 пассажиров. Маршрут пишется как <from>-to-<to>, например kutaisi-to-batumi. |
| Все маршруты с готовыми ссылками | https://orbitrip.ge/data/offers-index.html |
| Ссылка на бронирование с уже выбранным водителем | https://orbitrip.ge/ru/transfer/<route>?autofind=1&date=YYYY-MM-DD&passengers=N&driver=<driver id>&utm_source=<ваше имя>Открывает форму бронирования этого водителя. Ничего не отправляется, пока клиент не подтвердит. В файле у каждого предложения эта ссылка уже есть в поле book_url. |
Поля файла: route (from, to, distance_km), date, passengers, currency, offer_count, lowest_price_gel и список drivers с полями id, car, class, seats, languages, fuel, features, price_gel, price_usd_approx, rating, reviews, profile_url и book_url. generated_at — время проверки цен.
Разумная нагрузка: достаточно примерно одного запроса в секунду — ответы обновляются каждые две минуты. Цена в файле — это расчёт на выбранную дату; машина закрепляется после подтверждения брони.
2Партнёрский API: поиск с ключом
Для ваших собственных страниц поиска и оформления. Это версия v0.4 (предварительная, только чтение): вы отправляете место посадки, место высадки, время и число пассажиров и получаете самую низкую актуальную цену по каждому классу машин. Бронирование через API включается для партнёра отдельно.
- Базовый адрес
https://orbitrip.ge/api/partner/v1 - Ключ заголовок
Authorization: Bearer <ваш ключ> - Лимит 60 запросов в минуту на ключ
| Метод | Ключ | Что возвращает |
|---|---|---|
GET /health | нет | Состояние сервиса и версия контракта. Открыть сейчас. |
GET /locations | да | Все места посадки и высадки: location_id, названия на английском и русском. |
POST /search | да | Самая низкая актуальная цена по каждому классу машин для вашей поездки. |
/bookings | да, по договорённости | Создание брони и отслеживание её статуса. |
Запрос
POST https://orbitrip.ge/api/partner/v1/search
Authorization: Bearer <your key>
Content-Type: application/json
{
"journey": {
"pickup": { "location": { "location_id": "tbilisi" },
"at": "<pick-up time, e.g. 2027-06-15T10:00:00+04:00>" },
"dropoff": { "location_id": "batumi" },
"passengers": 3
}
}Ответ (формат)
{
"status": "OFFERS_AVAILABLE",
"currency": "GEL",
"travel_date": "<YYYY-MM-DD>",
"passengers": 3,
"route": { "pickup_location_id": "tbilisi", "dropoff_location_id": "batumi",
"distance_km": <km> },
"offers": [
{ "vehicle_class": "SEDAN",
"net_price": { "amount_minor": <price in tetri>, "currency": "GEL" },
"availability": "CONFIRMED_AT_BOOKING" },
{ "vehicle_class": "MINIVAN",
"net_price": { "amount_minor": <price in tetri>, "currency": "GEL" },
"availability": "CONFIRMED_AT_BOOKING" }
],
"reasons": []
}amount_minor— цена за всю машину в тетри (100 тетри = 1 лари).pickup.at— время подачи в формате ISO 8601 с часовым поясом, не раньше чем через 90 минут.passengers: от 1 до 20. Необязательно:vehicle_class— SEDAN, MINIVAN, SUV или SUV_4X4;stops— список мест по пути.status— OFFERS_AVAILABLE или NO_MATCH; при NO_MATCH причина указана в спискеreasons.- Ошибки: 400 INVALID_REQUEST, 401 UNAUTHORIZED, 403 FORBIDDEN_SCOPE, 429 RATE_LIMITED.
3Получить ключ
Напишите нам и укажите три вещи: вашу компанию и сайт, что вы хотите сделать и сколько примерно поисков в день ожидаете. Вам ответит живой оператор и пришлёт ключ.
WhatsApp +995 593 456 876[email protected]
Как это работает для вашего клиента
- Клиент выбирает маршрут, дату и водителя. Показанная цена окончательная — за всю машину.
- Водитель подтверждает бронь. Клиент получает письмо с деталями брони и ссылкой для бесплатной отмены.
- Водитель встречает клиента с табличкой с именем. Ожидание и остановки для фото бесплатны.
- Клиент платит водителю наличными (GEL, USD или EUR) после поездки. Предоплаты нет.