API 영구 이동을 308로 보낼 때 되돌리기 전에 생각할 것

308은 영구 이동이며 요청 의미를 유지합니다

308은 영구적으로 새 위치를 알리는 리다이렉트이며 메서드와 본문을 바꾸지 않는 의미를 가집니다. 시험용 이동에 영구 코드를 사용하면 클라이언트의 이후 동작과 캐시를 고려해야 합니다. 목적지가 준비되기 전 적용하지 않습니다.

주소 이전과 데이터 이전을 따로 계획합니다

같은 API 기능과 인증·권한·오류 계약이 새 주소에서 유지되는지 확인합니다. DNS가 새 주소를 가리킨다는 사실만으로 기존 클라이언트의 URL이 바뀌지는 않습니다. SDK나 웹훅 호출 주체가 이동을 따르는지도 조사합니다.

대표 조회뿐 아니라 변경 요청도 검증합니다

비밀 없는 시험 자원으로 각 메서드의 처리 결과를 비교합니다. 문제가 생겼을 때 원래 주소로 되돌릴 수 있는지와 클라이언트에 남은 이동 정보를 어떻게 처리할지 정합니다. 단순 3xx 응답을 업무 성공으로 집계하지 않습니다.

서버 운영 실행 전 점검표

• 308은 영구 이동이며 요청 의미를 유지합니다
• 주소 이전과 데이터 이전을 따로 계획합니다
• 대표 조회뿐 아니라 변경 요청도 검증합니다