Sürümleme ve kullanımdan kaldırma
Ana sürüm yoldadır (/v1).
Geriye uyumlu (sürüm değişmez)
Yeni uç, yeni isteğe bağlı parametre, yanıta yeni alan, sayımlara yeni değer, yeni olay türü, yeni webhook olay_turu. Değişiklik günlüğünde "Eklendi" diye yazılır. Yazılımınız bilinmeyen alanları ve değerleri yok saymalıdır.
Kırıcı (yeni ana sürüm /v2)
Alan kaldırma ya da anlam değiştirme, zorunlu parametre, hata kodunun değişmesi, imleç biçiminin uyumsuz değişmesi. Biçimlerde (yha_xml bicim_surumu, webhook surum, NewsML-G2 profil sürümü) aynı ilke geçerlidir.
Kaldırma
Kaldırılacak uç ya da sürüm duyurulduğu andan itibaren yanıtlarda şu başlıklar gelir:
metin
Deprecation: @1791371942
Sunset: Fri, 08 Oct 2027 00:00:00 GMT
Link: <https://<alan>/gelistirici/degisiklikler#…>; rel="deprecation"Deprecation(RFC 9745): duyuru anı (Unix saniye).Sunset(RFC 8594): kaldırılacağı an.- Önceki ana sürüm yenisi yayımlandıktan sonra en az 12 ay çalışır.
- Son 30 günde kaldırılacak bir yolu kullanan kurumların teknik ve yönetici kullanıcılarına 6 ay, 1 ay ve 1 hafta kala bildirim ve e-posta gider; YHA Abone'nin Anahtarlar ekranında anahtar başına "kaldırılacak özellik kullanıyor" uyarısı görünür.