Değişiklikler

Sürüm politikası

API’nin ana sürümü adreste yer alır (/api/public/v1) ve GET /site yanıtındaki api_version alanında döner. Bugünkü ana sürüm 1’dir.

Habersiz yapılabilecek değişiklikler

Aşağıdaki değişiklikler geriye uyumludur; önceden duyurulmadan yayına alınabilir ve bu sayfaya yazılır:

• Yeni uç eklenmesi.
• Yanıtlara yeni alan eklenmesi.
• İsteklere yeni, isteğe bağlı alan ya da sorgu parametresi eklenmesi.
• Yeni hata türü (type), yeni webhook olay türü ya da kapsamı eklenmesi.
• Hata mesajlarının (title, errors metinleri) değişmesi.

Sisteminizi buna göre kurun:

• Bilinmeyen alanları yok sayın; katı şema doğrulamasıyla yanıtı reddetmeyin.
• Tanımadığınız type, olay türü ya da kapsam geldiğinde HTTP koduna ya da güvenli varsayılana düşün.
• Mesaj metinlerine bağlı kod yazmayın.

Kırıcı değişiklikler

Bir alanın ya da ucun kaldırılması, adının, türünün ya da anlamının değişmesi, isteğe bağlı bir alanın zorunlu olması gibi değişiklikler kırıcıdır. Kırıcı değişiklikler en az 30 gün önceden size verilen iletişim kanalından ve bu sayfada duyurulur.

Bilinen sınırlar netleştiğinde (ör. sayfalarda “Netleşecek” ile işaretli konular) yapılan değişiklikler de bu sayfaya yazılır.

Kayıt

1.0.0 · 2026-10-30

İlk sürüm.

• Bağlantı denemesi: GET /site.
• Katalog: villa listesi ve detayı, özet listesi, özellik, lokasyon ve tip sözlükleri, aylara göre müsaitlik.
• Fiyat: tek villa, toplu ve yeniden hesaplanan teklif.
• Rezervasyon: talep, sorgu, detay ve ödeme bilgisi.
• Webhook: katalog değişiklik olayları (availability, price, villa, reference, test).