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 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ı).
• Tanımın makine okunur hali: openapi.json.