REST Docs

API 문서화 보통 서버 개발을 진행할 때, API Spec을 먼저 작성하고 Client에게 공유해서 같이 작업하는 방향을 맞춰나가는 식으로 많이 하죠?ㅎㅎ 하지만 작업이 진행되면 진행될수록 API Spec이 처음에 나왔던 Spec하고 비슷하면 정말 다행이겠지만.! 대게는 많이 같지가 않죠ㅠㅠ 그래서 Production Code를 바꾸면, Spec도 바꿔야 하는데... 우리의 실상은? 잘 까먹더라구요ㅠㅠ 그래서 자동화할 수 있는 방법에 대해 알아보도록 할게요~! Swagger vs REST Docs 보통 Spring 진영에서 API Spec을 자동화하는 Tool로는 Swagger REST Docs 크게 2개로 나뉘어지는데요, Swagger의 경우에는 Production Code에 어노테이션을 기반으로 해..
huisam
'REST Docs' 태그의 글 목록