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.
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.
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/mapOda adlarını tip, sınıf, manzara, yatak ve kapasiteye ayırır; aynı odaları gruplar.
-
POST /v1/boards/mapPansiyon 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/latestGünlük tam ve delta dump dosyalarının adreslerini döner (CSV, JSON, Parquet).
Örnek istek ve yanıtlar
{
"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" }
]
} 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.