المطورون
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" }'أسماء الفنادق والموردين للتوضيح فقط.
نقاط النهاية
| الطريقة | المسار | الوظيفة |
|---|---|---|
| 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
إشعارات إغلاق فندق ومطابقة جديدة وتحديث المحتوى.