# Partner API: anahtarları ve webhook'ları yönet

Canonical: https://staystryk.com/tr/documentation/partner-api/
Language: tr
Updated: 2026-11-12

STRYK'ta tam olarak gereken yetkilerle API anahtarları oluştur ve Partner API için webhook'lar kur. Uç noktalar geliştirici portalında yer alır.

## Başlamadan önce

Kanalları yönet yetkisine ihtiyacın var. Yalnızca bu yetkiyle Kanallar sayfasında API satırını görürsün.

Entegrasyonun hangi alanları okuması ya da yazması gerektiğini netleştir. Bir anahtar yalnızca bu yetkileri alır.

Bir entegrasyon Partner API'yi kendi sunucusundan çağırır. Anahtarı asla tarayıcı koduna ya da bir uygulamaya koyma. Uç noktaları, parametreleri ve örnekleri Geliştirici dokümantasyonunda bulursun. Orada Kimlik doğrulama ve kapsamlar bölümü her yetkinin neye izin verdiğini açıklar.

Webhook'lar, https:// ile başlayan bir adrese sahip bir alıcı gerektirir.

## API'yi aç

Kanallar

Kendi entegrasyonların altında “API anahtarları ve webhook'lar” ek metnine sahip API satırını seç. API penceresi açılır.

API anahtarları ya da Webhook'lar sekmesini seç. Pencere başlığındaki Geliştirici dokümantasyonu ile geliştirici portalını açarsın.

API penceresinin API anahtarları sekmesinde Rezervasyon sayfası adlı anahtar, yetkileri, son kullanım tarihi ve Aktif durumu görünür.

API anahtarları ve Webhook'lar sekmeleri

Anahtar ve yetkileri

Anahtarın eylemleri

## API anahtarı oluştur

KanallarAPIAPI anahtarları

API anahtarı oluştur seç. API anahtarı oluştur penceresi açılır.

Ad alanına örneğin “Rezervasyon sayfası” yaz.

Yetkiler altında bir model seç: Yalnızca okuma (tüm alanları okuma), Okuma ve yazma (mümkün olan yerlerde yazma) veya Özel. Özel seçildiğinde her alan için Erişim yok, Okuma ya da Yazma seçersin. Alanlar şunlardır: Otel ve oda, Müsaitlik, Fiyatlar ve tarifeler, Rezervasyonlar, Misafirler, Ödemeler ve Faturalar. Yazma, Okuma yetkisini de kapsar. Faturalar otelin mali belgeleridir ve API üzerinden yalnızca okunabilir.

İsteğe bağlı: Gelişmiş bölümünü aç. Sona erme seç: Sona erme yok, 30 gün, 90 gün, 1 yıl veya Tarih (yarından başlayarak en fazla üç yıl sonrası). IP kısıtlaması satırına her satırda bir adres veya CIDR ağı gir, en fazla 20 tane. Boş bırakılırsa tüm adreslere izin verilir. Not alanına dahili bir hatırlatma yazabilirsin.

Oluştur seç. STRYK API anahtarı oluşturuldu yazısını, anahtarı ve Yalnızca şimdi görünür notunu gösterir.

Anahtarı kopyala ve örneğin bir parola yöneticisine kaydet. Tamam seç.

STRYK tam anahtarı yalnızca bir kez gösterir. Kaydetmediysen anahtarı yeniden oluşturman gerekir.

## API anahtarlarını yönet

KanallarAPIAPI anahtarları

Liste her anahtar için Ad, anahtarın başlangıcını, Yetkiler, Oluşturuldu, Son kullanım, Sona erme ve durumu gösterir: Aktif, Yakında sona erecek, İptal edildi veya Süresi doldu. Bir anahtar seçtiğinde Yetkiler, Sona erme, İzin verilen IP adresleri, İstek limiti (dakika başına istek), Kullanım, Son istekler ve Geçmiş bilgilerini görürsün.

Satırda Seçenekler menüsünü aç.

Entegrasyonun aynı yetkilerle yeni bir anahtar alması gerekiyorsa Yenile seç. Mevcut anahtar altında, entegrasyonu geçirebilmen için Eski anahtar hâlâ 24 saat geçerli ya da Hemen iptal et seçeneğini seç. Yenile ile onayla. STRYK yeni anahtarı bir kez gösterir.

Bir anahtarı hemen engellemek için İptal et seç ve API anahtarı iptal edilsin mi? sorusunu onayla. STRYK bu anahtarla gelen istekleri reddeder.

## Webhook'ları kur

KanallarAPIWebhook'lar

Webhook, seçilen olayları HTTPS üzerinden imzalı olarak sistemlerine gönderir.

Webhook oluştur seç. Yeni webhook penceresi açılır.

Alıcı URL'si alanına örneğin https://crm.nordlicht.invalid/hooks/stryk adresini gir. Adres https:// ile başlamalıdır.

İsteğe bağlı: Açıklama alanına örneğin “Rezervasyonlar CRM'imize” yaz.

Olaylar altında en az birini seç: Rezervasyon oluşturuldu, Rezervasyon değiştirildi, Rezervasyon iptal edildi, Misafir değişti, Müsaitlik değişti, Fiyat değişti, Ödeme değişti veya Oda durumu değişti. Tümünü seç ve Seçimi kaldır ile hepsini ya da hiçbirini seçersin.

Webhook oluştur seç. STRYK İmza sırrın değerini bir kez gösterir.

Sırrı alıcı sisteminde sakla. Alıcının imzayı nasıl doğrulayacağı, Webhook'lar ve imza doğrulama bölümünde geliştirici dokümantasyonunda açıklanır.

Webhook'u seç ve ardından Test olayı gönder seç. STRYK “Test olayı teslim ediliyor.” mesajını gösterir.

## Webhook'ları yönet

Ort: Kanallar \> API \> Webhooks, webhook'u seç

Teslimat aktif anahtarıyla webhook'u duraklatır ya da etkinleştirirsin. Duraklatılmış webhook'lar olay almaz. Etkinleştirdikten sonra teslimat yeni olaylarla devam eder.

Son 7 gün, Son başarı ve Son hata durumu gösterir. Gönderimler altında her teslimatı HTTP durumu ve Denemeler ile görürsün. Yeniden gönder ile bir teslimatı tekrarlarsın.

Gizli anahtarı yenile yeni bir sır oluşturur. Eski sır, alıcıyı geçirebilmen için 24 saat daha geçerli kalır.

Düzenle ile adresi ve olayları değiştirirsin. Sil ve onay sorusu Webhook silinsin mi? ile webhook'u kaldırırsın. Teslim günlüğü 30 gün saklanır.

## Sonucu kontrol et

Anahtarda, entegrasyon onu kullanmaya başladığında tarihle birlikte Son kullanım görünür. İstek (24 sa) istekleri sayar.

Webhook'ta Son 7 gün “{Zahl} teslim edildi, {Zahl} başarısız” gösterir ve test olayı Gönderimler altında yer alır.

## Bir şey işe yaramıyorsa

“En az bir yetki seç.”, Hiçbir alanda yetki yok., Bir model seç ya da en az bir alana Okuma veya Yazma ver.

“Lütfen bir ad gir.”, Ad alanı boş., Bir ad gir.

“Lütfen kontrol et:” ardından bir adres, IP kısıtlaması içindeki bir adres geçersiz., Adresi ya da CIDR ağını düzelt. En fazla 20 giriş izinlidir.

“Lütfen yarından başlayan ve en fazla üç yıl sonrasını gösteren bir tarih seç.”, Sona erme tarihi izin verilen aralığın dışında., Yarından başlayan ve en fazla üç yıl sonrasını gösteren bir tarih seç.

“Adres https:// ile başlamalıdır.”, Alıcı URL'si HTTPS adresi değil., https:// ile başlayan bir adres gir.

“En az bir olay seç.”, Webhook'un hiç olayı yok., Olaylar altında en az bir olay seç.

Tekrarlanan hatalar nedeniyle duraklatıldı, Alıcı 2xx durum koduyla yanıt vermiyor., Alıcının erişilebilir olup olmadığını kontrol et ve Yeniden etkinleştir seç.

“Test olayı göndermek için webhook'u etkinleştir.”, Webhook duraklatılmış., Teslimat aktif seçeneğini etkinleştir ve test olayını gönder.

“Seçim yüklenemedi. Lütfen kapat ve yeniden aç.”, Yetki ve olay listesi yüklenmedi., Pencereyi kapat ve yeniden aç.

## Bununla ilgili konular

Kanallar: API satırı rezervasyon portallarının yanında yer alır: Kanalları bağla ve izle.

Geliştirici portalı: Uç noktaları, hata kodlarını ve istek limitlerini Geliştirici dokümantasyonunda bulursun.
