스웨거란 Open Api Specification(OAS)를 위한 프레임워크다.

OAS는 RESTful 웹서비스를 약속된 규칙에 따라 약속된 규칙에 맞게 API 스펙을 json과 yaml 형식으로 표현한다. 이를 통해, 직접 소스코드를 보거나 추가 문서 필요없이 서비스를 이해할 수 있다.

스웨거는

• API들이 가지고 있는 Specification(스펙/명세)를 관리할 수 있는 프로젝트다.
• OpenAPI 스펙을 맞춘 api-docs를 이용하여 html 페이지로 문서화해주는 프레임워크로, RESTful의 설계 및 문서화에 도움을 준다.
• → OAS 기반의 API 문서 자동 생성 도구
• Spring Boot에서 Swagger UI 사용 → API 명세 자동 생성 → 브라우저에서도 API 테스트 가능

1. API 디자인
   1. Swagger-editor를 통해 api를 문서화하고 빠르게 명세할 수 있다.
2. API Development
   1. Swagger-codegen을 통해 작성된 문서를 통해 SDK를 생성 → 빌드 프로세스 간소화
3. API Documnetation
   1. Swagger-UI를 통해 작성된 API를 시각화
4. API Testing
   1. Swagger-Inseptor를 통해 API를 시각화 → 빠른 테스팅을 진행
5. Standardize
   1. Swagger-hub를 통해 개인, 팀원들이 API 정보를 공유하는 Hub