SLA 99.9% uptime

アップタイム保証

アップタイムはカレンダー月単位で、https://api.astroway.info/v1/health が HTTP 200 ステータスで 1,000 ms 以内に応答したかで計測する。計画メンテナンスは（少なくとも 48 時間前にステータスページで告知）計算に含まれない。

目標遅延

api.astroway.info/v1/* で単一リージョンから測定し、サーバー側の計算時間のみ（クライアントやネットワークは除外）を対象とする。完全な四半期レポートはステータスページで公開する。

標準エンドポイント

Chart、planets、synastry、transits、progressions、ACG、geodetic、solar-return など。

Disclaimer: 実測値は api-calc の内部サンプリングで、公開された production-telemetry ダッシュボードはロードマップにある。注意: p99 は最高の極端値で、p50 よりかなり遅い。

重いエンドポイント

複数日集計: transit-calendar、forecast-calendar、moon-aspects、aspect-timeline、group-synastry、eclipse-analysis。

リクティフィケーション

POST /v1/rectification (最大 120 s) と POST /v1/rectification/trutine (最大 15 s) は性質上長時間かかり、SLA の遅延対象外です。Request-Timeout ヘッダーは最大 180 s を尊重します。

レート制限

rateLimitMiddleware でキーごとのソフトレートリミットを適用し、Retry-After ヘッダーと共に HTTP 429 を返す。

公開サンドボックス (POST /v1/public/chart) は IP ごとに制限され、1 時間あたり 30 リクエスト、API キーなしで利用できる。

リクエスト識別

各レスポンスは X-Request-Id ヘッダー (UUID) を含む。インシデントを報告するときはそれを付けてくれ。アクセスログは 30 日保存し、request-id だけで呼び出しを完全に再現できる。

HTTP 5xx の場合、同じ識別子がレスポンスボディに複製される:

{
  "ok": false,
  "error": {
    "code": "INTERNAL_ERROR",
    "message": "Internal server error",
    "request_id": "c07b5c55-7637-4add-bd2e-7c7c4deb365f"
  }
}

インシデント対応

インシデントは support@astroway.info に request-id を添えて報告してくれ。SEV-1 の場合はステータスページも確認しよう。

バージョニングと非推奨化

• /v1/ 配下のエンドポイントはメジャーバージョン内で後方互換性を保つ。
• 破壊的変更は /v2/ で提供され、/v1/ は最低 12 ヶ月間は動作し続ける。
• フィールド追加は破壊的変更とみなされない。クライアントは未知のフィールドを無視すべき。
• 非推奨化は changelog で告知され、アカウント所有者にメールで最低 90 日前に通知される。

サポートチャネル