실패 응답 코드는 무엇을 기준으로 고르는가?

요청이나 인증·권한·사용량 제한 같은 클라이언트 측 조건 때문에 처리할 수 없으면 4xx를 쓴다. 서버가 정상 요청을 처리하지 못하면 5xx를 쓴다. 원인과 재시도 가능성을 코드에 담아야 한다.

400은 요청 형식이 잘못된 경우다. 401은 인증이 필요하고 403은 신원을 알아도 권한이 없다. 존재를 숨기려면 404를 택할 수도 있다.

409는 현재 자원 상태와 충돌할 때 적합하다. 문법은 맞지만 필드 검증에 실패한 요청은 API 규약에 따라 400 또는 422로 일관되게 처리한다.

503은 일시적 과부하나 점검을 알린다. Retry-After를 주면 재시도 시점을 안내할 수 있다. 내부 오류를 모두 200으로 감싸면 중간 장비가 실패를 오해한다.