오늘 걷지 않으면 내일 뛰어야 합니다

REST API Framework Swagger 탐방기 2부 1부에서 대충 Swagger가 무엇을 하는 것이지 알아보았는데요대충 요약을 해보자면1. REST API 스펙을 정의한다2. 스펙에 맞는 REST API Document 페이지를 만들어준다.3. 필요하면 REST API 서버도 만들어준다. (물론 Business Logic은 비어 있어요)정도가 되겠네요 계속 설명만 보니까 뭔가 사알짝 부족한 감이 있네요더 이상은 실제로 어떻게 동작하는지를 봐야 할 것 같네요 마침 홈페이지에 Live Demo가 있네요그래서 한번 들어가 봤습니다. Swagger를 통해서 만들어진 REST API Document 페이지는 이런가 봅니다.리소스 별로 그룹화 되어서 나오네요 이런 식으로 메뉴 확장을 통해 구현된 API 리..

REST API Framework Swagger 탐방기 1부 현재 MEAN 스택으로 (꽁냥꽁냥) 웹 어플리케이션을 만들고 있었는데요. 어느정도 어플리케이션 규모가 커지다 보니, 사용하는 REST API 양도 꽤 많아 지더군요.(물론 제가 프로젝트 관리에 소홀했던 탓이 크겠죠 하하) 아무래도 매일매일 들여다 보는 프로젝트가 아니다 보니, 작은 기능을 추가하려고 할 때마다. 실제 기능 구현하는 시간보다, 전체 프로젝트 구조를 다시 파악하는데 더 많은 시간을 소모했죠슬슬 문서화의 중요성이 필요해졌죠(문서화 넘나 어려운 것, 그리고 넘나 귀찮은 것)일단, 현재 사용중인 RESTful API 들을 먼저 문서화 해야겠다는 생각이 들었습니다.(사실 이미 만든 API 못 찾아서 또 만들었던 기억이) 그런데 대체 문서화..