Uygulamalar ve Entegrasyonlar - Self-servis API

Bu Hızlı Başlangıç Kılavuzu, Cloudbeds API kaynaklarına erişmek 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ı olur.

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 iş ortağı düzeyinde API Anahtarları desteğini uygulaman gerekir.

OAuth 2.0 kimlik doğrulama yöntemi için, bkz. Alternatif OAuth 2.0 kimlik doğrulama yöntemi.

Cloudbeds paket ve büyüme destek simgesi Cloudbeds, her konaklama işletmesinin benzersiz olduğuna inanır. İşletmeni kurmana ve büyütmene yardımcı olmak için farklı tesis büyüklükleri ve bütçeleri için araçlar sunuyoruz. Mevcut paketler hakkında daha fazla bilgi için özel ekibimizle iletişime geç.

Henüz Cloudbeds müşterisi değil misin? Fiyatlandırma Kılavuzumuzu incele ve bir demo planla.

 

API kimlik bilgilerini oluşturmadan önce

API kimlik bilgilerini oluşturmadan önce, Cloudbeds'de API Kimlik Bilgileri sayfasını aç. Bu sayfada gördüklerin, API erişiminin Cloudbeds paketinde zaten dahil olup olmamasına bağlıdır.

API erişimi paketinde yoksa: Kimlik bilgisi oluşturma seçenekleri yerine API Erişim Formunu Gönder butonunu görürsün. API erişimi talep etmek ve Müşteri Büyüme Ekibinden fiyat teklifi almak için formu gönder.

Aşağıdaki örnek, API erişiminin henüz talep edilmesi gereken durumda API Kimlik Bilgileri sayfasını gösterir.

API erişimi ve fiyatlandırma talebi için API Erişim Formunu Gönder butonunu gösteren Marketplace API Kimlik Bilgileri sayfası

API erişimi hesabın için etkinleştirildikten sonra, API Kimlik Bilgileri sayfasına geri dön ve aşağıdaki adımlara devam et.

1. API Kimlik Bilgileri Oluşturma

API anahtarlarının oluşturulma sürecini anlamak için bu videoyu oynat

API erişimi etkinleştirildikten sonra, önce entegrasyonu oluştur. Ardından API anahtarını oluştur, gerekli izinleri ve tesisleri seç ve bağlantıyı yetkilendir.

  1. Cloudbeds hesabına https://signin.cloudbeds.com/ adresinden giriş yap ve şu adımları takip et:

    HesapHesap menüsü simgesi -> Uygulamalar ve MarketplaceUygulamalar ve Marketplace simgesi

  2. API Kimlik Bilgileri sekmesini aç.
  3. + Yeni Kimlik Bilgisi butonuna tıkla.

    API Kimlik Bilgileri sayfasında mevcut entegrasyonların ve yeni bir entegrasyon başlatmak için kullanılan + Yeni Kimlik Bilgisi butonu görüntülenir.

    Marketplace API Kimlik Bilgileri sekmesi, API Kimlik Bilgileri tablosu ve + Yeni Kimlik Bilgisi butonunu gösteriyor

    Daha önce oluşturduğun İstemci Kimlik Bilgilerini dönüştürmek istersen düzenleyebilirsin. Bu durumda 6. adıma geç.

  4. Yeni API entegrasyon detaylarını tamamla:

    1. Entegrasyonunun veya uygulamanın Adını gir.
    2. Uygulamanla en uyumlu olan Entegrasyon Türünü seç.
    3. API Anahtarı kullanımı işleyen bir Yönlendirme URL'si gerektirmediği için, Yönlendirme URI alanına https://localhost yazabilirsin.
    4. Entegrasyonun organizasyondaki birden fazla tesiste kullanılabilir olmasını istiyorsan Tüm Organizasyon İçin Etkinleştir seçeneğini aç.
    5. Sağ alt köşedeki Kaydet butonuna tıkla.

    Yeni API Entegrasyon formunda entegrasyon adı, türü, yönlendirme URI'si ve organizasyon genelinde etkinleştirme ayarı bulunur.

    Yeni API Entegrasyon formu, Ad, Entegrasyon Türü, Yönlendirme URI'si ve Tüm Organizasyon İçin Etkinleştir ayarlarını gösteriyor

  5. Cloudbeds, İstemci Kimliği ve İstemci Gizli Anahtarı içeren İstemci Kimlik Bilgileri oluşturur. Bu özellikler API anahtarı etkin isteklerin veri yükünde gerekli olmadığından, iletişim kutusunu kapatabilir ve API anahtarı oluşturma işlemine devam edebilirsin.

    Onay iletişim kutusu ayrıca İstemci Gizli Anahtarının iletişim kutusu kapandıktan sonra tekrar görüntülenemeyeceğini hatırlatır.

    API Kimlik Bilgileri Oluşturuldu iletişim kutusu, İstemci Kimliği ve İstemci Gizli Anahtarı alanlarını ve iletişim kutusu kapandıktan sonra İstemci Gizli Anahtarının tekrar görüntülenemeyeceği hatırlatmasını gösteriyor

  6. API Kimlik Bilgileri tablosunda entegrasyonu bul. API Anahtarı sütununda Oluştur'a tıkla.

    Yeni oluşturulan entegrasyon, bir API anahtarı oluşturulmadan önce API Kimlik Bilgileri tablosunda bir satır olarak görünür.

    API Kimlik Bilgileri tablosunda oluşturulan entegrasyon ve API Anahtarı sütunundaki Oluştur düğmesi

  7. İstediğin satırdaki Oluştur düğmesine tıkladığında, seçebileceğin API Kapsamları listesini göreceksin.

    Kapsam seçimleri, kullanmayı planladığın API uç noktalarıyla uyumlu olmalıdır. Daha fazla bilgi için Cloudbeds API Hakkında sayfasına bakabilirsin.

  8. Gerekli kapsamları her izni işaretleyerek seç, ardından Oluştur'a tıkla.

    Yeni API Anahtarı iletişim kutusu, mevcut Okuma, Yazma ve Silme izinlerini API kapsamına göre gruplar.

    Yeni API Anahtarı iletişim kutusunda Okuma, Yazma ve Silme seçenekleriyle mevcut izin kapsamları ve Oluştur düğmesi

  9. Uygulamanın bağlanmasını istediğin tesisleri seç. Tüm tesislere bağlan seçeneğini işaretleyerek organizasyon içindeki tüm tesisler için geçerli anahtarlar oluşturabilir ve ardından Devam Et'e tıkla.

    Uygulama Yetkilendirme sayfasında Tüm tesislere bağlan veya Belirli tesislere bağlan seçenekleri ve Devam Et düğmesi

  10. Uygulamanın talep ettiği izinleri incele, ardından Erişime İzin Ver'e tıkla.

    Yetkilendirme sayfası, erişim verilmeden önce uygulamayla paylaşılacak izin kapsamlarını listeler.

    Uygulama Yetkilendirme sayfasında uygulamanın talep ettiği API izinleri ve Erişime İzin Ver düğmesi

  11. Cloudbeds, yetkilendirmeden sonra API Anahtarını oluşturur.

    API Anahtarını hemen Kopyala ve güvenli bir yerde sakla. Tam API Anahtarı yalnızca oluşturulduğunda görüntülenir. Diyaloğu kapattıktan sonra bu API Anahtarını tekrar görüntüleyemezsin. Onu güvenli bir kimlik bilgisi yöneticisinde veya başka güvenli bir yerde sakla.

    API Anahtarı Oluşturuldu diyaloğu, anahtarı ve diyaloğu kapattıktan sonra tekrar görüntülenemeyeceğine dair hatırlatmayı gösterir.

    API Anahtarı Oluşturuldu diyaloğu, oluşturulan API Anahtarını ve diyaloğu kapattıktan sonra tam anahtarın tekrar görüntülenemeyeceğine dair uyarıyı gösteriyor

2. API Anahtarını Kullanma

Artık API anahtarını, x-api-key olarak veya bearer token şeklinde istek üst bilgisinde (header) dahil ederek Cloudbeds API’ye 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

Bir anahtarı istediğin zaman kaldırabilir veya yeniden oluşturabilirsin. API Kimlik Bilgileri tablosunda, ilgili anahtar için API Anahtarı sütununu bul ve anahtar için mevcut işlemi kullan.

API Kimlik Bilgileri tablosu, oluşturulduktan sonra kaydedilen API anahtarını gizli tutar.

API Kimlik Bilgileri tablosunda gizlenmiş API anahtarı ve API Anahtarı sütunundaki mevcut işlemler gösteriliyor

Bir anahtar kaldırıldığında veya yeniden oluşturulduğunda, eski anahtar API’ye erişim için artık kullanılamaz.

SSS

API Anahtarlarının süresi dolar mı?

Hayır, en az 30 günde bir kez kullanıldığı sürece süresi dolmaz.

API anahtarı oluşturulduktan sonra ek izin kapsamları nasıl eklenir?

API Kimlik Bilgileri sekmesine eriş, ilgili API kimlik bilgileri için API Anahtarı sütununu bul ve API anahtarını silmek için Çöp Kutusu düğmesine tıkla.

Silindikten sonra, doğru izin kapsamlarıyla yeni bir API anahtarı oluşturabilirsin.

API anahtarları Postman’da nasıl eklenir?

API anahtarını Postman Yetkilendirme sekmesinde API key veya Bearer token olarak dahil edebilirsin.

API anahtarları, tesis düzeyinde organizasyon/grup hesapları için destekleniyor mu?

Organizasyon kullanıcıları, birden fazla tesis için API erişimini etkinleştirmek istediklerinde, API Kimlik Bilgileri Oluşturmanın 4. adımında Tüm Organizasyon İçin Etkinleştir seçeneğini işaretleyebilirler. Yetkilendirme sırasında, uygulamanın bağlanacağı tesisleri seçebilirler.

API anahtarlarını güvende tut. Cloudbeds, API anahtarlarının GitHub veya GitLab gibi herkese açık depolarda ifşa edilmemesi için makul önlemler alır. Bir API anahtarı kamuya açık şekilde ifşa edilirse, Cloudbeds anahtarı devre dışı bırakabilir ve entegrasyonunu güncellemek için yeni bir anahtar oluşturmanı isteyebilir.

Bu makale yardımcı oldu mu?
18 kişi içerisinden 9 kişi bunun yardımcı olduğunu düşündü

Yorumlar

0 yorum

Yorum yazmak için lütfen oturum açın: oturum aç.