Versiune

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

SemVer pentru API

Urmăm semantica semver.org:

• MAJOR (v1 → v2): modificări care sparg compatibilitatea. Versiunea veche continuă să funcționeze cel puțin 12 luni după lansarea celei noi.
• MINOR: noi endpoint-uri, noi câmpuri opționale. Complet compatibil cu versiunile anterioare.
• PATCH: corecții de erori, îmbunătățiri de precizie. Vizibil în header-ul de răspuns X-Api-Version: 1.12.3.

Ce NU este considerată modificare care sparg compatibilitatea

• Adăugarea unui nou endpoint
• Adăugarea unui nou câmp opțional în corpul cererii
• Adăugarea unui nou câmp în răspuns
• Îmbunătățirea textului mesajelor de eroare (valorile codurilor code rămân stabile)
• Modificări ale preciziei calculului în limitele declarate de ±1” (planete) / ±1’ (case)
• Creșterea rate limit-ului sau a bugetului de credit în planul tău

Acest lucru înseamnă: codul tău nu trebuie să se rupă atunci când se adaugă un nou câmp în răspuns. Parsează doar ceea ce ai nevoie, ignorând restul.

Ce ESTE modificare care sparg compatibilitatea (doar în versiunile majore)

• Eliminarea sau redenumirea unui endpoint
• Eliminarea sau redenumirea unui câmp din răspuns
• Schimbarea tipului unui câmp (de exemplu, number → string)
• Schimbarea semanticii unui câmp (ce înseamnă același nume)
• Schimbarea code-ului în răspunsul de eroare
• Strângerea validării care ar putea rupe cereri anterior valide

Changelog

Toate modificările sunt în Changelog. Versiuni minore la fiecare 2-4 săptămâni, patch-uri după cum este necesar.

Abonează-te la actualizări:

• RSS: https://api.astroway.info/changelog/rss.xml
• Email: Settings → Notifications → Product updates în dashboard

Politica de depreciere

Când un câmp sau endpoint devine depreciat:

1. Anunțat în changelog + notificare prin email
2. Apare un header de răspuns: Deprecation: Sun, 01 Nov 2026 00:00:00 GMT (standard RFC 8594)
3. API-ul depreciat continuă să funcționeze pentru cel puțin 12 luni
4. Eliminare: doar în următoarea versiune majoră