REST API 질문입니다~

Question

안녕하세요. 핵심 프레임워크, 부트, MVC, JPA에 이어 목표로 하는 마지막 강의 REST API를 듣고 있습니다. 이번 강의에서 다루는 REST API를 적용하면 좋을 기준이 있는지 여쭈어 보고 싶어서 질문 남깁니다. 이번에 MSA 를 기반으로 한 프로젝트를 시작하면서, API설계에 고민이 있습니다. 각 서비스간, 프론트단에서 API를 호출하여 사용할 것 같은데 이때, Self-drescriptive message, HATEOAS 를 적용한 API 를 적용하는게 맞는지 궁금합니다. 서비스 간 API호출 부분에서는 API를 호출하는 쪽, 제공하는 쪽 모두 혼자 개발을 한다면, 링크 정보를 제공하여 전이를 쉽게 할 수는 있지만, docs 같이 메시지에 대한 설명 정보를 함께 전달해야 하는 의문이 있습니다. 프론트단에서 사용하는 API도 같은 생각입니다. 백기선님 생각이 궁금합니다. 읽어주셔서 감사합니다ㅎㅎ

백기선 · Answer

혼자 모두 개발하는 경우에는 과한 선택이라고 생각합니다. 간단하게 API에 버저닝을 하고 REST API가 아니라 HTTP API 정도로 만들어 사용하시는게 편하실거 같네요.