API 401/403/404를 전부 auth 문제로 묶으면 디버깅이 느려집니다

API 오류 기록에서 401, 403, 404를 어떻게 나눠 적는지 묻는 질문.

API 연동 오류에서 401, 403, 404를 전부 auth 문제로 묶으면 수정을 랜덤하게 하게 됩니다. 401은 credential loading, 403은 permission이나 plan scope, 404는 route/resource/deployment mismatch일 수 있습니다. 물론 일부 API는 권한 없는 리소스를 404처럼 숨기기도 하니 request ID, caller role, endpoint pattern, API error code를 같이 기록하는 게 좋습니다. 여러분은 API 오류 노트에 어떤 필드를 꼭 남기나요?