Разработчикам
API traveldata: REST-эндпоинты для маппинга отелей, номеров и питания
JSON поверх REST. Отправьте запись об отеле и получите TravelData ID, оценку уверенности и коды поставщиков.
Быстрый старт
Передавайте API-ключ в заголовке Authorization. Все ответы — JSON в кодировке UTF-8.
curl https://api.traveldata.pro/v1/match/hotel \
-H "Authorization: Bearer $TRAVELDATA_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "name": "AURORA BEACH RST SPA 5*", "address": "Belek, Serik, Antalya" }'Названия отелей и поставщиков приведены для примера.
Эндпоинты
| Метод | Путь | Назначение |
|---|---|---|
| GET | /v1/hotels/{td_id} | Карточка одного отеля (контент + маппинг) |
| GET | /v1/hotels?country=TR&city=antalya | Список отелей и фильтрация |
| POST | /v1/match/hotel | TravelData ID и оценка по названию, адресу и координатам |
| POST | /v1/match/rooms | Стандартные коды номеров по названиям номеров |
| POST | /v1/match/board | Стандартный код питания по названию питания |
| GET | /v1/mappings/{supplier} | Таблица «код поставщика ↔ TravelData ID» |
| GET | /v1/destinations/{id} | Иерархия направлений |
| GET | /v1/hotels/{td_id}/images | Изображения с тегами и оценкой |
| GET | /v1/hotels/{td_id}/content?lang=de | Описания на нескольких языках |
| GET | /v1/dumps/latest | Ссылки на файловые выгрузки |
| POST | /v1/webhooks | Подписка на вебхуки |
Форматы выгрузки
REST API
Для маппинга на лету и единичных запросов.
Файловые выгрузки
Полные и дельта-файлы; CSV и JSON.
Вебхуки
Уведомления о закрытии отеля, новом совпадении и обновлении контента.