Εκδόσεις

Το AstroWay API χρησιμοποιεί URL versioning: η έκδοση γράφεται στη διαδρομή του αιτήματος. Είναι απλούστερο από το versioning μέσω header και αποθηκεύεται εύκολα στην cache των proxies.

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

SemVer για το API

Ακολουθούμε τη σημασιολογία του semver.org:

• MAJOR (v1 → v2): αλλαγές που σπάνε τη συμβατότητα. Η παλιά έκδοση συνεχίζει να λειτουργεί τουλάχιστον 12 μήνες μετά την κυκλοφορία της νέας.
• MINOR: νέα endpoints, νέα προαιρετικά πεδία. Πάντα συμβατά.
• PATCH: διορθώσεις σφαλμάτων, βελτιώσεις ακρίβειας. Φαίνονται μέσω του header X-Api-Version: 1.12.3 στην απάντηση.

Τι δεν θεωρείται breaking change

• Προσθήκη νέου endpoint
• Προσθήκη νέου προαιρετικού πεδίου στο request body
• Προσθήκη νέου πεδίου στην απάντηση
• Βελτίωση του κειμένου των μηνυμάτων σφάλματος (οι τιμές code μένουν σταθερές)
• Αλλαγές στην ακρίβεια των υπολογισμών εντός των δηλωμένων ±1” (πλανήτες) / ±1’ (οίκοι)
• Αύξηση του rate limit ή του credit budget στο πλάνο σου

Αυτό σημαίνει: ο κώδικάς σου δεν πρέπει να σκάει όταν προστίθεται νέο πεδίο στην απάντηση. Κάνε parse μόνο ό,τι χρειάζεσαι και αγνόησε τα υπόλοιπα.

Τι είναι breaking change (μόνο σε major έκδοση)

• Αφαίρεση ή μετονομασία endpoint
• Αφαίρεση ή μετονομασία πεδίου στην απάντηση
• Αλλαγή τύπου πεδίου (για παράδειγμα, number → string)
• Αλλαγή σημασίας πεδίου (τι δηλώνει το ίδιο όνομα)
• Αλλαγή του code σε απάντηση σφάλματος
• Αυστηρότερη επικύρωση που μπορεί να σπάσει αιτήματα που πριν ήταν έγκυρα

Changelog

Όλες οι αλλαγές βρίσκονται στο Changelog. Minor εκδόσεις κάθε 2–4 εβδομάδες, patches μόλις είναι έτοιμα.

Εγγραφή στις ενημερώσεις:

• RSS: https://api.astroway.info/changelog/rss.xml
• Email: Settings → Notifications → Product updates στο dashboard

Deprecation policy

Όταν ένα πεδίο ή endpoint γίνεται deprecated:

1. Το ανακοινώνουμε στο changelog + ειδοποίηση μέσω email
2. Στην απάντηση εμφανίζεται το header Deprecation: Sun, 01 Nov 2026 00:00:00 GMT (πρότυπο RFC 8594)
3. Το deprecated API συνεχίζει να λειτουργεί τουλάχιστον 12 μήνες
4. Αφαίρεση: μόνο στην επόμενη major έκδοση