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 など。

免責事項: 実績値は内部モニタリング api-calc からのサンプリングです。公開の production-telemetry ダッシュボードは roadmap に含まれています。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 によるソフト制限。HTTP 429 を返し、Retry-After ヘッダーが付与されます。

公開サンドボックス（POST /v1/public/chart）は IP ベースで制限されています（30 リクエスト / 時間、API キー不要）。

リクエスト識別

すべてのレスポンスに X-Request-Id（UUID）ヘッダーが含まれます。インシデント報告時にはこれを添付してください。アクセスログを 30 日間保存しており、リクエスト ID から完全なリクエストを再現できます。

HTTP 5xx エラー時には、同じ ID がレスポンスボディにも含まれます：

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

インシデント対応

support@astroway.info までリクエスト ID とともに報告してください。SEV-1 の場合はステータスページも確認してください。

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

• エンドポイントは /v1/ 配下で提供され、メジャーバージョン内では後方互換性を維持します。
• 破壊的変更は /v2/ 配下でリリースされ、/v1/ は少なくとも 12 か月間稼働し続けます。
• フィールドの追加は破壊的変更とみなされません。クライアントは未知のフィールドを無視する必要があります。
• 非推奨化は changelog でアナウンスされ、アカウント所有者に 90 日前までにメールで通知されます。

サポートチャネル