스킬 관리Skill조회 0

Golang Swagger

Go 프로젝트에서 Swagger/OpenAPI 문서를 생성 및 관리할 때 사용하는 도구입니다.

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

따라 하는 방법

  1. /swagger/index.html 세션을 실행합니다.
  2. /users/{id} 세션을 실행합니다.
03

설치 방법

npx skills add installs: 31320 --skill golang-swagger