Versi

AstroWay API menggunakan versioning URL: versi ditulis dalam path request. Ini lebih sederhana daripada berbasis header dan dikasih dengan baik oleh proxy.

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

SemVer untuk API

Kami mengikuti semantik semver.org:

• MAJOR (v1 → v2): perubuan yang memecahkan. Versi lama terus berjalan minimal 12 bulan setelah rilis versi baru.
• MINOR: endpoint baru, field opsional baru. Pasti kompatibel.
• PATCH: perbaikan bug, peningkatan presisi. Terlihat melalui header X-Api-Version: 1.12.3 dalam respons.

Apa yang tidak dianggap breaking change

• Menambahkan endpoint baru
• Menambahkan field opsional baru di request body
• Menambahkan field baru di respons
• Memperjelas pesan error (kode code tetap stabil)
• Perubahan akurasi perhitungan dalam batas yang dideklarasikan ±1” (planet) / ±1’ (rumah)
• Meningkatkan rate limit atau credit budget di rencanamu

Ini berarti: kodemu tidak boleh crash saat menambahkan field baru di respons. Parse hanya yang kamu butuhkan, abaikan sisanya.

Apa yang adalah breaking change (hanya di rilis mayor)

• Menghapus atau mengganti nama endpoint
• Menghapus atau mengganti nama field di respons
• Mengubah tipe field (misalnya, number → string)
• Mengubah semantik field (apa arti nama yang sama)
• Mengubah code di error respons
• Memperketat validasi yang bisa merusak request yang sebelumnya valid

Changelog

Semua perubahan ada di Changelog. Rilis minor setiap 2–4 minggu, patch sesuai kesiapan.

Berlangganan pembaruan:

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

Kebijakan Deprecation

Ketika field atau endpoint menjadi deprecated:

1. Diumumkan di changelog + pemberitahuan email
2. Header Deprecation: Sun, 01 Nov 2026 00:00:00 GMT muncul di respons (standar RFC 8594)
3. API yang deprecated terus berjarkan minimal 12 bulan
4. Penghapusan: hanya di rilis mayor berikutnya