

내가 만든 API를 널리 알리기 - Spring REST Docs 가이드편
Spring REST Docs의 테스트 기반 API 문서화와 Swagger 대비 선택 기준을 소개했습니다. OpenAPI 명세와 Swagger UI를 결합해 정적 문서와 API 호출 편의성을 함께 확보했습니다.
#Spring REST Docs#Swagger
100
새로운 기술 블로그가 추가되었어요


Spring REST Docs의 테스트 기반 API 문서화와 Swagger 대비 선택 기준을 소개했습니다. OpenAPI 명세와 Swagger UI를 결합해 정적 문서와 API 호출 편의성을 함께 확보했습니다.


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

TSOA로 Express 기반 TypeScript API의 비동기 처리, 요청 검증, 문서화 문제를 줄였습니다.\n컨트롤러·DTO 정적 분석과 JSDoc으로 밸리데이션 및 OpenAPI 생성을 자동화합니다.


Flask API의 검증 스키마를 marshmallow로 정의하고 OpenAPI 문서 생성에 재사용했습니다.\napispec을 연동해 API 명세 작성과 공유를 자동화하는 방식을 소개합니다.