# Sürüm politikası

Geçerli sürüm `v1`'dir (`/api/v1/…`). v1 içinde yalnız **eklemeli** değişiklik yapılır:

- Yeni uç, yeni isteğe bağlı parametre, yanıta yeni alan, yeni kategori ya da enum değeri gelebilir.
- Mevcut alanlar kaldırılmaz, yeniden adlandırılmaz, türü değişmez; `hata` ve `detay` korunur.
- Geriye uyumu bozan bir değişiklik ancak yeni sürüm önekiyle (`/api/v2/`) gelir; v1 bir süre birlikte çalışır.
- Kaldırılacak bir uç önce [değişiklik günlüğünde](/gelistirici/degisiklik-gunlugu/) duyurulur ve OpenAPI'de `deprecated` işaretlenir.

## İstemciniz için

- Bilinmeyen alanları yok sayın; bilinmeyen enum değerini "diğer" gibi ele alın.
- `null` ile `[]` farkını koruyun ([boş liste kuralı](/gelistirici/veri-durumu/)).
- Tanımın makine okunur hali: [openapi.json](/gelistirici/openapi.json).