Bu Hızlı Başlangıç Kılavuzu, Cloudbeds API kaynaklarına erişim için gereken API Anahtarı Kimlik Doğrulaması hakkında temel bilgiler sağlar. Bu kılavuz, kimlik doğrulamanızda kullanmaya başlamak için hızlıca bir API Anahtarı almanıza yardımcı olacaktır.
Bir teknoloji iş ortağıysan, geliştirmene hızlıca başlamak için tesis düzeyinde bir API Anahtarı oluşturabilirsin. Ancak, sertifikasyon sürecinden önce Teknoloji İş Ortakları için API Anahtarları Kimlik Doğrulama Kılavuzuna göre API Anahtarları desteğini iş ortağı düzeyinde uygulaman gerekecek.
OAuth 2.0 kimlik doğrulama yöntemi için lütfen Alternatif OAuth 2.0 kimlik doğrulama yöntemi makalesine bak.
Cloudbeds, her konaklama işletmesinin benzersiz olduğuna inanır. İşini kurmana ve büyütmene yardımcı olmak için her boyutta ve bütçede araçlar sunuyoruz. Daha fazla bilgi için özel ekibimizle iletişime geç. Henüz bir Cloudbeds müşterisi değil misin? Fiyatlandırma Rehberimize göz atabilir ve demo programlayabilirsin.
1. API Kimlik Bilgileri Oluşturma
API Anahtarları oluşturma sürecini anlamak için bu videoyu oynat
API erişiminiz olduğunda, aşağıdaki adımları izleyerek API kimlik bilgilerinizi oluşturabilirsin:
- Cloudbeds hesabına https://signin.cloudbeds.com/ adresinden giriş yap ve şu adımları takip et:
Hesap-> Uygulamalar ve Marketplace
- Üst menüyü kullanarak API Kimlik Bilgileri Sayfası'na git.
-
+ Yeni Kimlik Bilgisi butonuna tıkla.
Daha önce oluşturduğun bir Client Kimlik Bilgisi'ni düzenlemek istersen, bu adımı atlayıp 6. adıma geçebilirsin.
-
Bilgileri doldur:
- Entegrasyonun veya uygulamanın adını gir.
- Uygulamanla en iyi eşleşen kategoriyi açılır menüden seç.
- API Anahtarı kullanımı işlevsel bir Yönlendirme URL'si gerektirmediğinden, Yönlendirme URI alanına “https://localhost” yazabilirsin.
- Tüm organizasyon için etkinleştir seçeneğini işaretlersen, birden fazla tesis için tek bir API Anahtarı kullanabilirsin. İstersen bazıları için, istersen hepsi için.
- Sağ alt köşedeki Kaydet butonuna tıkla.
-
Karşına Client ID ve Paylaşılan Gizli Anahtar şeklinde Client Kimlik Bilgileri içeren bir modal pencere çıkacak. Bu özellikler API anahtarı ile yapılan isteklerin veri yükünde gerekli olmadığından, bu pencereyi Kapatabilir ve bu parametreleri göz ardı edebilirsin.
-
API Kimlik Bilgileri tablosundan yeni oluşturduğun kaydı seç, sağa kaydırarak API Anahtarı sütun başlığını görün ve istediğin satırdaki Oluştur butonuna tıkla.
-
İstediğin satırdaki Oluştur butonuna tıkladığında, seçebileceğin API Kapsamları listesini göreceksin.
Kapsam seçimlerin, entegrasyonunda kullanmayı planladığın API uç noktalarıyla uyumlu olmalı. Bunları Cloudbeds API Hakkında dokümantasyonunda bulabilirsin.
-
Gerekli kapsamları, her izni işaretleyip sağ alt köşedeki Oluştur düğmesine tıklayarak seçin.
-
Bu anahtarın hangi Tesisler için geçerli olacağını seçin. "Tüm Tesislere Bağlan" geçiş düğmesini açarak, organizasyon içindeki tüm tesislerde çalışan anahtarlar oluşturabilirsiniz.
- Cloudbeds giriş bilgilerini girmen ve seçili izin kapsamlarını onaylaman istenecek.
‼️ Ardından, yalnızca bu işlem sırasında gösterilen API Anahtarı karşına çıkacak. API Anahtarını kopyalayıp, entegrasyon kodunda güvenli bir kimlik bilgisi deposunda veya güvenli bir tesis olarak saklamalısın. Bu iletişim kutusu kapandıktan sonra API Anahtarı tekrar görüntülenemez.
2. API Anahtarını Kullanma
Artık API Anahtarını, x-api-key başlığı olarak veya bearer token şeklinde isteğe ekleyerek Cloudbeds API’sine erişmek için kullanabilirsin.
İşte bazı örnekler:
curl --location '<https://hotels.cloudbeds.com/api/v1.2/getHotels'> \--header 'Authorization: Bearer cbat_EE*** ' \
curl --location '<https://hotels.cloudbeds.com/api/v1.2/getHotels'> \--header 'x-api-key: cbat_EE*** ' \
3. API Anahtarını Silme veya Değiştirme
API Kimlik Bilgileri tablosunda, API Anahtarı sütununda istediğin zaman bir anahtarı kaldırabilir veya yeniden oluşturabilirsin; bunun için yeniden oluştur veya çöp kutusu simgelerine tıklaman yeterlidir.
Bir anahtar kaldırıldığında veya yeniden oluşturulduğunda, eski anahtar API erişimi için artık kullanılamayacağını unutma.
4. SSS (Sıkça Sorulan Sorular)
API Anahtarlarının süresi dolar mı?
En az 30 günde bir kullanıldığı sürece süresi dolmaz.
Bir API Anahtarı oluşturulduktan sonra ek izin kapsamları nasıl eklenir?
API Kimlik Bilgileri sekmene gidip ilgili API kimlik bilgilerinin API Anahtarı sütununu bulman ve API anahtarını silmek için Çöp Kutusu düğmesine tıklaman gerekir.
Silindikten sonra, doğru izin kapsamlarıyla yeni bir API Anahtarı oluşturabilirsin.
Postman'de API Anahtarları nasıl eklenir?
API anahtarını Postman Yetkilendirme sekmesinde 'API key' veya 'Bearer token' olarak ekleyebilirsin.
Tesis düzeyinde organizasyon/grup hesapları için API Anahtarları destekleniyor mu?
Organizasyon kullanıcıları, organizasyondaki tüm tesisler için API erişimini etkinleştirmek isterse, yukarıdaki 4.iv maddesinde açıklandığı gibi "Tüm organizasyon için etkinleştir" kutusunu işaretlemelidir.
Cloudbeds, API anahtarlarının halka açık depolarda (Github, Gitlab vb.) ifşa edilmemesi için makul çabalar gösterir. Bir API anahtarı kamuya açık şekilde ifşa edilirse, bu anahtarı devre dışı bırakma ve yeni bir Anahtar oluşturmanı ve yetkisiz tarafların yeni anahtarı görmesini engellemek için kodunu güncellemeni talep etme hakkımız saklıdır.
- Politikalar, fiyatlandırma ve kullanım senaryoları hakkında daha fazla bilgi için şu makaleye bak: Tesis ve Grup Hesabı API Erişimi.
Yorumlar
Yorum yazmak için lütfen oturum açın: oturum aç.