백엔드
데이터가 없을 때 200인가 404인가?
두줄요약
올바른 경로로 조회했지만 데이터가 없을 때 200과 404 중 무엇이 맞는지 정리했습니다. 빈 리스트 응답은 200으로 통일하고 사내 API 표준 가이드를 만들 필요를 이야기했습니다.
핵심 내용
- 주문 리스트처럼 올바른 경로로 조회했지만 데이터가 비어 있는 경우, 404보다 200과 빈 값 응답이 더 적절하다는 논의
- 400, 404, 204의 HTTP 의미를 살펴보고, 빈 리스트 응답과 에러 응답을 구분할 필요성 정리
- 4xx를 정상 예외처럼 늘리면 운영과 해석이 어려워질 수 있어, 사내 표준 가이드 작성 필요성 제기
적용해볼 점
- 빈 리스트 응답은 200과 명시적 빈 값으로 통일하는 방향 검토
- API 상태 코드 기준을 FE와 BE가 함께 합의해 표준화
- 마이크로서비스 환경에서 응답 코드 해석 기준을 먼저 정리