스웨거는 RESTful API를 설계, 빌드, 문서화 사용하는 데 도움을 주는 오픈 소스 도구 세트의 모음이다.
가장 핵심적인 기능은 API 문서를 자동화하여 개발 과정을 효율적으로 만들어주는 것이다.
쉽게 말해 백엔드 개발자가 API를 만들 때 이 API가 어떤 기능을 하고, 어떤 데이터를 주고 받는지 등을
한 눈에 볼 수 있도록 “설명서”를 자동으로 만들어주는 도구하고 생각하면 된다.
스웨거는 주로 다음과 같은 구성 요소들로 이뤄져 있다.
이것은 API를 사람이 읽고 기계가 이해할 수 있는 형식으로 설명하기 위한 표준 언어다.
스웨거 도구를은 이 사양에 기반하여 동작한다.
또한, 어떤 API가 있는지, 어떤 요청(request)을 보내야 하는지, 어떤 응답(response)을 받게 될 것인지 등을 정의한다.
과거에는 “Swagger Specification”이라고 불렀지만, 현재는 “OpenAPI Specification”으로 명칭이 변경되었다.
API 문서를 웹 브라우저를 통해 시각적으로 쉽게 볼 수 있도록 해주는 도구다.