윤지지 ·
2025.08.28 ·
조회 67
REST API에서 Swagger, 꼭 써야함?
개발하다 보면 API 문서화 걱정하는 사람 많더라. Swagger 쓰면 뭐가 그렇게 좋냐 물으면, 일단 문서 자동생성되는 게 개꿀이다. 컨트롤러에 어노테이션만 붙이면 프론트/백엔드 다 소통 편해지고, 뭐 테스트도 바로 해볼 수 있음. 굳이 손으로 엑셀 문서 만들 필요도 없고, 경로·파라미터 같은 거 까먹을 일도 없음.
솔직히 사이드 프로젝트나 작은 팀에서도 하나 설치해두면 꿀. 배포할 때마다 문서 새로 만들던 시절 생각하면 진짜 꿈같음ㅋㅋ 근데 팀이나 회사에서 Swagger 안쓰고 구닥다리 문서 계속 쓰자는 사람 있으면, 실무에서 얼마나 시간낭비인지 좀만 설명해주면 됨. 이거 쓰다가 다른 거 못 돌아감😋