Verziókezelés

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

SemVer az API-hoz

Követjük a semver.org szemantikáját:

• MAJOR (v1 → v2): kompatibilitást megsértő változások. A régi verzió továbbra is működik legalább 12 hónappal az új kiadás után.
• MINOR: új végpontok, új opcionális mezők. Teljesen kompatibilis.
• PATCH: hibajavítások, pontosság javítások. Látható a válasz X-Api-Version: 1.12.3 headerében.

Mi nem számít kompatibilitást megsértő változásnak

• Új végpont hozzáadása
• Új opcionális mező hozzáadása a kérés törzsében
• Új mező hozzáadása a válaszhoz
• Hibaüzenetek pontosítása (a code kódok stabilak maradnak)
• Számítási pontosság változtatása a deklarált ±1” (bolygók) / ±1’ (házak) határon belül
• Rate limit vagy kreditkeret növelése a csomagodban

Ez azt jelenti: a kódod nem szabad, hogy hibát adjon, amikor új mezőt adunk a válaszhoz. Elemezz csak azt, amire szükséged van, a többit figyelmen kívül hagyod.

Mi számít kompatibilitást megsértő változásnak (csak a fő kiadásokban)

• Végpont eltávolítása vagy átnevezése
• Mező eltávolítása vagy átnevezése a válaszban
• Mező típusának megváltoztatása (pl. number → string)
• Mező szemantikájának megváltoztatása (mit jelent ugyanaz a név)
• code megváltoztatása a hibaválaszban
• Validáció szigorítása, ami korábban érvényes kéréseket ronthat meg

Változásnapló

Minden változás a Változásnaplóban található. Minori kiadások minden 2-4 héten, javítások amint készen állnak.

Feliratkozás a frissítésekre:

• RSS: https://api.astroway.info/changelog/rss.xml
• Email: Beállítások → Értesítések → Termékfrissítések a dashboard oldalon

Elavulási politika

Amikor egy mező vagy végpont elavult:

1. Bejelentés a változásnaplóban + email értesítés
2. A válasz headerében megjelenik Deprecation: Sun, 01 Nov 2026 00:00:00 GMT (szabvány RFC 8594)
3. Az elavult API továbbra is működik legalább 12 hónapig
4. Eltávolítás: csak a következő fő kiadásban