버전 관리

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

API의 SemVer

우리는 semver.org의 시맨틱 버전을 따릅니다:

• MAJOR (v1 → v2): 주요 변경. 새 버전 출시 후 기존 버전은 최소 12개월 동안 계속 작동합니다.
• MINOR: 새 엔드포인트, 새로운 선택적 필드. 완전히 호환됩니다.
• PATCH: 버그 수정, 정밀도 개선. 응답의 헤더 X-Api-Version: 1.12.3에서 볼 수 있습니다.

주요 변경이 아닌 것들

• 새 엔드포인트 추가
• 요청 본문에 새로운 선택적 필드 추가
• 응답에 새 필드 추가
• 오류 메시지 텍스트 개선 (코드 code는 안정적으로 유지됨)
• 선언된 범위 내에서 계산 정확도 변경: ±1” (행성) / ±1’ (하우스)
• 플랜의 rate limit 또는 credit budget 증가

이것은 다음을 의미합니다: 응답에 새 필드가 추가되어도 당신의 코드는 중단되지 않아야 합니다. 필요한 것만 파싱하고 나머지는 무시하세요.

주요 변경 사항 (마이너 버전에서만)

• 엔드포인트 제거 또는 이름 변경
• 응답 필드 제거 또는 이름 변경
• 필드 유형 변경 (예: number → string)
• 필드 의미 변경 (동일한 이름이 의미하는 바 변경)
• 오류 응답에서 code 변경
• 이전에 유효했던 요청을 깨뜨릴 수 있는 유효성 검사 강화

변경 기록

모든 변경 사항은 변경 기록에 있습니다. 마이너 버전은 2-4주마다, 패치는 준비되는 대로 출시됩니다.

업데이트 구독:

• RSS: https://api.astroway.info/changelog/rss.xml
• 이메일: 대시보드의 설정 → 알림 → 제품 업데이트

폐지 정책

필드 또는 엔드포인트가 폐지될 때:

1. 변경 기록 및 이메일 알림으로 공지
2. 응답 헤더에 추가됨: Deprecation: Sun, 01 Nov 2026 00:00:00 GMT (RFC 8594 표준)
3. 폐지된 API는 최소 12개월 동안 계속 작동합니다
4. 제거: 다음 주요 버전에서만