Genel Bakış
Cloudbeds Marketplace uygulaması (örneğin, self check-in sağlayıcısı, kanal yöneticisi veya muhasebe sistemi) kullanıyorsan ve başarısız veri eşitlemeleri, kimlik doğrulama hataları ya da eksik bilgiler yaşıyorsan, sorunun kaynağı süresi dolmuş veya eksik erişim/yenileme token’ı olabilir.
Bu token’lar, uygulamanın Cloudbeds ile güvenli iletişim kurması için gereklidir; token’lar süresi dolduğunda veya geçersiz hale geldiğinde bağlantı kopar.
Bu makale, uygulamayı yeniden yetkilendirme, bağlantıyı test etme ve gerekirse Destek için detay toplama adımlarını anlatır.
Yaygın Belirtiler
- Entegre uygulamanın işlevleri (örn. giriş süreci, rezervasyon eşitleme, raporlama) başarısız olur veya tetiklenmez.
- Uygulama kimlik doğrulama hatası, token sorunu veya “yetkisiz” hatası bildirir.
- Daha önce başarılı kullanıma rağmen Cloudbeds’den yeni veri eşitlenmiyor gibi görünür.
- İş ortağı sisteminden gelen spesifik hata mesajları, örn.:
- HTTP 401:
{ "error": "server_error", "error_description": "Yetkilendirme kodu geçersiz veya süresi dolmuş." } - HTTP 200:
{ "success": false, "message": "Bu bağlantıyı onaylayan kullanıcı artık aktif değil" }
- HTTP 401:
Çözüm Adımları
Adım 1: Yeni bir token oluşturmak için uygulamayı yeniden yetkilendir
Erişim ve yenileme token’ları yalnızca ilk bağlantı veya yeniden yetkilendirme sırasında oluşturulur. Token kaybolduysa veya süresi dolduysa, en hızlı çözüm Cloudbeds hesabında uygulamayı bağlantısını kesip yeniden bağlamaktır. Bu işlem yeni geçerli bir erişim ve yenileme token’ı oluşturur.
-
Hesap Menüsü
→ Uygulamalar & Marketplace
→ Bağlı Uygulamalar sayfasına git.
- Sorunlu uygulamayı listede bul (örn. Trevo, Sweeply)
- Bağlantıyı Kes seçeneğine tıkla ve işlemi onayla.
- Bağlan seçeneğine tıkla ve uygulamaya özel ekrandaki yetkilendirme adımlarını takip et. Genellikle iş ortağı platformuna giriş yapmak veya izinleri onaylamak gerekir.
Bu işlem Cloudbeds’in tamamen yeni bir erişim ve yenileme token’ı oluşturmasını sağlar.
Adım 2: Bağlantıyı test et
- Cloudbeds PMS’de ilgili bir test vakası aç (örn. kendi kendine giriş uygulaması için bir test rezervasyonu oluştur veya bir raporlama uygulaması için veri eşitlemesini tetikle).
- Daha önce başarısız olan akışı veya işlemi çalıştır (örn. giriş başlat, eşitlemeyi zorla).
- Hatanın olmadan tamamlandığını ve verilerin beklendiği gibi eşitlendiğini doğrula.
Bu, yeni token’ın geçerli olduğunu ve beklenen şekilde çalıştığını garanti eder.
Adım 3: Sorun devam ederse
Yeniden yetkilendirme sorunu çözmezse, Cloudbeds destek ile iletişime geç ve aşağıdaki bilgileri ekle:
- Cloudbeds Tesis kimliğin
- Uygulamayı yeniden yetkilendirdiğin yaklaşık tarih ve saat
- Yeniden bağlantı sonrası sorun yaşanan yakın tarihli bir rezervasyon numarası (veya ilgili başka bir kimlik)
Ayrıca, iş ortağının destek ekibinden (örn. Trevo Destek, Sweeply Destek) şunları talep et:
- Başarısız token kullanımı veya hata mesajlarını gösteren API istek ve yanıt kayıtları. Bu kayıtlar, Cloudbeds Entegrasyon Ekibinin sorunu tespit etmesine yardımcı olur.
Sıkça Sorulan Sorular
Cloudbeds Marketplace tokenları neden süresi dolar veya kaybolur?
Erişim ve yenileme tokenları, hareketsizlik veya güvenlik sıfırlamaları sonrası süresi dolabilir. Ayrıca, bağlantıyı ilk yetkilendiren Cloudbeds kullanıcısı pasif hale gelirse tokenlar geçersiz olur. Bu durumlarda, aktif bir kullanıcı ile yeniden bağlanmak gerekir.
Token süresi dolması diğer Cloudbeds entegrasyonlarını veya bağlı uygulamaları etkiler mi?
Evet. Token tabanlı kimlik doğrulama (OAuth 2.0) kullanan çoğu diğer Cloudbeds Marketplace uygulaması için de aynı sorun giderme süreci geçerlidir: bağlantıyı kesip yeniden bağlamak. Bir iş ortağı "Yetkilendirme kodu geçersiz veya süresi dolmuş" ya da "Bu bağlantıyı onaylayan kullanıcı artık aktif değil" gibi hatalar bildirirse, genellikle yeniden yetkilendirme gerekir.
Cloudbeds Marketplace tokenlarından farklı bir kimlik doğrulama yöntemi kullanan entegrasyonlar var mı?
Evet, bazı entegrasyonlar farklı kimlik doğrulama yöntemleri kullanabilir. Örneğin, Omniboost entegrasyonları farklı şekilde yönetilir. Emin değilsen, her zaman ilgili entegrasyon kılavuzlarına bak veya Cloudbeds destek ile iletişime geç.
Cloudbeds uygulamasında “Uygulamanın ConnectionTokenProvider’ı sağlanan tamamlanma bloğunu 60 saniye içinde çağırmadı” hatası ne anlama gelir?
Bu mesaj, Cloudbeds mobil uygulaması sunuculara bağlanmaya çalışırken güvenli bağlantı sürecini tamamlamasının 60 saniyeden uzun sürmesi durumunda görünür. Genellikle ödeme okuyucu (örneğin Stripe veya Cloudbeds Payments) kullanılırken ortaya çıkar ve çoğunlukla zayıf ağ sinyali, geçici sunucu gecikmesi veya okuyucu bağlantı sorunu nedeniyle olur.
Aşağıda uygulamada hatanın nasıl göründüğüne dair bir örnek bulunmaktadır:
Olası Nedenler
- Kararsız veya zayıf Wi-Fi/hücresel bağlantı.
- Bağlantı sürecinde uygulamanın küçültülmesi veya kesintiye uğraması.
- Ödeme okuyucusunun bağlantısının kopması veya doğru eşleştirilmemesi.
- Sunucu tarafında bağlantı token’ının oluşturulmasında geçici gecikme.
Çözüm Adımları
- Cloudbeds mobil uygulamasını zorla kapatıp yeniden aç.
- Cihazın güçlü bir Wi-Fi veya hücresel sinyale sahip olduğundan emin ol ve tekrar dene.
- Ödeme okuyucusunun açık ve doğru şekilde eşleştirilmiş olduğunu kontrol et.
- Cloudbeds uygulamasını en son sürüme güncelle.
Bu adımlardan sonra sorun devam ederse, lütfen Cloudbeds destek ile iletişime geç ve uygulama sürümü, okuyucu modeli ile hatanın ne zaman ortaya çıktığını ekle ki ekibimiz sana daha iyi yardımcı olabilsin.
Daha fazla yardıma veya bilgiye ihtiyacın olursa, Destek ekibimiz yardımcı olmaya hazır!
Yorumlar
Yorum yazmak için lütfen oturum açın: oturum aç.