Sürümleme

https://api.astroway.info/v1/chart

API için SemVer

API’mız semver.org semantik sürümlemesine uyar:

• MAJOR (v1 → v2): breaking değişiklikler. Eski sürüm, yeni sürümün yayınlanmasından sonra en az 12 ay boyunca çalışmaya devam eder.
• MINOR: yeni endpoint’ler, yeni isteğe bağlı alanlar. Tamamen uyumlu.
• PATCH: hata düzeltmeleri, hassasiyet iyileştirmeleri. Yanıtta X-Api-Version: 1.12.3 başlığında görülebilir.

Ne breaking change olarak kabul edilmez

• Yeni endpoint eklenmesi
• İstek gövdesine yeni isteğe bağlı alan eklenmesi
• Yanıta yeni alan eklenmesi
• Hata mesajlarının metninin iyileştirilmesi (code kodları sabit kalır)
• Hesaplamalardaki hassasiyet değişiklikleri, bildirilen ±1” (gezegenler) / ±1’ (evler) aralığında
• Planındaki rate limit veya credit budget’ının artırılması

Bu şu anlama gelir: yanıta yeni bir alan eklendiğinde kodun düşmemeli. Sadece ihtiyacın olanı ayrıştır, geri kalanını görmezden gel.

Neler breaking change (sadece major sürümde)

• Endpoint’in kaldırılması veya yeniden adlandırılması
• Yanıttaki alanın kaldırılması veya yeniden adlandırılması
• Alan türünün değiştirilmesi (örneğin, number → string)
• Alanın semantiğinin değiştirilmesi (aynı isimle farklı anlam ifade etmesi)
• Hata yanıtındaki code değişikliği
• Daha önce geçerli olan istekleri bozabilecek doğrulama kurallarının katılaştırılması

Changelog

Tüm değişiklikler Changelog sayfasında. Minor sürümler 2-4 haftada bir, patch’ler hazır olduğunda yayınlanır.

Güncellemeler için abone ol:

• RSS: https://api.astroway.info/changelog/rss.xml
• E-posta: dashboard içinde Ayarlar → Bildirimler → Ürün güncellemeleri

Deprecation policy

Bir alan veya endpoint deprecated olduğunda:

1. Changelog’da duyurulur + e-posta ile bildirim yapılır
2. Yanıtta Deprecation: Sun, 01 Nov 2026 00:00:00 GMT başlığı eklenir (RFC 8594 standardı)
3. Deprecated API en az 12 ay boyunca çalışmaya devam eder
4. Kaldırma: sadece bir sonraki major sürümde