Versioning

AstroWay API gebruikt URL versioning: de versie is opgenomen in het request pad. Dit is eenvoudiger dan header-based en goed te cachen door proxies.

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

SemVer voor API

We volgen de semantiek van semver.org:

• MAJOR (v1 → v2): breaking wijzigingen. De oude versie blijft minimaal 12 maanden werken na de release van een nieuwe.
• MINOR: nieuwe endpoints, nieuwe optionele velden. Volledig compatibel.
• PATCH: bugfixes, verbeteringen in precisie. Zichtbaar via header X-Api-Version: 1.12.3 in het antwoord.

Wat geen breaking change is

• Het toevoegen van een nieuw endpoint
• Het toevoegen van een nieuw optioneel veld in het request body
• Het toevoegen van een nieuw veld aan het antwoord
• Het verduidelijken van error-berichten (de code blijven stabiel)
• Wijzigingen in de berekeningsprecisie binnen de opgegeven ±1” (planeten) / ±1’ (huizen)
• Het verhogen van de rate limit of credit budget in jouw plan

Dit betekent: jouw code moet niet crashen als er een nieuw veld aan het antwoord wordt toegevoegd. Parse alleen wat je nodig hebt, negeer de rest.

Wat wel breaking change is (alleen in major release)

• Het verwijderen of hernoemen van een endpoint
• Het verwijderen of hernoemen van een veld in het antwoord
• Het veranderen van een veldtype (bijv. number → string)
• Het veranderen van de semantiek van een veld (wat dezelfde naam betekent)
• Het veranderen van code in een error-antwoord
• Het verscherpen van validatie dat eerder geldige verzoeken kan breken

Changelog

Alle wijzigingen staan in de Changelog. Minoreleases elke 2-4 weken, patches zodra ze klaar zijn.

Abonneer je op updates:

• RSS: https://api.astroway.info/changelog/rss.xml
• Email: Instellingen → Meldingen → Productupdates in het dashboard

Deprecation policy

Wanneer een veld of endpoint wordt gedeprecated:

1. Aangekondigd in de changelog + e-mailmelding
2. In het antwoord verschijnt de header Deprecation: Sun, 01 Nov 2026 00:00:00 GMT (standaard RFC 8594)
3. Gedeprecateerde API blijft minimaal 12 maanden werken
4. Verwijdering: alleen in de volgende major release