응답 계약

상태 코드와 헤더가 클라이언트의 다음 행동을 결정한다

HTTP 응답은 성공과 실패를 알리는 것에서 끝나지 않고 재시도, 인증, 캐시, 리다이렉트 행동을 지시합니다.

2xx

요청 처리 결과를 본문과 함께 해석하고 생성이면 Location 헤더를 확인합니다.

3xx

Location, 301/302/307/308의 메서드 보존 차이를 확인합니다.

4xx

인증, 인가, 검증 오류처럼 클라이언트가 바꿔야 할 조건을 뜻합니다.

5xx

업스트림 실패, 과부하, timeout처럼 서버나 중간 장비 문제를 의심합니다.

헤더 기준

Cache-Control, Content-Type, Authorization, Retry-After를 함께 봅니다.

API 설계

401과 403, 409와 422처럼 클라이언트 행동이 달라지는 코드를 구분합니다.

상태 코드 판별

상태 코드 하나를 보고 재시도할지, 로그인할지, 요청을 고칠지 말합니다.