목록 보기
데이터가 없을 때 200인가 404인가?
백엔드

데이터가 없을 때 200인가 404인가?

요기요
요기요
2023년 11월 29일

두줄요약

올바른 경로로 조회했지만 데이터가 없을 때 200과 404 중 무엇이 맞는지 정리했습니다. 빈 리스트 응답은 200으로 통일하고 사내 API 표준 가이드를 만들 필요를 이야기했습니다.

핵심 내용

  • 주문 리스트처럼 올바른 경로로 조회했지만 데이터가 비어 있는 경우, 404보다 200과 빈 값 응답이 더 적절하다는 논의
  • 400, 404, 204의 HTTP 의미를 살펴보고, 빈 리스트 응답과 에러 응답을 구분할 필요성 정리
  • 4xx를 정상 예외처럼 늘리면 운영과 해석이 어려워질 수 있어, 사내 표준 가이드 작성 필요성 제기

적용해볼 점

  • 빈 리스트 응답은 200과 명시적 빈 값으로 통일하는 방향 검토
  • API 상태 코드 기준을 FE와 BE가 함께 합의해 표준화
  • 마이크로서비스 환경에서 응답 코드 해석 기준을 먼저 정리

다음 읽기

#REST API 주제를 다룬 다른 회사 글

IllegalArgumentException은 400 Bad Request인가?

IllegalArgumentException을 무조건 400으로 매핑하면 서버 오류를 클라이언트 문제로 오인할 수 있습니다. 명백한 클라이언트 오류는 커스텀 예외로 분리해 4xx와 5xx를 구분하는 것이 좋습니다.

우아한 형제들
우아한 형제들
백엔드

댓글 0

댓글을 작성하려면 로그인이 필요합니다.

댓글을 불러오는 중...