모든 태그
태그

Swagger 기술 블로그 글

Swagger 태그가 달린 국내 IT 기업 기술 블로그 글을 최신순으로 모았습니다.

전체 9최신 9개 표시
홈에서 필터

최신 게시글

9개 표시

아키텍처

[AI가 읽을 수 있는 코드베이스 3/5] Standalone App: 도메인 슬라이스 독립 실행

Hexagonal Architecture로 Issue 도메인을 standalone-app으로 독립 실행해 핵심 비즈니스 로직만 검증하는 구조를 소개했습니다. AI 에이전트의 빠른 피드백 루프와 격리된 검증 환경을 만드는 방법을 설명했습니다.

#Hexagonal Architecture#Kotlin#Spring Boot
3200

프론트엔드

“왜 노출이 안 될까?”를 한 번에 추적하는 방법

모듈매장 노출 이슈를 추적하기 위해 요청 흐름을 하나의 식별자로 묶는 디버깅 도구를 만들었습니다. 분산 로그를 한 화면에서 확인하고 직접 재현까지 하도록 확장해 운영 대응 속도를 높였습니다.

#MSA#Kafka#MongoDB
8200

기타

토스인컴 QA Platform: ‘누구나 테스트할 수 있는’ 도구의 시작

Swagger에 있던 Test API를 누구나 쉽게 실행할 수 있도록 내부 QA Platform으로 정리했습니다.\n버튼 기반 실행과 자동화 통합으로 테스트 장벽을 낮추고 품질 검증 속도를 높였습니다.

#QA#Swagger#API
11400

프론트엔드

React Query 버전업 과정에서 발견한 API 관리 구조의 결함

React Query 버전업 과정에서 코드 생성 기반 API 관리 구조의 결함을 발견했습니다. 라이브러리 의존성을 분리하고 어댑터로 호환성을 확보하는 방향으로 개선했습니다.

#React Query#OpenAPI Generator#Swagger
1900

백엔드

API 가이드 vs. API 스펙, 뭐가 다른거야?

API 가이드와 API 스펙의 차이를 설명하고, OpenAPI와 TypeSpec을 사례로 비교했습니다. API 정의 언어를 활용한 일관성, 문서 자동화, 유지 보수 이점도 정리했습니다.

#API#OpenAPI#Swagger
7800

프론트엔드

API 문서화, TS 타입만 있으면 해결! – Tspec

TypeScript 타입과 JSDoc만으로 API 문서와 OpenAPI Spec을 자동 생성하는 Tspec을 소개했습니다. 기존 코드 변경을 최소화하면서 문서화, 테스트, 최신화 부담을 줄이는 방법을 설명했습니다.

#TypeScript#REST API#OpenAPI
3300

백엔드

마이크로 서비스 환경에서 통합된 API 문서 서버 구축하기

마이크로 서비스 환경에서 흩어진 API 문서를 OpenAPI로 통일해 공용 문서 서버를 구축했습니다. GitHub Action과 S3로 배포마다 문서를 자동 갱신해 관리 부담을 줄였습니다.

#MSA#API#Swagger
2500

백엔드

내가 만든 API를 널리 알리기 - Spring REST Docs 가이드편

Spring REST Docs와 Swagger(Springdoc)를 비교하며 API 문서화 선택 기준을 정리했습니다. 또한 테스트 기반 문서 생성과 Swagger UI 결합 방법까지 소개했습니다.

#Spring REST Docs#Swagger#Springdoc
2800

백엔드

OpenAPI Specification을 이용한 더욱 효과적인 API 문서화

OpenAPI Specification을 이용한 API 문서화 방법을 소개했습니다. Swagger와 Spring REST Docs의 장점을 함께 활용하는 방향을 공유했습니다.

#OpenAPI Specification#API#문서화
2400