バージョニング

AstroWay API は URL versioning を採用しており、バージョンはリクエストパスに含まれます。ヘッダーベースより簡単で、プロキシでもキャッシュしやすい方式です。

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

API の SemVer

semver.org のセマンティクスに従います:

• MAJOR (v1 → v2): 互換性を壊す変更。旧バージョンは新バージョンのリリース後、少なくとも 12 か月間は動作し続けます。
• MINOR: 新しいエンドポイント、新しいオプションフィールド。必ず後方互換です。
• PATCH: バグ修正、精度の改善。レスポンスの X-Api-Version: 1.12.3 ヘッダーで確認できます。

breaking change に該当しないもの

• 新しいエンドポイントの追加
• request body への新しいオプションフィールドの追加
• レスポンスへの新しいフィールドの追加
• エラーメッセージの文言の改善 (code は変わりません)
• 公表している許容範囲 ±1” (惑星) / ±1’ (ハウス) 内での計算精度の変化
• ご利用プランの rate limit や credit budget の引き上げ

つまり、レスポンスに新しいフィールドが追加されてもコードが壊れてはいけません。必要なものだけをパースし、それ以外は無視してください。

breaking change に該当するもの (メジャーリリースでのみ)

• エンドポイントの削除または名前変更
• レスポンスのフィールドの削除または名前変更
• フィールドの型の変更 (たとえば number → string)
• フィールドの意味の変更 (同じ名前が別のものを表すようになる)
• エラーレスポンスの code の変更
• 以前は有効だったリクエストを失敗させうるバリデーションの厳格化

Changelog

すべての変更は Changelog に掲載されます。マイナーリリースは 2〜4 週間ごと、パッチは準備でき次第リリースします。

更新を購読するには:

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

Deprecation policy

フィールドやエンドポイントが deprecated になる場合:

1. changelog とメールでお知らせします
2. レスポンスに Deprecation: Sun, 01 Nov 2026 00:00:00 GMT ヘッダーが付くようになります (RFC 8594 標準)
3. deprecated の API は少なくとも 12 か月間動作し続けます
4. 削除は次のメジャーリリースでのみ行います