SLA 99.9% uptime

가동 시간 보장

가동 시간은 매월 https://api.astroway.info/v1/health 엔드포인트의 HTTP 200 응답(1,000ms 이내)으로 계산됩니다. 정기 점검(최소 48시간 전에 상태 페이지에서 공지)은 계산에서 제외됩니다.

목표 지연 시간

api.astroway.info/v1/* 엔드포인트의 서버 측 계산 시간(클라이언트 및 네트워크 시간 제외)을 기준으로 측정합니다. 분기별 보고서는 상태 페이지에서 공개됩니다.

표준 엔드포인트

Chart, planets, synastry, transits, progressions, ACG, geodetic, solar-return 등.

고지 사항: 실제 수치는 내부 api-calc 모니터링 샘플링 결과입니다. 공용 프로덕션 텔레메트리 대시보드는 로드맵에 있습니다. 참고: p99는 가장 높은 극값을 나타내므로 p50보다 훨씬 큰 값이 나올 수 있습니다.

무거운 엔드포인트

장기간 집계가 필요한 엔드포인트: transit-calendar, forecast-calendar, moon-aspects, aspect-timeline, group-synastry, eclipse-analysis.

rectification

POST /v1/rectification(최대 120초)과 POST /v1/rectification/trutine(최대 15초)은 본질적으로 장시간 작업이며 지연 시간 SLA에서 제외됩니다. 이들은 Request-Timeout 헤더(최대 180초)를 존중합니다.

요청 제한

rateLimitMiddleware에서 키당 분당 요청 수를 부드럽게 제한하며, HTTP 429와 Retry-After 헤더를 반환합니다.

공용 샌드박스(POST /v1/public/chart)는 IP당 시간당 30회 요청으로 제한되며, API 키가 필요 없습니다.

요청 식별

모든 응답에는 X-Request-Id 헤더(UUID)가 포함됩니다. 인시던트를 보고할 때는 이 ID를 포함해 주세요. 우리는 30일 동안 액세스 로그를 보관하며, 요청 ID만으로도 전체 호출을 재구성할 수 있습니다.

HTTP 5xx 오류 발생 시 동일한 식별자가 응답 본문에 포함됩니다:

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

인시던트 대응

인시던트는 support@astroway.info로 요청 ID와 함께 보고해 주세요. SEV-1의 경우 상태 페이지도 확인하세요.

버전 관리 및 폐기

• 엔드포인트는 /v1/ 하위에 있으며 메이저 버전 내에서 하위 호환성을 유지합니다.
• breaking change는 /v2/ 하위에 출시되며 /v1/은 최소 12개월 동안 계속 운영됩니다.
• 필드 추가 변경은 breaking으로 간주되지 않으며 클라이언트는 알 수 없는 필드를 무시해야 합니다.
• 폐기는 changelog에서 공지되며, 계정 소유자에게 최소 90일 전에 이메일로 발송됩니다.

지원 채널