المطورون

اربط HM ID بنظامك عبر REST API وdump يومي وwebhook. توضح الأمثلة أدناه الإصدار v1 من API الذي يمكنك تجربته في بيئة sandbox.

POST /v1/match
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 والبيئة الفعلية منفصلة.

Headers
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).

أمثلة للطلبات والاستجابات

POST /v1/match → 200
{
  "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
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
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 للمهام الجماعية.

احصل على عرض سعر مخصص

أرسل طلبك في ثلاث خطوات، ونرسل العرض إلى بريدك الإلكتروني للعمل. الطلب غير ملزم.