Oda eşleştirme çözümü
Oda adlarını tip, sınıf, manzara, yatak ve kapasiteye ayırır; aynı odayı tek oda ID'sinde toplar.
Oda içerikleri, oda eşleştirmesiyle oluşan her standart oda tipine (ör. HM-1048213-R03) çok dilli açıklama ve yapılandırılmış bilgi ekler: metrekare, en fazla yetişkin ve çocuk sayısı, ek yatak, yatak düzeni, manzara ve oda olanakları. Misafir neyi satın aldığını net görür. Ürün yakında kullanıma açılacak; erken erişim için teklif sayfasından başvurabilirsiniz.
{
"room_id": "HM-1048213-R03",
"hm_id": "HM-1048213",
"size_m2": 28,
"max_adults": 2,
"max_children": 1,
"max_occupancy": 3,
"extra_bed": false,
"bed": "double",
"view": "sea",
"amenities": ["balcony", "air_conditioning", "minibar"],
"description": {
"tr": {
"short": "Deniz manzaralı, balkonlu, 28 m² çift kişilik oda.",
"long": "Balkondan deniz manzarası sunan oda 28 m²'dir; iki yetişkin ve bir çocuk konaklayabilir. Odada klima ve minibar bulunur."
}
},
"supplier_rooms": { "A": "DBLSV-B", "B": "DZMB", "C": "STD-DNZ" }
} İçerik otelin genel tanıtımı değil, satılan oda tipine özeldir; standart oda kimliğiyle birlikte gelir.
Oda açıklamaları Türkçe, İngilizce, Almanca, Rusça ve Arapça olarak hazırlanır.
Kapasite ve yatak düzeni ayrı alanlarda gelir; filtrelerde ve doluluk kontrollerinde doğrudan kullanılır.
Açıklamalar yapay zekâyla hızlı üretilir, editörler kontrol eder.
Aynı oda için üç tedarikçiden gelen bilgiler
supplier,hotel_code,room_code,room_info
A,HTL-88213,DBLSV-B,"Sea view room, 28 m2, max 3 pax"
B,40917,DZMB,"Zimmer ca. 28 qm, Meerblick, Balkon, Klimaanlage"
C,TR-ANT-551,STD-DNZ,"Deniz manzaralı balkonlu oda, 2 yetişkin + 1 çocuk, minibar" Standart oda tipine bağlı oda içeriği
{
"room_id": "HM-1048213-R03",
"hm_id": "HM-1048213",
"size_m2": 28,
"max_adults": 2,
"max_children": 1,
"max_occupancy": 3,
"extra_bed": false,
"bed": "double",
"view": "sea",
"amenities": ["balcony", "air_conditioning", "minibar"],
"description": {
"tr": {
"short": "Deniz manzaralı, balkonlu, 28 m² çift kişilik oda.",
"long": "Balkondan deniz manzarası sunan oda 28 m²'dir; iki yetişkin ve bir çocuk konaklayabilir. Odada klima ve minibar bulunur."
}
},
"supplier_rooms": { "A": "DBLSV-B", "B": "DZMB", "C": "STD-DNZ" }
} Örnek veridir; otel, oda bilgileri ve kodlar gerçek bir tesise ait değildir. Alan adları API v1 taslağıdır.
Oda eşleştirme, tedarikçilerin oda adlarını otelin HM ID'sine bağlı standart oda kimliğine bağlar.
Metrekare, kapasite, yatak düzeni ve manzara bilgisi tüm kaynaklardan toplanır ve ayrı alanlara dönüştürülür.
Yapay zekâ oda tipine özel kısa ve uzun açıklama üretir; editörler kontrol eder.
Oda içeriği, standart oda kimliğiyle birlikte API yanıtında ve toplu dosyada gelir.
Oda seçim ekranında misafir çoğu zaman yalnız bir oda adı ve fiyat görür. “Standart oda” ile “Superior oda” arasındaki farkı, odanın kaç kişi aldığını veya balkonu olup olmadığını anlamak için otelin genel açıklamasını okuması gerekir. Tedarikçiler bu bilgileri farklı biçimlerde gönderir: biri “28 m2, max 3 pax” yazar, biri metrekareyi Almanca serbest metnin içine koyar, biri hiç vermez.
Oda içerikleri bu bilgileri her standart oda tipi için tek bir kayıtta toplar. Ürün yakında kullanıma açılacak; bu sayfa nasıl çalışacağını anlatır, örneklerdeki alanlar ve uç noktalar API v1 taslağıdır.
Oda içerikleri, oda eşleştirme sonucunda oluşan standart oda kimliklerini kullanır. “Dbl Sea View Balcony”, “DZ Meerblick Balkon” ve “Standart Oda Deniz Manzaralı Balkonlu” aynı oda kimliğine bağlandığı için üç tedarikçinin bilgileri de aynı odada birleşir. Oda tiplerinin nasıl standartlaştığını oda eşleştirme nedir rehberinde, genel çerçeveyi otel eşleştirme rehberinde bulabilirsiniz.
| Alan | Ne anlatır | Örnek |
|---|---|---|
| Oda açıklaması | Oda tipine özel kısa ve uzun metin | TR, EN, DE, RU, AR |
| Ölçü | Odanın büyüklüğü | 28 m² |
| Kapasite | En fazla yetişkin ve çocuk, ek yatak | 2 yetişkin + 1 çocuk |
| Yatak düzeni | Yatak tipi | Çift kişilik, iki ayrı yatak |
| Manzara ve konum | Pencereden görünen, odanın yeri | Deniz manzarası, bahçe katı |
| Oda olanakları | Standart olanak kodları | Balkon, klima, minibar |
Oda olanakları otel olanakları ürünüyle aynı sözlükten gelir. Oda resimleri ile birlikte kullanıldığında açıklama, ölçüler ve fotoğraflar aynı oda kimliğinde buluşur. Terim için oda eşleştirme sözlük sayfasına bakabilirsiniz.
Erken erişim, kapsam ve fiyat için teklif alabilirsiniz.
İstek
curl "https://api.hotelmapping.org/v1/hotels/HM-1048213/rooms?include=content&lang=tr" \
-H "X-API-Key: $HM_API_KEY" Yanıt
{
"hm_id": "HM-1048213",
"rooms": [
{
"room_id": "HM-1048213-R03",
"name": "Standard Double Room, Sea View, Balcony",
"size_m2": 28,
"max_adults": 2,
"max_children": 1,
"extra_bed": false,
"bed": "double",
"view": "sea",
"amenities": ["balcony", "air_conditioning", "minibar"],
"description": {
"short": "Deniz manzaralı, balkonlu, 28 m² çift kişilik oda."
}
}
]
} Kod örnekleri temsilidir; alan adları v1 yayınında değişebilir.
Oda içerikleri yakında kullanıma açılacak; kesin tarih henüz paylaşılmadı. Erken erişim için teklif sayfasından bize yazabilirsiniz.
Evet. İçerik, oda eşleştirmesinin verdiği standart oda kimliğine bağlanır. Oda tipleri standartlaşmadan farklı tedarikçilerin bilgileri aynı odada birleştirilemez.
Çok dilli kısa ve uzun oda açıklaması, metrekare, en fazla yetişkin ve çocuk sayısı, ek yatak, yatak düzeni, manzara ve oda olanakları.
Oda olanakları, otel olanakları ürünüyle aynı standart sözlükten gelir. Bu yüzden bir oda tipinin olanakları ile otelin olanak listesi aynı kodları kullanır.
Hayır. Oda içerikleri statik oda verisidir. Fiyat ve müsaitlik tedarikçiden sizin sisteminize gelir.
Teklif al
Talebinizi üç adımda gönderin; teklifi iş e-postanıza iletelim. Talep bağlayıcı değildir.