Versioning

AstroWay API utilise URL versioning : la version est indiquée dans le chemin de la requête. C’est plus simple que le header‑based et bien mis en cache par les proxys.

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

SemVer pour l’API

Nous suivons la sémantique semver.org :

• MAJOR (v1 → v2) : changements majeurs. L’ancienne version continue de fonctionner pendant au moins 12 mois après la sortie de la nouvelle.
• MINOR : nouveaux endpoints, nouveaux champs optionnels. Toujours compatible.
• PATCH : corrections de bugs, ajustements de précision. Visible via le header X-Api-Version: 1.12.3 dans la réponse.

Ce qui n’est pas considéré comme breaking change

• Ajout d’un nouvel endpoint
• Ajout d’un nouveau champ optionnel dans le corps de la requête
• Ajout d’un nouveau champ dans la réponse
• Précision du texte des messages d’erreur (les codes code restent stables)
• Modifications de la précision des calculs dans les limites déclarées ±1” (planètes) / ±1’ (maisons)
• Augmentation du rate limit ou du budget de crédits dans ton plan

Cela signifie que ton code ne doit pas planter lorsqu’un nouveau champ est ajouté à la réponse. Analyse uniquement ce dont tu as besoin, ignore le reste.

Ce qui est breaking change (uniquement dans une version majeure)

• Suppression ou renommage d’un endpoint
• Suppression ou renommage d’un champ dans la réponse
• Changement du type d’un champ (par exemple, number → string)
• Changement de la sémantique d’un champ (qui signifie la même chose)
• Modification du code dans la réponse d’erreur
• Renforcement de la validation, pouvant casser des requêtes précédemment valides

Changelog

Toutes les modifications sont dans le Changelog. Les releases mineures arrivent toutes les 2–4 semaines, les patches au fur et à mesure.

Abonne-toi aux mises à jour :

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

Politique de dépréciation

Quand un champ ou un endpoint devient deprecated :

1. Nous l’annonçons dans le changelog + email-notice
2. La réponse inclut le header Deprecation: Sun, 01 Nov 2026 00:00:00 GMT (standard RFC 8594)
3. L’API deprecated continue de fonctionner au moins 12 mois
4. Suppression : uniquement dans la prochaine version majeure