Разработчикам

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" }'
Выберите пример запроса

Запрос

POST /v1/match/hotel
{
  "name": "AURORA BEACH RST SPA 5*",
  "address": "Belek, Serik, Antalya",
  "geo": { "lat": 36.8571, "lng": 31.0432 }
}

Ответ

{
  "td_id": "TD-1048213",
  "name": "Aurora Beach Resort & Spa",
  "destination": "Belek, Antalya, TR",
  "stars": 5,
  "board_types": ["AI", "UAI"],
  "supplier_codes": {
    "supplier_a": "HTL-88213",
    "supplier_b": "40917",
    "supplier_c": "TR-ANT-551"
  },
  "match_score": 0.998,
  "languages": ["en", "tr", "de", "ru", "ar"]
}

Запрос

POST /v1/match/board
{
  "names": [
    "Ultra Her Şey Dahil",
    "Soft AI",
    "Half Board Plus"
  ]
}

Ответ

{
  "results": [
    { "input": "Ultra Her Şey Dahil", "code": "UAI" },
    { "input": "Soft AI", "code": "SAI" },
    { "input": "Half Board Plus", "code": "HB+" }
  ]
}

Запрос

POST /v1/match/rooms
{
  "td_id": "TD-1048213",
  "names": [
    "Deluxe Sea View DBL",
    "Dlx Room Seaside Double"
  ]
}

Ответ

{
  "rooms": [
    {
      "room_code": "DLX-SEA-DBL",
      "type": "Deluxe",
      "view": "Sea",
      "bed": "DBL",
      "supplier_names": [
        "Deluxe Sea View DBL",
        "Dlx Room Seaside Double"
      ]
    }
  ]
}

Названия отелей и поставщиков приведены для примера.

Эндпоинты

МетодПутьНазначение
GET/v1/hotels/{td_id}Карточка одного отеля (контент + маппинг)
GET/v1/hotels?country=TR&city=antalyaСписок отелей и фильтрация
POST/v1/match/hotelTravelData 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.

  • Вебхуки

    Уведомления о закрытии отеля, новом совпадении и обновлении контента.

Запросить доступ к API