Verzování

AstroWay API používá URL versioning: verze je uvedena přímo v cestě požadavku. Je to jednodušší než verzování v hlavičce a proxy to dobře cachují.

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

SemVer pro API

Držíme se sémantiky semver.org:

• MAJOR (v1 → v2): nekompatibilní změny. Stará verze funguje ještě nejméně 12 měsíců po vydání nové.
• MINOR: nové endpointy, nová volitelná pole. Vždy zpětně kompatibilní.
• PATCH: opravy chyb, zpřesnění výpočtů. Poznáš je podle hlavičky X-Api-Version: 1.12.3 v odpovědi.

Co se nepovažuje za breaking change

• Přidání nového endpointu
• Přidání nového volitelného pole do těla požadavku
• Přidání nového pole do odpovědi
• Úprava textu chybových hlášek (hodnoty code zůstávají stabilní)
• Změny přesnosti výpočtů v deklarovaných mezích ±1” (planety) / ±1’ (domy)
• Zvýšení rate limitu nebo kreditového rozpočtu ve tvém tarifu

To znamená: tvůj kód nesmí spadnout, když v odpovědi přibude nové pole. Parsuj jen to, co potřebuješ, zbytek ignoruj.

Co je breaking change (jen v major verzi)

• Odstranění nebo přejmenování endpointu
• Odstranění nebo přejmenování pole v odpovědi
• Změna typu pole (například number → string)
• Změna významu pole (co totéž jméno označuje)
• Změna code v chybové odpovědi
• Zpřísnění validace, které může rozbít dříve platné požadavky

Changelog

Všechny změny najdeš v Changelogu. Minor verze vycházejí každé 2–4 týdny, patche průběžně, jakmile jsou hotové.

Odběr novinek:

• RSS: https://api.astroway.info/changelog/rss.xml
• E-mail: Settings → Notifications → Product updates v dashboardu

Deprecation policy

Když se pole nebo endpoint stane deprecated:

1. Oznámíme to v changelogu a e-mailem
2. V odpovědi se objeví hlavička Deprecation: Sun, 01 Nov 2026 00:00:00 GMT (standard RFC 8594)
3. Deprecated API funguje dál nejméně 12 měsíců
4. Odstranění: jen v příští major verzi