المطورون
اربط HM ID بنظامك عبر REST API وdump يومي وwebhook. توضح الأمثلة أدناه الإصدار v1 من API الذي يمكنك تجربته في بيئة sandbox.
curl -X POST https://api.hotelmapping.org/v1/match \
-H "X-API-Key: $HM_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "SUNSET BAY RESORT SPA",
"address": "Belek Turizm Merkezi, Serik",
"country": "TR",
"lat": 36.8541,
"lng": 31.0552
}' المصادقة
يُرسل كل طلب عبر HTTPS ومعه ترويسة X-API-Key. مفاتيح بيئة sandbox والبيئة الفعلية منفصلة.
X-API-Key: $HM_API_KEY
Content-Type: application/json
Accept-Language: tr نقاط النهاية
-
POST /v1/matchتبحث عن الفندق بالاسم والعنوان والإحداثيات؛ وتعيد HM ID ودرجة الثقة (Find Match API).
-
GET /v1/hotels/{hm_id}تعيد السجل القياسي للفندق ورموز الموردين والمعرّفات المتقاطعة.
-
GET /v1/suppliers/{supplier}/codes/{code}تحوّل رمز المورّد إلى HM ID.
-
POST /v1/rooms/mapتفكّك أسماء الغرف إلى النوع والفئة والإطلالة والسرير والسعة؛ وتجمّع الغرف المتطابقة.
-
POST /v1/boards/mapتحوّل صيغ نظام الوجبات إلى الرمز القياسي (RO وBB وHB وFB وAI وUAI…).
-
GET /v1/destinations/{id}تعيد التسلسل الهرمي من الدولة إلى المنطقة إلى المدينة إلى منطقة المنتجع، ورموز وجهات الموردين.
-
GET /v1/hotels/{hm_id}/contentتعيد الوصف وصحيفة الحقائق بعدة لغات.
-
GET /v1/dumps/latestتعيد عناوين ملفات dump اليومية الكاملة والتفاضلية (CSV وJSON وParquet).
أمثلة للطلبات والاستجابات
{
"hm_id": "HM-1048213",
"confidence": 0.991,
"decision": "auto_match",
"name": "Sunset Bay Resort & Spa",
"destination_id": "TR-07-SERIK-BELEK",
"external_ids": { "client": "OTL-2231" }
} POST /v1/rooms/map
{
"hm_id": "HM-1048213",
"rooms": ["Dbl Sea View Balcony", "DOUBLE ROOM SEASIDE W/ BALCONY"]
}
// → 200
{
"groups": [{
"room_id": "HM-1048213-R03",
"type": "room",
"class": "standard",
"view": "sea",
"bed": "double",
"features": ["balcony"],
"max_occupancy": 3,
"matched": ["Dbl Sea View Balcony", "DOUBLE ROOM SEASIDE W/ BALCONY"]
}]
} POST /v1/boards/map
{ "values": ["Ultra Herşey Dahil", "UALL", "Soft All Inc.", "HB+"] }
// → 200
{
"results": [
{ "input": "Ultra Herşey Dahil", "code": "UAI", "score": 0.99, "decision": "auto_match" },
{ "input": "UALL", "code": "UAI", "score": 0.93, "decision": "review" },
{ "input": "Soft All Inc.", "code": "SAI", "score": 0.98, "decision": "auto_match" },
{ "input": "HB+", "code": "HB+", "score": 1.0, "decision": "auto_match" }
]
} أمثلة الشيفرة توضيحية؛ وقد تتغير أسماء الحقول عند إصدار v1.
خيارات التسليم
-
REST API
للاستعلامات الفورية وFind Match. استجابة JSON وترقيم صفحات ونقاط نهاية بإصدارات.
-
dump يومي
ملفات كاملة وتفاضلية: CSV أو JSON أو Parquet. للتحميل الجماعي إلى قاعدة بياناتك.
-
Webhookقريبًا
إشعارات بالفنادق المغلقة والمدموجة والجديدة. مخطط له.
بيئة sandbox مجانية لمدة 14 يومًا
جرّب جميع نقاط النهاية بـ 1,000 استدعاء API شهريًا وبيانات نموذجية. لا حاجة إلى بطاقة ائتمان.
مكتبات SDKقريبًا
مكتبات العميل لـ .NET وPHP وNode.js وPython قيد الإعداد. وإلى ذلك الحين يمكنك الاستخدام من أي لغة عبر HTTP مباشرة.
- .NET
- PHP
- Node.js
- Python
حدود المعدل
تعتمد حدود الطلبات على خطتك وتُذكر في عرض السعر. يوصى باستخدام dump للمهام الجماعية.
احصل على عرض سعر مخصص
أرسل طلبك في ثلاث خطوات، ونرسل العرض إلى بريدك الإلكتروني للعمل. الطلب غير ملزم.