오류 응답 형식은 실패 종류가 달라도 클라이언트가 같은 자리에서 오류 코드와 상세 정보를 찾게 합니다. HTTP 상태 코드는 큰 범주를 알리고, 본문 코드는 제품 안에서 처리할 구체적 조건을 구분합니다. 유효성 오류라면 필드별 원인을 details에 담을 수 있습니다.
데모는 입력 오류·권한 오류·서버 오류가 같은 구조에 담기는 모습을 보여줍니다. 내부 스택이나 민감한 값은 공개 메시지에 넣지 말고, 안정적으로 유지할 코드의 의미를 문서화합니다.
언제 쓰나
여러 엔드포인트의 오류를 프런트엔드와 SDK가 공통 처리해야 할 때 씁니다.