المطورون

traveldata API: نقاط 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/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الاشتراك في webhook

صيغ التسليم

  • REST API

    للمطابقة اللحظية والاستعلامات الفردية.

  • ملفات مجمّعة

    ملفات كاملة وتفاضلية؛ بصيغتي CSV وJSON.

  • Webhook

    إشعارات إغلاق فندق ومطابقة جديدة وتحديث المحتوى.

اطلب الوصول إلى الـ API