Destek
Entegrasyon sırasında takıldığınız her konuda geliştirici ekibimize ulaşabilirsiniz. Önce ilgili ürünün Hata kodları sayfasına bakmanızı öneririz; çoğu soru orada yanıtlanıyor.
E-posta
Teknik sorular, hata bildirimleri, iş ortağı anahtarı ve test oteli talepleri. Hafta içi bir iş günü içinde yanıtlanır.
İş ortağı anahtarı
API’ye erişmek için HMS’in tanımladığı bir iş ortağı hesabı gerekir. Şirket bilgileriniz ve entegre edeceğiniz otellerle birlikte e-posta gönderin; test ortamı için apiKey, apiSecret ve bir otel kimliği iletilir.
Hata bildirirken şunları ekleyin
- Ürün ve uç nokta (örn. Online Booking ·
POST /external/online/roomType) - İsteğin tam gövdesi ve yanıt —
apiSecret, token ve kart verisi maskelenmiş - İsteğin gönderildiği zaman (saat dilimiyle) ve
hotelID - Beklediğiniz sonuç ve sorunun tekrarlanabilir olup olmadığı
Sık sorulan sorular
API’yi kullanmak için ne gerekir?
HMS tarafından tanımlanmış bir iş ortağı hesabı (apiKey / apiSecret) ve entegre edeceğiniz otelin bu hesap için yetkilendirilmiş olması. Otel tarafında ilgili modülün (örn. online rezervasyon kanalı) aktif olması gerekir.
Test ortamı var mı?
Evet. Dokümandaki örnekler test ortamını (test.hms.gen.tr) kullanır; geliştirme için bu ortama ait bir otel kaydı ve iş ortağı anahtarı sağlanır. Canlı ortam adresi ve canlı anahtarlar entegrasyon onaylandığında iletilir.
401 alıyorum.
Token yok, süresi dolmuş, Bearer öneki eksik ya da token başka bir otele ait. Yeniden giriş yapıp tekrar deneyin. Girişte success: false alıyorsanız message alanına bakın: anahtar çifti hatalı veya otel yetkisi yok.
Oda listesi boş dönüyor veya roomCount 0.
Otelin online kanalı kapalı (errorCode 10003), satışa açık oda tipi yok (10004) ya da tarih/kişi kısıtları var. roomCount 0 olan odalarda roomRestrictionMessage nedeni söyler (minimum konaklama, girişe kapalı gün, fiyat tanımsız).
Rezervasyon aktardım ama panelde görünmüyor.
BookingPushRS içinde Error var mı kontrol edin. Hotel registration not found on HMS. otelin online kanala bağlı olmadığını, Could not register. genellikle geçersiz roomTypeID / ratePlanID ya da tutarsız tarih gönderildiğini gösterir.
Diğer modüllerin API’si ne zaman yayınlanacak?
Hotspot, Restoran POS, Spa, Yapay Zeka, TV ve Santral dokümantasyonları sırayla ekleniyor. Yayın tarihleri sürüm notlarında duyurulur; belirli bir modül için erken erişim isterseniz yazın.