Versionierung

AstroWay API verwendet URL-Versionierung: Die Version ist im Anfragepfad enthalten. Das ist einfacher als header-basiert und wird gut von Proxys gecacht.

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

SemVer für API

Wir halten uns an die Semantik von semver.org:

• MAJOR (v1 → v2): Breaking Changes. Die alte Version funktioniert mindestens 12 Monate nach dem Release der neuen Version weiter.
• MINOR: Neue Endpunkte, neue optionale Felder. Vollständig kompatibel.
• PATCH: Bugfixes, Präzisionsverbesserungen. Sichtbar im Header X-Api-Version: 1.12.3 in der Antwort.

Was kein Breaking Change ist

• Hinzufügen eines neuen Endpunkts
• Hinzufügen eines neuen optionalen Felds zum Request-Body
• Hinzufügen eines neuen Felds zur Antwort
• Präzisierung von Fehlermeldungen (die code-Werte bleiben stabil)
• Änderungen der Berechnungsgenauigkeit innerhalb der deklarierten ±1” (Planeten) / ±1’ (Häuser)
• Erhöhung der Rate Limits oder des Kreditbudgets in deinem Plan

Das bedeutet: dein Code darf nicht abstürzen, wenn ein neues Feld zur Antwort hinzugefügt wird. Parse nur das, was du brauchst, und ignoriere den Rest.

Was ein Breaking Change ist (nur in Major-Releases)

• Entfernen oder Umbenennen eines Endpunkts
• Entfernen oder Umbenennen eines Felds in der Antwort
• Änderung des Feldtyps (z.B. number → string)
• Änderung der Semantik eines Felds (was derselbe Name bedeutet)
• Änderung des code in Fehlerantworten
• Verschärfung der Validierung, die früher gültige Anfragen ungültig machen könnte

Changelog

Alle Änderungen sind im Changelog. Minor-Releases alle 2-4 Wochen, Patches sobald sie fertig sind.

Abonniere Updates:

• RSS: https://api.astroway.info/changelog/rss.xml
• E-Mail: Settings → Notifications → Product updates im Dashboard

Deprecation policy

Wenn ein Feld oder Endpunkt veraltet wird:

1. Wird im Changelog + per E-Mail angekündigt
2. In der Antwort erscheint der Header Deprecation: Sun, 01 Nov 2026 00:00:00 GMT (Standard RFC 8594)
3. Deprecated API funktioniert mindestens 12 Monate weiter
4. Entfernung: Nur im nächsten Major-Release