Partner API Erken erişim

Genel bakış

Juperion Partner API, iş ortaklarının Juperion'daki otel envanterini kendi sistemlerine bağlaması için hazırlanıyor. Şu an erken erişim aşamasındadır: bu sayfa kuralları ve planı anlatır, uç noktalar onaylandıkça yayımlanır.

Fiyatlar ve müsaitlik tek fiyat motorundan gelir; size yalnızca size açılan satış fiyatı görünür.
Her uç nokta açıkça onaylanır; onaylanmayan hiçbir işlem bu sayfada veya openapi.json'da yer almaz.
Önce test (sandbox) ortamında çalışırsınız; canlı erişim, testler tamamlandıktan sonra açılır.

Ortak kurallar

Para: her tutar küçük birimde tam sayıdır ve yanında ISO 4217 para birimi bulunur (örnek: 8100 + "EUR" = 81,00 EUR). Ondalık sayı ve kur çevirisi yoktur.
Tarihler: konaklama günleri otelin yerel takvimine göre YYYY-AA-GG; zaman damgaları UTC, ISO 8601.
Biçim: JSON (UTF-8). Bilinmeyen alanları yok sayın; yeni isteğe bağlı alanlar eklenebilir.

Modüller

Juperion birlikte veya ayrı lisanslanan modüllerden oluşur. API erişimi modül bazındadır: bir modülün uç noktalarını yalnızca o modülün lisansı olan hesaplar kullanabilir.

Rezervasyon çekirdeği (CRS)
Kontratlar, fiyat motoru, müsaitlik ve rezervasyonlar. Partner API'nin fiyat ve stok kaynağıdır; doğrudan çağrılmaz.
TemelAPI yok
Dağıtım (partner bağlantıları)
İş ortaklarına müsaitlik, fiyat ve rezervasyon. Bu sayfanın konusu.
Lisans gerekirAPI: erken erişim
Çağrı merkezi ve CRM
Müşteriler, talepler ve çağrı merkezi akışları.
Lisans gerekirAPI: planlanıyor
Telefon santrali
Hatlar, çağrılar ve çağrı kayıtları.
Lisans gerekirAPI: planlanıyor
E-posta
Kurumsal e-posta ve işlem e-postaları.
Lisans gerekirAPI: planlanıyor
WhatsApp ve e-posta komutları
Ek modül; yalnızca başka bir modülle birlikte.
Lisans gerekirAPI: planlanıyor
Reklam ve video
Reklam paneli ve video içerikleri.
Lisans gerekirAPI: planlanıyor
Fiyat karşılaştırma
Piyasa fiyatlarının düzenli karşılaştırması.
Lisans gerekirAPI: planlanıyor
Muhasebe
Cari hesaplar, ödeme planları ve faturalar.
Lisans gerekirAPI: planlanıyor

Kimlik doğrulama

Erken erişim Planlanan yöntem (erken erişim, değişebilir): API anahtarı ve kısa ömürlü erişim belirteci.

Size bir API anahtarı verilir. Anahtar yalnızca bir kez gösterilir; bizde yalnızca özeti (hash) saklanır. Kaybederseniz yenisi verilir, eskisi kısa bir geçiş süresinden sonra kapanır.
Anahtarınızla kısa ömürlü bir erişim belirteci alırsınız. Belirteç alma adresi erişimle birlikte iletilir.
Her istekte belirteci başlıkta gönderirsiniz: Authorization: Bearer <belirteç>. Belirtecin süresi dolunca yenisini alırsınız.
Her anahtarın kapsamları (ör. içerik, arama, rezervasyon) ve isteğe bağlı IP izin listesi vardır. Kapsam dışı bir istek 403 alır.

Authorization: Bearer <token>

Ortamlar

Test (sandbox): test anahtarlarıyla, test verisi üzerinde. Gerçek rezervasyon oluşmaz.
Canlı: testler tamamlanıp onaylandıktan sonra ayrı bir canlı anahtarla. Test anahtarı canlıda, canlı anahtar testte çalışmaz.

Anahtarları kodda, istemci tarafında veya bir sürüm deposunda tutmayın. Anahtarlar bu sayfadan verilmez.

Hatalar

Her hata aynı biçimdedir. Mesajlar sabit ve tarafsızdır; programınız code alanına göre karar vermelidir.

{
  "error": {
    "code": "validation_error",
    "message": "Invalid request",
    "requestId": "3f2c9a1e-…",
    "fields": { "rooms[0].adults": "required" }
  }
}

HTTP	code	Anlamı
`400`	`validation_error`	İstek geçersiz; fields hangi alanın neden reddedildiğini söyler.
`401`	`unauthorized`	Belirteç yok, geçersiz veya süresi dolmuş.
`403`	`forbidden`	Anahtarın bu işlem için kapsamı veya izni yok.
`404`	`not_found`	Kayıt yok ya da size açık değil.
`409`	`price_changed · unavailable · conflict`	Fiyat değişti, oda artık satılamıyor ya da aynı Idempotency-Key farklı bir istekle kullanıldı.
`429`	`rate_limited`	İstek sınırı aşıldı; Retry-After saniye kadar bekleyin.
`5xx`	`—`	Geçici sorun; artan aralıklarla tekrar deneyin.

Sorun bildirirken requestId değerini iletin. Kod listesi uç noktalarla birlikte kesinleşir; yeni kodlar eklenebilir.

Idempotency-Key

Rezervasyon ve iptal isteklerinde Idempotency-Key başlığı zorunlu olacaktır. Ağ hatasında aynı anahtarla güvenle tekrar deneyebilirsiniz; işlem iki kez yapılmaz.

Idempotency-Key: 6f1d2b7e-5c1a-4b8e-9d0f-2a7c4e9b1d33

8–100 karakter; her yeni rezervasyon veya iptal denemesi için yeni bir değer (ör. UUID).
Aynı anahtar + aynı istek gövdesi: ilk yanıt aynen döner.
Aynı anahtar + farklı gövde: 409 ile reddedilir.
İlk istek hâlâ işleniyorsa: 409; kısa bir süre sonra tekrar deneyin.

İstek sınırları

Sınırlar anahtar başınadır ve iş ortağıyla birlikte belirlenir.

Planlanan varsayılan: anahtar başına dakikada 60 istek. Arama, okuma isteklerinden daha ağır sayılabilir.
Sınır aşılınca 429 ve Retry-After başlığı döner; o süre dolmadan tekrar denemeyin.
Günlük kota, lisans planına göre ileride eklenebilir; eklenirse burada duyurulur.

Sürümleme

Sürüm adreste yer alır: /v1/…

v1 içinde yalnızca ekleme yapılır: yeni uç noktalar, yeni isteğe bağlı alanlar, yeni değerler. Tanımadığınız alanları ve değerleri yok sayın.
Geriye uyumsuz bir değişiklik yeni bir sürümle (/v2) gelir; v1 bir süre onunla birlikte çalışır.
Kaldırılacak bir işlem önceden duyurulur ve yanıtlarda Deprecation / Sunset başlıklarıyla işaretlenir.

Uç noktalar

Bu bölüm openapi.json belgesinden üretilir. Yalnızca partnerler için onaylanmış işlemler görünür.

openapi.json indir

Erken erişim

Henüz yayımlanmış uç nokta yok. Onaylanan her uç nokta burada ve openapi.json'da görünür; test erişimi talep üzerine verilir.

Erken erişimde kapalı

Değişiklik günlüğü

29.10.2026 İlk yayın: belgeler sayfası ve openapi.json (erken erişim, uç nokta henüz yok).

Erişim talebi

Erken erişime katılmak için bize yazın. Lütfen şunları ekleyin:

Şirket adı, web adresi ve teknik iletişim kişisi
Kullanım şekli: bizden mi çekeceksiniz (arama, rezervasyon), yoksa bize mi göndereceksiniz
Beklenen istek hacmi ve hedef pazarlar
Kendi bağlantı belirtiminiz varsa bağlantısı veya dosyası

E-posta: system@juperion.dev

Bu sayfada giriş, anahtar üretimi veya veri yoktur. Erişim, incelemeden sonra e-postayla iletilir.