Spring Boot 프로젝트를 하면서, API 문서를 정리하기 위해 Swagger를 사용하면서 알게 된 점들을 정리했다. Swagger는 대표적인 API 명세서 Tool이다. Notion 혹은 Postman 혹은 엑셀 등등… 을 이용해서 API 명세서를 관리하는 것 역시 좋지만, 이러한 API의 경우 API에 수정사항이 생겼을 때, 관리하기 어려운 점이 있습니다. 개발 후에 명세서 작성을 놓치는 경우도 있고, 개발한 code와 API 명세서가 다른 Human Error가 생기는 경우도 빈번하게 있습니다… (JSON key 하나만 잘못 써도 요청이 제대로 안들어가니까요..) 따라서 API 명세서를 code로 관리하면, 조금 더 편리하고 오류 없이 관리할 수 있습니다… 그래서 사용하는 것이 Swagger라..
