restdocs

restAssured를 이용한 restDocs 와 OAS

들어가며 요즘카페 팀 프로젝트를 진행하면서 API 명세서는 노션을 통해 관리하고 있었다. 단순하게 노션을 이용하니 최신화, 오타 등 휴먼에러들이 많이 발생하였고 API 문서화 툴을 사용해서 작업하기로 하였다. 가장 도움이 많이 되었던 것은 공식문서이다. Spring REST Docs Spring REST Docs Document RESTful services by combining hand-written documentation with auto-generated snippets produced with Spring MVC Test or WebTestClient. docs.spring.io API 문서화 도구 도구로써 RestDocs와 Swagger를 고민하였다. Swagger 러닝커브가 적고, UI가 ..