API ve geliştirici koşulları

1. Kapsam

Bu koşullar, CesiSync API'sini (/v1), webhook'ları, OAuth uygulamalarını ve sandbox'ı kullanan acentelere ve yazılım sağlayıcılarına uygulanır; Kullanım koşullarını tamamlar.

2. Anahtarlar ve yetkilendirme

API anahtarları (bp_live_…, bp_test_…) ve OAuth belirteçleri gizlidir; kaynak koduna, istemci tarafı uygulamalara veya herkese açık depolara konmamalıdır. Anahtarı yalnızca gereken kapsamlarla ve mümkünse IP kısıtıyla oluşturun. Sızan anahtarı hemen iptal edin; anahtarla yapılan işlemlerden anahtar sahibi sorumludur.

Bir yazılım sağlayıcısı, acentelerin verisine yalnızca o acentenin OAuth ile verdiği izin kapsamında erişebilir; izin geri alındığında erişimi bırakır ve o acentenin verisini siler.

3. Sınırlar ve adil kullanım

İstekler anahtar başına hız sınırına tabidir (yanıtlardaki RateLimit-* başlıklarında bildirilir). Sınırı dolanmak için birden fazla anahtar kullanmak yasaktır. Takvim senkronizasyonu için yoklama yerine webhook ve GET /v1/events kullanın. Müsaitlik aramasını gereğinden sık çalıştırmayın.

4. Webhook'lar

Webhook adresiniz herkese açık, HTTPS destekli ve imzayı (Standard Webhooks) doğrulayan bir uç olmalıdır. Başarısız gönderimler yaklaşık üç gün boyunca yeniden denenir; art arda 100 başarısızlıktan sonra adres kapatılır. Olaylar tekrar edilebilir (en az bir kez teslimat): işleminizi olay kimliğiyle idempotent yapın ve property_seq ile eksik olay tespit edin.

5. Veri kullanımı

API'den aldığınız mülk, takvim, fiyat ve iletişim verileri yalnızca abone olduğunuz mülklerin satışı ve yönetimi için kullanılabilir. Abonelik sona erdiğinde (subscription.revoked) ilgili mülkün takvim ve fiyatını göstermeyi bırakmalısınız. Verileri üçüncü taraflarla paylaşamaz, yapay zekâ modellerinin eğitiminde kullanamaz ve toplu olarak dışarı aktaramazsınız.

6. Sandbox

Sandbox örnek verilerle çalışır, gerçek takvime dokunmaz ve garanti kapsamında değildir; sıfırlanabilir. Sandbox verisini canlıymış gibi kullanıcılara göstermeyin.

7. Sürümleme ve değişiklik

API sürümü yanıtlarda bildirilir. Geriye uyumlu eklemeler (yeni alan, yeni olay türü) haber verilmeden yapılabilir; istemcileriniz bilinmeyen alanları yok saymalıdır. Geriye uyumsuz değişiklikler yeni sürümle ve en az 6 ay geçiş süresiyle yapılır.

8. Askıya alma

Güvenliği, kararlılığı veya diğer kullanıcıları tehdit eden kullanımda anahtarı veya uygulamayı derhal askıya alabiliriz; mümkün olduğunda önce iletişime geçeriz.