Geliştiriciler

REST API, günlük dump ve webhook ile HM ID'yi kendi sisteminize bağlayın. Aşağıdaki örnekler, sandbox'ta deneyebileceğiniz API v1'i gösterir.

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
  }'

Kimlik doğrulama

Her istek HTTPS üzerinden ve X-API-Key başlığıyla gönderilir. Sandbox ve canlı ortam anahtarları ayrıdır.

Headers
X-API-Key: $HM_API_KEY
Content-Type: application/json
Accept-Language: tr

Uç noktalar

  • POST /v1/match

    İsim, adres ve koordinatla otel arar; HM ID ve güven skoru döner (Find Match API).

  • GET /v1/hotels/{hm_id}

    Otelin standart kaydını, tedarikçi kodlarını ve çapraz ID'lerini döner.

  • GET /v1/suppliers/{supplier}/codes/{code}

    Tedarikçi kodundan HM ID'ye çevirir.

  • POST /v1/rooms/map

    Oda adlarını tip, sınıf, manzara, yatak ve kapasiteye ayırır; aynı odaları gruplar.

  • POST /v1/boards/map

    Pansiyon yazımlarını standart koda (RO, BB, HB, FB, AI, UAI…) çevirir.

  • GET /v1/destinations/{id}

    Ülke → il → ilçe → resort bölgesi hiyerarşisini ve tedarikçi destinasyon kodlarını döner.

  • GET /v1/hotels/{hm_id}/content

    Çok dilli açıklama ve factsheet döner.

  • GET /v1/dumps/latest

    Günlük tam ve delta dump dosyalarının adreslerini döner (CSV, JSON, Parquet).

Örnek istek ve yanıtlar

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" }
  ]
}

Kod örnekleri temsilidir; alan adları v1 yayınında değişebilir.

Teslim seçenekleri

  • REST API

    Anlık sorgular ve Find Match için. JSON yanıt, sayfalama ve sürümlü uç noktalar.

  • Günlük dump

    Tam ve delta dosyalar: CSV, JSON veya Parquet. Kendi veritabanınıza toplu yükleme için.

  • WebhookYakında

    Kapanan, birleşen ve yeni oteller için bildirim. Planlanıyor.

14 günlük ücretsiz sandbox

Ayda 1.000 API çağrısı ve örnek veriyle tüm uç noktaları deneyin. Kredi kartı gerekmez.

SDK'larYakında

.NET, PHP, Node.js ve Python istemci kütüphaneleri hazırlanıyor. O zamana kadar her dilden düz HTTP ile kullanabilirsiniz.

  • .NET
  • PHP
  • Node.js
  • Python

Hız sınırları

İstek sınırları planınıza bağlıdır ve teklifinizde belirtilir. Toplu işler için dump önerilir.

Size özel teklifi alın

Talebinizi üç adımda gönderin; teklifi iş e-postanıza iletelim. Talep bağlayıcı değildir.