01
언제 사용하는가
swaggo/swag을 사용하여 Go 언어의 OpenAPI/Swagger 문서를 작성합니다.
@Summary, @Param, @Success, @Router, @Security 등의 어노테이션 주석을 통해 API 설명을 추가하고, swag init 명령어로 코드 생성을 자동화할 수 있습니다.
gin, echo, fiber, chi, net/http 등 다양한 프레임워크와 통합되며, Bearer/JWT, OAuth2, API key 등의 보안 정의를 지원합니다.
구조체 태그(swaggertype, enums, example, swaggerignore)도 제공하며, github.com/swaggo/swag, github.com/swaggo/gin-swagger 등 패키지를 import하는 코드베이스에서 Swagger/OpenAPI 문서를 추가하거나 유지보수할 때 사용됩니다.
02
따라 하는 방법
- /swagger/index.html 세션을 실행합니다.
- /users/{id} 세션을 실행합니다.
03
설치 방법
npx skills add installs: 31320 --skill golang-swagger