İçeriğe atla
Geliştirici portalı ile Partner API

Sistemlerin doğrudan STRYK'ta okur ve yazar.

Kendi rezervasyon sayfan, bir gelir aracın ya da ajansının housekeeping uygulaması: Partner API bunları otelinin rezervasyonlarına, fiyatlarına, müsaitliğine ve oda durumuna bağlar. Her API anahtarının neyi yapabileceğine sen karar verirsin. Referansı, kılavuzları ve kod örneklerini geliştirici portalında açık olarak yayınlıyoruz, böylece geliştiricilerin dolanmadan başlayabilir.

Partner API referansı, yetkiler ve webhook'lar: Geliştirici portalını aç

Okuma ve yazma

Rezervasyonlar, günlük fiyatlar, müsaitlik, temizlik durumu ve banka havaleleri.

İmzalı webhook'lar

STRYK rezervasyonlar, misafirler, fiyatlar, ödemeler ve odalardaki değişiklikleri bildirir.

Kapsamlı anahtarlar

Her anahtar tek bir otele aittir, yetkileri, son kullanma tarihi ve IP izin listesi vardır.

Açık dokümantasyon

Hızlı başlangıç, kılavuzlar ve OpenAPI referansı Almanca ve İngilizce olarak.

Okuma ve rezervasyon

Otelinin gerçek fiyatlarıyla hesaplayan bir rezervasyon sayfası.

Partner API otel, oda tiplerini, birimleri, müsaitliği ve günlük fiyatları sunar. Bir talep için STRYK, Booking Engine ile aynı kurallara göre konaklama vergisi ve zorunlu ek hizmetlerle birlikte bir teklif hesaplar. Rezervasyonu Idempotency-Key ile oluşturursun. İstersen STRYK misafire alışılmış onay e-postasını gönderir.

  • Sunucu tarafında hesaplanmış fiyatla teklif
  • Rezervasyon oluştur, değiştir ve iptal et
  • Misafirleri, ödeme durumunu ve düzenlenen faturaları oku
  • Otelin kendi koşullarına göre iptal
Fiyatlar ve müsaitlik

Gelir yönetim aracın, günlük fiyatları doğrudan fiyat takviminde ayarlar.

rates:write ile bir araç, oda tipi başına günlük fiyatları çağrı başına en fazla 366 gün için yazar. Oda tiplerinin en düşük ve en yüksek fiyatları geçerli kalır, boş bırakılan bir fiyat ise günü fiyat kurallarına geri döndürür. availability:write ile kapatmalar, kontenjanlar ile varış ve ayrılış kısıtlamaları oluşturur ve yalnızca kendi oluşturduğu kayıtları silebilir. Ekibinin kapatmaları sende kalır.

  • rates:write, oda tipi başına günlük fiyatlar
  • availability:write, kapatmalar ve kontenjanlar için
  • Oda tipi sınırları geçerli kalır
  • Her fiyat değişikliği, anahtar kimliğiyle günlüğe kaydedilir
STRYK Preise: Die Rezeption legt eine Preisregel an, die das Panorama Studio freitags und samstags um 10 % erhöht. Nach dem Speichern zeigt der Preiskalender sofort die neuen Wochenendpreise.
Oda ve ödemeler

Oda durumu housekeeping uygulamasından, banka havaleleri muhasebeden gelir.

property:write ile bir uygulama, bir ünitenin temizlik durumunu ayarlar, örneğin kirliden kontrol edildi durumuna geçirir. If-Match eski durumlara karşı korur, doluluk, kapatmalar ve ana veriler STRYK'ta kalır. payments:write ile bir sistem, alınan bir banka havalesini düzenlenen faturaya, yalnızca açık tutar kadar kaydeder.

  • Sürüm kontrollü temizlik durumu
  • Düzenlenen faturaya banka havalesi
  • Faturalar STRYK'ta belge olarak kalır
  • Tekrarlanan çağrılar idempotency ile güvence altında
STRYK Housekeeping: Ewa Nowak öffnet Zimmer 105, startet die Reinigung, hakt die vier Punkte der Checkliste ab und schließt sie ab. Das Zimmer steht erledigt für die Anreise bereit.STRYK Housekeeping: Eine Reinigungskraft öffnet Zimmer 105, hakt die Aufgaben ab und schließt das Zimmer ab. Es steht fertig für die Anreise bereit.
Anahtarlar ve webhook'lar

Kimin erişeceğine sen karar verirsin. STRYK neyin değiştiğini bildirir.

Bir yönetici Kanallar → API altında bir API anahtarı oluşturur. Her alan için kapsamlar, bir son kullanma tarihi ve isteğe bağlı bir IP izin listesi tanımlanır. Anahtar döndürülürken eski anahtar 24 saat geçerli kalır ya da hemen sona erer. booking.created, rate.changed veya unit.updated gibi webhook'ları STRYK HMAC-SHA256 ile imzalar, hatalarda yeniden gönderir ve teslim günlüğünde listeler.

  • Yazma yetkisi okuma yetkisini de kapsar
  • Varsayılan olarak dakikada 120 istek
  • “Yeniden gönder” seçeneğiyle teslim günlüğü
  • Anahtarlar istediğin zaman iptal edilebilir
Bina teknik altyapısı

Kapı kilidi, telefon, televizyon ve WLAN STRYK ile birlikte çalışır.

Partner API yanında STRYK, otelinin teknik altyapısını da bağlar. Check-in, oda değişikliği ve check-out anahtarları, telefon santralini, otel televizyonunu ve WLAN erişimini etkiler; resepsiyonun hiçbir şeyi iki kez girmesi gerekmez.

Fikirden çalışan bir bağlantıya kadar.

Geliştiricilerinle birlikte nasıl ilerlersin

  1. 01

    Anahtar oluştur

    Yönetici, bağlantının ihtiyaç duyduğu kapsamları seçer. STRYK anahtarı bir kez gösterir.

  2. 02

    Referansa karşı geliştir

    Geliştiricilerin hızlı başlangıç ve JavaScript ya da Python kod örnekleriyle başlar.

  3. 03

    Okuma yetkisiyle başla

    Önce okuma, ardından yazma çağrılarını otelle kararlaştırılmış test verileriyle sına.

  4. 04

    Webhook'ları bağla

    İmzalı olaylar, bağlanan sistemi STRYK ile aynı durumda tutar.

Bununla kimler çalışır.

Geliştiriciler ve ajanslar

Rezervasyon sayfaları, senkronizasyon hizmetleri ve araçlar, belgelenmiş bir OpenAPI referansına karşı geliştirilir.

Yönetici ve admin

Anahtarları yalnızca gereken yetkilerle verir, bir iş birliği sona erdiğinde iptal eder.

Gelir ve housekeeping

Alışık oldukları araçta çalışmaya devam eder, fiyatlar ve oda durumu doğrudan STRYK'a ulaşır.

Sık sorulanlar: API ve entegrasyonlar

Teknik dokümantasyonu nerede bulabilirim?

STRYK geliştirici portalında /developers adresinde: başlangıç, kimlik doğrulama, yetkiler, uç noktalar, webhook'lar, hatalar ve hız sınırı. Kasa arayüzünün OpenAPI referansı orada YAML ve JSON olarak bulunur.

Partner API neler yapabilir?

Otel, kategoriler, birimler, fiyatlar, müsaitlik ve günlük fiyatları okur, fiyat teklifi hesaplar, rezervasyonları okur, oluşturur ve iptal eder; iletişim bilgilerini ve notları değiştirir. Ayrıca misafirleri okur, iletişim bilgilerini değiştirir, ödeme durumunu ve kesilmiş faturaları okur. Yazma yetkisiyle API, birimlerin temizlik durumunu, müsaitlik kısıtlarını ve günlük fiyatları ayarlar ve faturalara gelen banka havalelerini kaydeder.

Bir anahtarı nasıl alırım?

Otelin bir yöneticisi bunu STRYK'te Kanallar → API altında oluşturur ve yetkileri seçer, örneğin yalnızca müsaitlik ve fiyatları okuma. Her anahtar tam olarak tek bir otele aittir.

Arayüzleri kullanmak ne kadar tutar?

Dokümantasyon geliştiriciler için ücretsizdir. Partner API, otel tarafından ek modül olmadan STRYK temel fiyatı içinde kullanılır. Kasa bağlantısı STRYK POS ek modülünün parçasıdır.

Hangi webhook'lar var?

booking.created, booking.updated, booking.cancelled, guest.updated, availability.changed, rate.changed, payment.updated, unit.updated ve webhook.test. Her teslimat HMAC ile imzalanır ve hatalarda otomatik olarak yeniden denenir.

Erişim nasıl güvence altına alınır?

Her anahtar tam olarak tek bir otele aittir; kendi yetkileri, son kullanma tarihi ve isteğe bağlı bir IP izin listesi vardır. Webhook'lar HMAC ile imzalanır, istekler hız sınırına tabidir ve otel bir anahtarı istediği zaman iptal edebilir.

Diğer soruları göster
API üzerinden yapılan rezervasyonlarda ödemeler nasıl işler?

Ödemeleri otel, STRYK Payments ve kurulu ödeme yolları üzerinden tahsil eder; kart verileri de orada kalır. API üzerinden oluşturulan yeni rezervasyonlar açık bakiyeyle başlar; otel bunu ödeme bağlantısı, çevrim içi ya da POS terminaliyle tahsil eder. Ödeme durumunu API üzerinden okursun; yazma yetkisiyle de bir faturaya karşılık gelen banka havalelerini kaydeder.

Hangi kasalar STRYK ile uyumlu?

Hayır. Tamamlanmış bir bağlantı kanıtlanana kadar hiçbir kasayı “sertifikalı” ya da hiçbir markayı “desteklenen” olarak nitelemeyiz. Sisteminizin durumu için bize sorun.

Bağlamak istediğin şeyi bize göster.

STRYK'ı otelinde 14 gün dene ya da bir demoda entegrasyonunu bizimle konuş. Referans her zaman geliştirici portalında.

İletişim