[실습] Swagger UI를 활용한 테스트 - OpenAI API

JSCODE 시니

2026. 06. 13.

✅ 1. Swagger UI란 무엇일까?

• Swagger UI는 RESTful API를 문서화하고 시각화하는 오픈소스 도구

• Swagger UI를 사용하면 API 사용자가 API를 쉽게 이해하고 사용할 수 있도록 API의 엔드포인트, 매개변수, 요청 및 응답 본문 등을 시각적으로 표시할 수 있음.

✅ 2. 의존성 추가

Maven Repository: org.springdoc » springdoc-openapi-starter-webmvc-ui » 3.0.1

https://mvnrepository.com/artifact/org.springdoc/springdoc-openapi-starter-webmvc-ui/3.0.1

dependencies {
	implementation 'org.springframework.boot:spring-boot-starter-webmvc'
//	implementation 'org.springframework.ai:spring-ai-starter-model-ollama'
	implementation 'org.springframework.ai:spring-ai-starter-model-openai'
	implementation("org.springdoc:springdoc-openapi-starter-webmvc-ui:3.0.1")
	testImplementation 'org.springframework.boot:spring-boot-starter-webmvc-test'
	testRuntimeOnly 'org.junit.platform:junit-platform-launcher'
}

✅ 3. 테스트

• 반드시 Try it out 버튼을 클릭하여 테스트 진행

• userPrompt 입력

• 예: Spring AI에 대해서 설명해주세요.

• 답변이 잘 나오는지 확인한다.