Bağlanabilirlik menüsünden Satış kanalları'nı, ardından API partnerleri sekmesini açın. Partner hesapları seçeneğinde partnerin satabileceği tesisleri belirleyin ve API erişim bilgilerini oluşturun. Örneğin Antalya otellerinizi bir partnere açıp Bodrum otellerinizi kapalı tutabilirsiniz. Her hesap kendi erişim bilgilerini, rezervasyonlarını ve mutabakatını bir arada tutar.
API partneri, profiller ve açık tesisler
Her partner ilişkisi için bir API partneri oluşturun. API partneriyle birlikte sabit Varsayılan profil de oluşturulur.
Varsayılan profil, o anda yayında olan konaklama tesislerinin açık bir kopyasıyla başlar. Dinamik bir “tüm tesisler” kuralı değildir: daha sonra yayına alınan bir tesis siz açana kadar kapalı kalır.
Aynı API partnerinin farklı katalog kitlelerine ihtiyacı olduğunda ek profiller oluşturun. Yeni bir ek profil boş başlar. Profiller aynı tesisleri içerebilir. Profil; kaynak pazar, destinasyon kuralı, fiyat kuralı veya gezginin satış noktası değildir.
Her profilin açıkça belirlenmiş bir açık tesisler listesi vardır: o profile açık olan tesisler. Açık tesisler sekmesinden:
- Tek bir tesisi açabilir veya kapatabilirsiniz.
- Seçilen tesis grubuna aynı işlemi uygulayabilirsiniz.
- Ülkeye göre toplu aç ile bir ülkenin yayındaki tesislerini sayıp eşleşmeleri inceledikten sonra açıkça açabilirsiniz.
Bir tesisi kapatmak, onu yalnızca seçilen profilin kataloğundan ve müsaitlik sonuçlarından çıkarır. Tesisi silmez ve diğer profillerde kapatmaz.
Kimlikler API partnerine aittir
Bir API partneri; production, certification ve felaket kurtarma gibi farklı ortamlar için ayrı adlandırılmış birden çok kimlik taşıyabilir. Kimlikler API partnerine aittir, profile ait değildir. Partner profili API isteğinde seçer; seçim yapılmazsa Varsayılan profil kullanılır.
Aynı kimliği farklı API partnerlerinde kullanmayın. Ayrı kimlikler denetim, iptal ve kullanım kayıtlarını anlaşılır tutar.
Kimlik doğrulama yöntemi seçimi
| Yöntem | Hangi durumda uygun | Partner ne gönderir |
|---|---|---|
| OAuth 2.0 | Modern entegrasyonlar için önerilir. | client_id ve client_secret ile kısa ömürlü erişim token'ı alır; API çağrılarında token'ı gönderir. |
| HTTP Basic | Sabit kullanıcı adı ve parola gerektiren eski entegrasyonlar. | Her çağrıda username ve password gönderir. |
| API anahtarı | Hafif makineden makineye entegrasyonlar. | Her çağrıda uzun ömürlü tek bir bearer anahtarı gönderir. |
Gizli değer yalnızca bir kez gösterilir. Yalnızca kimlik oluşturulduğunda veya yenilendiğinde görünür. Ekrandan ayrılmadan önce bir secret manager'a kaydedin.
Erişim izinleri
Aynı izinler bütün kimlik doğrulama yöntemlerinde geçerlidir:
| İzin | Ne sağlar |
|---|---|
distribution:read |
Referans verileri, seçilen profilin tesis kataloğu, müsaitlik ve teklif araması. |
distribution:booking |
Ön rezervasyon, rezervasyonu kesinleştirme, hesap genelinde rezervasyon okuma, iptal bedeli özeti ve iptal. |
Yeni kimlikler varsayılan olarak iki izni da alır. Rezervasyon oluşturması
veya iptal etmesi gerekmeyen entegrasyonlarda yalnızca distribution:read
kullanın.
Partnerler destinasyon aramasında ne bulur?
distribution:read iznina sahip bir partner bir destinasyonda arama yapar ve
seçili profilin açık tesisleri arasındaki müsait tesisleri konaklama fiyatıyla
alır. Partner:
- Sonucu fiyat, yıldız ya da misafir puanına göre sıralayabilir.
- Sonucu yıldız, tesis tipi, tema, olanak, ilçe, harita alanı, misafir puanı, konaklama fiyatı, pansiyon planı ya da ücretsiz iptal ile daraltabilir.
- Her filtre seçeneği için sayı isteyebilir.
Partner bir sıralama ya da filtre gönderdiğinde destinasyonun tamamı sıralanır ve yanıt gerçek toplamı verir. İkisini de içermeyen bir arama, sonuçları toplam vermeden sayfa sayfa döndürür. Her tesis misafir puanını taşır. Mağazanızın Önerilen sıralaması ve öne çıkarma değerleriniz partnerlere hiçbir zaman gönderilmez. Bkz. Destinasyon araması.
Partner ödeme koşulları
API partnerinin ödeme koşulları, organizasyonunuza nasıl ödeme yapacağını belirler. Bunlar, fiyat planında misafire gösterilen ödeme koşullarından ayrıdır.
| Anlaşma | Rezervasyona etkisi |
|---|---|
| Hesaba yazılıp anlaşmadaki vadede ödeme | Uygun peşin ödemeli, ön ödemeli ve sanal kartlı fiyatlar partnerin hesabına yazılır. Partner bu rezervasyon isteği içinde misafir tahsilatı yapmaz. |
| Tesiste ödeme veya vadeli ödeme anlaşması bulunmaması | Bu fiyatlardan rezervasyon yapılamaz. Bir tesisi partnere açmanız her fiyatın rezerve edilebildiği anlamına gelmez. |
| Tur, transfer, uçuş ve paket | Partnerin hesaba yazılarak ödeme anlaşması gerekir. Pakette her hizmetin tedarikçiye karşı ödeme koşulları ayrıca korunur. |
Örneğin 200 EUR peşin ödemeli bir konaklama, vadeli çalışan partnerin hesabına yazılarak onaylanabilir. Bu onay, partnerin size ödeme yaptığı anlamına gelmez. Tesiste ödemeli konaklama kendi tahsilat koşullarını korur.
Rezervasyonda kullanılan koşullar kayıtta saklanır. Sonradan hesap ayarlarını değiştirmek eski rezervasyonları değiştirmez. Satışı açmadan önce ödeme dönemini, net veya komisyon esasını ve para birimini teyit edin; partner isteği bu koşulları değiştiremez. Vadeli ödeme anlaşması tek başına otomatik borç limiti kontrolü sağlamaz.
İstek sınırları ve büyüme
Partner trafiğini artırmadan önce geçerli istek sınırlarını Adrasis'teki ilgili kişiyle gözden geçirin. Bağlantı koşulları, kapsanan işlemi veya işlem grubunu, istek sayısını ya da hızını, hesap kapsamını ve zaman aralığını belirtir. Birden çok işlem aynı hesabın istek hakkını paylaşabilir. Kimlik oluşturmak veya yenilemek ya da profil eklemek yeni bir hak oluşturmaz.
İçgörülerden gözlenen istekleri, kanal hatalarını ve trafik eğilimlerini inceleyin. Kapasite değişikliğini görüşürken ilgili dönemi, etkilenen kanalları ve beklenen artışı paylaşın. Sınır ve değişiklikleri, üzerinde anlaşılan bağlantı koşulları belirler.
Tedarik partnerleri ve kanal yöneticileri kendi bağlantılarına ayrı sınırlar uygular. Adrasis kapasitesinin değişmesi bu sağlayıcı sınırlarını değiştirmez.
Yaşam döngüsü kontrolleri
Kimlikleri API partnerinin Kimlik bilgileri sekmesinden yönetin:
- Yenile, kimlik sabit kalırken gizli değeri değiştirir. Yeni değeri güvenli bir kanaldan paylaşın.
- Devre dışı bırak, kimlik doğrulamayı geçici olarak reddeder ve geri alınabilir.
- İptal et, kimliği kalıcı olarak sonlandırır. Entegrasyon yeniden açılacaksa yeni bir kimlik oluşturun.
API isteklerinde kimlik ve API partneri durumu denetlenir. Devre dışı bırakılan veya iptal edilen bir kimlik ve ondan daha önce üretilmiş OAuth token'ı, durum değişikliği yayıldığında çalışmayı durdurur.
Operatör kontrol listesi
- API partnerini oluşturun veya açın.
- Varsayılan profil ile varsa ek profilleri gözden geçirin.
- Her profilin açık tesisler listesinde gerekli tesisleri açın.
- Partnerin her ortamı için ayrı adlandırılmış bir kimlik oluşturun.
- En dar izin kümesini seçip tek sefer gösterilen gizli değeri güvenle kopyalayın.
- Kapsanan işlemleri ve istek sınırlarını Adrasis'teki ilgili kişiyle teyit edin.
- Partnerden çözümlenen profili doğrulamasını; içerik, arama, rezervasyon, uzlaştırma ve iptal testini tamamlamasını isteyin.
Sırada
- Konnektör entegrasyonlarını yapılandırın → Kanallar
- Yaygın partner API kullanım alanları → Otel karşılaştırma siteleri ve işletmelere satış
- Partnerlerin destinasyon sonuçlarını nasıl sıraladığı ve filtrelediği → Destinasyon araması