Sürümleme ve geriye dönük uyumluluk

URL sürümü

Kararlı yollar /v1 içerir. Geriye dönük uyumsuz bir değişiklik /v2 altında yayınlanır; /v1 için kaldırma takvimi ayrıca duyurulur.

Kırıcı sayılmayan değişiklikler

• Response'a yeni alan eklenmesi
• Enum olmayan metadata/sözlük listelerine yeni kayıt eklenmesi
• Hata detail ve title metinlerinin değiştirilmesi
• Rate-limit header değerlerinin anahtar config'ine göre değişmesi

İstemciler bilinmeyen response alanlarını yok saymalı ve kullanıcıya gösterilecek sabit metinleri kendileri yerelleştirmelidir.

Kırıcı değişiklikler

• Zorunlu request alanı eklenmesi
• Mevcut alan tipinin değiştirilmesi
• Endpoint veya alan kaldırılması
• Enum sözleşmesinden mevcut değer kaldırılması
• Mevcut başarılı durumun farklı HTTP semantiğine taşınması

Bunlar yeni major URL sürümü gerektirir.

Deprecation ve Sunset

Kaldırılacak endpoint'ler önceden şu header'ları taşır:

Deprecation: true
Sunset: Sat, 31 Oct 2026 23:59:59 GMT

İstemciniz bu header'ları merkezi log/telemetry sistemine aktarmalıdır. Sunset sonrasında endpoint'in çalışmaya devam edeceğini varsaymayın.

Parametre dokümanı sürümü

Look Engine /look/v1/params, version ve minEngineVersion döner. Motoru istemci tarafında çalıştıran uygulamalar, kendi engine sürümleri minimumdan eskiyse uzaktaki parametreleri reddetmeli ve uyumlu yerel varsayılanlarını korumalıdır.