API 버전 관리

Outcome：Complete the task with API 버전 관리 (API Versioning)。 User context：급여 API는 OpenAPI 계약 `2026-07`을 발표하고 `/v1` 클라이언트의 작동을 유지합니다. 선택적 필드 추가는 이를 깨뜨리지 않습니다. `netPay`를 정수 센트에서 소수로 변경하려면 새로운 주 버전 계약이 필요합니다. 또한 이전 안내, 폐기 헤더, 사용 데이터, 종료 날짜가 필요합니다. Technical concept or control：API 버전 관리 (API Versioning)。 Why it fits：호환성 규칙, 변경 유형, 검색 방법, 지원 기간 및 사용 중단 정책을 먼저 설정합니다. 그런 다음 경로, 미디어 유형 또는 헤더 스타일을 선택합니다. Do not use it when：매 릴리스마다 새로운 API 버전을 만들지 마십시오. 사용 데이터와 오래된 버전을 종료할 방법 없이 지원을 영원히 약속하지 마십시오. Engineering requirements: Define inputs, outputs, contracts, and rules that must always hold. Set authorization and input checks. Define failures, timeouts, retries, one-time effects, data moves, and compatibility limits. Operations: Add useful signals and logs that hide sensitive data. Set capacity limits and write an operator guide. Test recovery and rollback. Acceptance criteria: Contract and failure-path tests pass. Data and authorization rules still hold during retries and partial failures. Check performance limits, monitoring, recovery, and rollback. Evidence and limits (evidence boundary)：하나의 공식 표준이 전체 용어를 통제하지 않음. 의미는 팀, 플랫폼 또는 프레임워크마다 달라질 수 있음. Unknowns to confirm: Where the code runs, data stores, traffic shape, consistency needs, and the security boundary. Also confirm the compatibility period, service goals, and rollback limits.