일시적으로 기능을 끄고 켜는 endpoint를 위한 에러 코드는 뭐가 좋을까요?

안녕하세요! 최근에 저희도 내부적으로 이런 HTTP status code에 대한 리뷰를 했었는데, 그때 잠깐 언급된 주제여서 답변 남깁니다. 우선 저는 막연하게 403 forbidden 같은걸 내려주면 되지않을까라는 생각했습니다. 기능 자체가 없어지는 것은 아니기 때문에 접근 권한이 없다 라는 에러 코드면 괜찮다고 생각했어요. 다른 엔지니어분은 404 not found를 제안해주시더라구요. 사용자 입장에서는 권한이 없는게 아니라 기능이 없는 것과 같다라고 하시더군요. 근데 또 어떤 분은 404 not found는 resource에 관련된 거라면 이해하는데 그게 아니라면 애매하지 않냐라고 하시더라고요. 그래서 SO 같은 곳에서 여러 예시를 찾아보기도하고 chat gpt에 물어보니까 역시나 정해진 정답은 없었습니다. 404 not found를 추천해주는 사람도 많고, 403으로 구현된 api도 종종 보이더라고요. 결국 기능이 어떤 기능인가, 어떤 리소스를 조작하는가 등에 따라서 에러 코드는 달라질 수 있다고 생각합니다. 팀 내에서 논의 후 정한 것으로 구현하면 되지 않을까 싶네요 :) - https://learn.microsoft.com/en-us/rest/api/cosmos-db/http-status-codes-for-cosmosdb (여긴 403) - https://stackoverflow.com/questions/60284335/what-http-status-code-do-you-use-when-endpoint-is-disabled-by-feature-flag-fea - https://learn.microsoft.com/en-us/azure/azure-app-configuration/use-feature-flags-dotnet-core?tabs=core5x (여긴 404) - https://www.ibm.com/docs/en/alm/1.3.0?topic=reference-api-http-status-codes (여긴 404)