RESTful2 Spring swagger 적용 API 문서 관리의 어려움 Rest API 서버를 개발하다 보면, API Spec에 대해 문서화를 해서 Frontend 개발자들에게 배포를 해야 한다. 보통 자체 양식으로 문서화하여 배포하는 방식이 기존의 방식이라 할 수 있다. 하지만, 이러한 방식은 문서 관리도 쉽지 않고 만드는 사람이 여러 사람이다 보니 관리가 쉽지 않다. 이에 Swagger라는게 있다. 예전에 S기업의 프로젝트를 진행하면서, Swagger라는 것을 처음 구경했다. 해당 기업은 Swagger를 통해서 기간 시스템의 정보 API를 제공하고 있었다. 사용해보니, API 정보 제공자나 API 정보 이용자나 불편함이 없었다. 이용자 입장에서는 Swagger에서 테스트도 가능하고, api의 스펙을 정확히 이해할 수 있다. 정보 제공자 입장에서.. 2021. 3. 9. RESTful 의 이해 RESTful 을 사용하기 전에, 정확한 이해가 필요하다.주위 개발자들도 REST(RESTful을 줄여서 REST라고도 부른다)를 업무에 쓰고 있지만, 정확히 이해를 하지 못한채 Copy&Paste 만 하고 있다. REST란 Representational State Transfer라는 용어의 약자로, 웹의 창시자 중의 한 사람인 Roy Fielding가 2000년 논문에서 REST를 발표했다. 웹의 장점을 최대한 활용하기 위해 네트워크 기반의 아키텍처를 소개했는데, 그것이 바로 REST 다.REST는 다양한 디바이스(스마트폰, 태블릿, 통신이 필요한 사물인터넷 등) 에서도 통신을 할 수 있다.기존에 사용한 SOAP으로도 우리가 잘 살아왔는데, REST라는게 왜 나와서 우리를 귀찮게 하는 건가? 먼저 RE.. 2018. 11. 2. 이전 1 다음 반응형
