Velopers 홈

오늘 새 글

9개

오늘 조회수

1,481회

필터 1

2026년 7월 20일

백엔드

Swagger 기반 API 명세 자동화 PoC

고객사 환경 제약 때문에 Swagger를 서비스에 직접 붙이지 않고, 중앙 서버와 YAML 파일로 API 명세를 통합하는 PoC를 검증했습니다. 또한 Custom Annotation 기반으로 배포 시점에 명세를 자동 생성하는 확장 방향도 살펴봤습니다.

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

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

#Hexagonal Architecture#Kotlin

33005분

2026년 3월 18일

프론트엔드

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

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

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

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

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

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

#React Query#OpenAPI Generator

21005분

2024년 9월 11일

백엔드

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

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

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

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

#TypeScript#REST API

33005분

Velopers 추천광고

쿠팡 파트너스

개발자를 위한 인기 상품을 확인해 보세요

이 게시물은 쿠팡 파트너스 활동의 일환으로, 이에 따른 일정액의 수수료를 제공받습니다.

#개발자#노트북#컴퓨터

2023년 1월 30일

백엔드

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

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

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

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

#Spring REST Docs#Swagger

29005분

2022년 8월 22일

백엔드

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

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

#OpenAPI Specification#API

26005분