SwaggerHub는 OpenAPI 설계의 핵심 플랫폼으로 자리 잡았고, SmartBear는 이후 포털, 테스팅, 계약 테스팅 모듈을 포함한 재출시 Swagger 플랫폼에 이를 통합했습니다. 이 새 패키징은 SwaggerHub 대안을 검토해야 할 이유가 됩니다. Swagger 가격 페이지에 따르면 개인 플랜은 사용자당 월 $22.80부터, 팀 플랜은 $34.44, 엔터프라이즈 플랜은 $58.80입니다. 테스트 실행은 월 50~100회로 제한되며, 사용자 정의 티어로 올라가지 않는 한 이 제한이 적용됩니다. SSO는 사용자당 월 $6의 추가 기능이고, API 포털은 Enterprise Plus 미만의 모든 플랜에서 SmartBear 브랜딩을 표시합니다.
직접적인 대안을 찾는다면, Apidog는 별도 측정이나 추가 기능 계산 없이 스펙 우선 개발을 운영하려는 팀을 위한 SwaggerHub 대안입니다. 시각적 OpenAPI 디자이너, 무제한 테스트 실행, 스키마 인식 모킹, 자체 도메인 문서 호스팅을 제공하며, 4명까지 무료이고 이후에는 사용자당 월 $9입니다. 이 글에서는 Swagger의 새 패키징 비용, Apidog의 구현 방식, 그리고 SwaggerHub가 여전히 적합한 경우를 정리합니다.
새로운 Swagger 패키징의 실제 비용
재출시된 플랫폼은 Studio, Portal, Contract Testing, Functional Testing의 네 가지 모듈을 모든 플랜에 번들로 제공합니다. 하지만 실제 비용은 다음 제한 사항에서 결정됩니다.
- 좌석당 가격이 빠르게 누적됩니다. 팀 플랜은 사용자당 월 $34.44로 Apidog의 $9보다 약 4배 높습니다. 10명 팀은 추가 기능 없이도 연간 약 $4,133를 지불합니다. SmartBear 비용 구조는 SmartBear 가격 책정 및 최고의 대안에서 더 자세히 확인할 수 있습니다.
- 테스트 실행 횟수가 측정됩니다. 개인 및 팀 플랜에는 월 50회, 엔터프라이즈에는 월 100회가 포함됩니다. 모든 병합마다 테스트 스위트를 실행하는 CI 파이프라인이라면 며칠 안에 50회를 소진할 수 있습니다. 병렬 테스트 실행은 Enterprise Plus에서만 지원됩니다.
- 포털에 SmartBear 로고가 표시됩니다. 플랜에 따라 1~5개의 제품을 게시할 수 있지만, 모두 SmartBear 브랜딩이 포함됩니다. 사용자 정의 도메인과 완전한 화이트 라벨링은 영업 문의 기반의 Enterprise Plus에서만 사용할 수 있습니다.
- ID 기능은 추가 비용입니다. 엔터프라이즈 SSO는 팀 또는 엔터프라이즈 플랜 위에 사용자당 월 $6가 추가됩니다. Portal Pro($29.40), Contract Testing Pro($23), Test Pro($30)도 사용자당 월별 추가 기능입니다. 따라서 모든 기능을 사용하는 팀의 실제 좌석당 비용은 기본 가격보다 훨씬 높아질 수 있습니다.
- API 개수가 제한됩니다. 개인 플랜은 API 10개, 팀 플랜은 API 50개로 제한됩니다. 중간 규모 플랫폼 팀은 예상보다 빨리 50개 스펙에 도달할 수 있습니다.
이는 SwaggerHub의 설계 기능이 부족하다는 의미는 아닙니다. SwaggerHub의 에디터와 거버넌스 기능은 여전히 강력합니다. 다만 게시, 테스트, 로그인처럼 스펙 주변에서 필요한 기능에 별도 비용이 붙는 가격 모델이라는 점을 고려해야 합니다.
해답: Apidog
Apidog는 500,000명 이상의 개발자가 사용하는 API 개발 플랫폼입니다. SwaggerHub와 마찬가지로 스펙 우선으로 설계되었지만, API 라이프사이클의 나머지 작업을 별도 사용량으로 측정하지 않는 방식에 초점을 둡니다.
비교할 때 확인할 핵심 차이점은 네 가지입니다.
- SwaggerHub에서 측정하는 축을 제한 없이 사용할 수 있습니다. 무료 플랜을 포함한 모든 플랜에서 무제한 API, 무제한 테스트 실행, 무제한 예약 실행을 제공합니다. CI에서 실행 카운터를 확인하지 않고 모든 커밋에 테스트를 연결할 수 있습니다.
- 스펙이 게시용 산출물뿐 아니라 실제 개발 작업을 구동합니다. 하나의 OpenAPI 정의로 대화형 문서, 스키마 인식 모의 서버, 실행 가능한 테스트 시나리오를 생성합니다. 설계를 변경하면 문서, 모킹, 테스트에 반영됩니다.
- 문서를 자체 도메인에서 제공합니다. 사용자 정의 도메인, 사용자 정의 레이아웃, Markdown 페이지를 표준 게시 기능으로 사용할 수 있으며 공급업체 로고 표시 요구 사항이 없습니다.
- 가격 계산이 단순합니다. 4명까지 무료이며, 이후 사용자당 월 $9입니다. SSO, SCIM, RBAC는 추가 기능 묶음이 아니라 엔터프라이즈 플랜에 포함됩니다.
좌석 비용 계산
팀 플랜 요율에서는 인원이 늘어날수록 차이가 커집니다. 아래는 Swagger Team 플랜의 사용자당 월 $34.44와, 4명까지 무료 및 이후 사용자당 월 $9인 Apidog를 연간 기준으로 비교한 예시입니다.
| 팀 규모 | Swagger Team 연간 비용 | Apidog 연간 비용 | 차이 |
|---|---|---|---|
| 4명 | $1,653 | $0 (무료 플랜) | $1,653 |
| 10명 | $4,133 | $1,080 | $3,053 |
| 20명 | $8,266 | $2,160 | $6,106 |
엔터프라이즈 SSO를 사용자당 월 $6로 추가하면 20명 팀의 Swagger 청구서는 로그인 기능만으로 연간 $1,440가 더 증가합니다. 이 비교는 Swagger의 50개 API 제한과 월 50회 실행 제한 때문에 상위 플랜으로 업그레이드하지 않는다고 가정한 것이므로, Swagger 측에 유리한 조건입니다.
Swagger 모듈별 기능 비교
Studio → 시각적 + 코드 스펙 편집
Apidog는 OpenAPI용 시각적 디자이너와 코드 에디터를 모두 제공하며, 스펙 변경을 제안하고 검토할 수 있는 브랜치 기능도 지원합니다. 재사용 가능한 스키마 컴포넌트로 일반적인 도메인 모델링 작업을 처리할 수 있습니다.
다만 조직 전체에 스타일 가이드를 강제하는 사용자 정의 린팅 규칙은 제공하지 않습니다. 수백 개의 스펙에 Spectral 기반 거버넌스를 적용해야 한다면, 이 영역은 SwaggerHub의 실질적인 강점입니다.
Portal → 호스팅된 문서
Apidog에서는 실제 환경 또는 내장 모의 서버에 연결되는 try-it 콘솔이 포함된 대화형 문서를 게시할 수 있습니다. 버전 관리, 사용자 정의 도메인, 자체 브랜딩도 지원합니다.
SwaggerHub 포털의 제품 수 제한과 브랜딩 규칙은 게시 기능이 별도 상향 판매 항목이 되기 때문에 발생합니다. Apidog에서는 문서 게시를 기본 개발 흐름에 포함할 수 있습니다.
Functional Testing → 무제한 시나리오
가장 명확한 차이점입니다. SwaggerHub의 포함된 테스팅은 월별 실행 횟수를 측정합니다. Apidog에서는 연결된 단계, 데이터 추출, 어설션, CSV/JSON 기반 데이터 주도 실행을 포함하는 시각적 테스트 시나리오를 제한 없이 실행할 수 있습니다.
CI에서는 Apidog CLI를 사용해 시나리오를 실행합니다.
npm install -g apidog-cli
apidog run scenario --scenario-id 12345 --env staging
실행마다 HTML 보고서가 생성되므로, 팀 간에 테스트 실행 예산을 할당할 필요가 없습니다.
Automocking → 스마트 모의
SwaggerHub의 자동 모의는 예제 기반 응답을 반환하며 개인 플랜에서는 제공되지 않습니다. Apidog의 스마트 모의 엔진은 스키마에서 필드 이름과 타입을 읽어 현실적인 데이터를 생성합니다.
예를 들어 다음과 같은 필드는 별도 규칙 없이도 적절한 형식의 데이터를 생성할 수 있습니다.
type: object
properties:
email:
type: string
format: email
avatar_url:
type: string
format: uri
고정된 응답이 필요한 경우에는 사용자 정의 기대값을 설정할 수 있으며, 내부 네트워크용 자체 호스팅 옵션도 제공합니다. 더 넓은 모킹 도구 비교는 최고의 Swagger 대안에서 확인할 수 있습니다.
모듈을 넘어서
Apidog는 개발자가 일상적으로 사용하는 요청 클라이언트이기도 합니다. 따라서 스펙은 분기별 검토 대상에만 머무르지 않고, API 요청을 보내고 디버깅하는 작업과 직접 연결됩니다.
또한 스펙을 MCP 서버를 통해 게시하여 AI 코딩 에이전트가 직접 사용할 수 있습니다. 구현 방식은 Apidog MCP Server란 무엇인가에서 확인할 수 있습니다.
SwaggerHub(Swagger) vs Apidog 한눈에 보기
| 항목 | Swagger / SwaggerHub | Apidog |
|---|---|---|
| 진입 가격 | 사용자당 월 $22.80 (개인) | 4명까지 무료 |
| 팀 가격 | 사용자당 월 $34.44 + 추가 기능 | 사용자당 월 $9 |
| API | 10개 (개인) / 50개 (팀) | 무제한 |
| 테스트 실행 | 월 50~100회, Enterprise Plus에서만 무제한 | 모든 플랜에서 무제한 |
| 병렬 테스팅 | Enterprise Plus에서만 | 포함 |
| 모의 | 자동 모의, 개인 플랜 제외 | 스키마 인식 스마트 모의, 자체 호스팅 가능 |
| 포털 브랜딩 | Enterprise Plus 미만은 SmartBear 브랜딩 | 자체 도메인, 자체 브랜딩 |
| SSO | 사용자당 월 $6 추가 기능 | 엔터프라이즈 플랜 포함 |
| 스펙 거버넌스 / 사용자 정의 린팅 | 강력함, Spectral 기반 표준화 | 기본 검증, 조직 전체 규칙 집합 없음 |
| 계약 테스팅(Pact) | 예, 전용 모듈 | 아니요 |
| 게이트웨이 동기화(AWS, Azure, Apigee) | 예 | 네이티브 게이트웨이 푸시 없음 |
| 일상 디버깅용 요청 클라이언트 | 아니요 | 예 |
마지막 네 항목은 의도적인 차이입니다. 거버넌스와 통합은 대규모 플랫폼 팀이 SwaggerHub를 선택하는 이유가 될 수 있습니다. 반대로 가격과 사용량 측정은 많은 팀이 다른 도구를 검토하는 이유입니다.
SwaggerHub에서 마이그레이션
두 도구 모두 OpenAPI를 기본 지원하므로, 이 범주에서는 비교적 깔끔하게 마이그레이션할 수 있습니다.
- SwaggerHub에서 스펙을 내보냅니다. YAML 또는 JSON으로 내보낸 뒤 Apidog로 가져옵니다. 엔드포인트, 스키마, 예제는 구조화된 상태로 이동합니다. 내보내기 전에 공유 도메인 참조를 컴포넌트 스키마로 해석해야 합니다.
- 브랜치로 검토 흐름을 재현합니다. 스펙 변경을 브랜치에서 검토하고 병합합니다. 병합된 변경 사항은 문서, 모의, 테스트에 반영됩니다.
- 새 문서 URL로 소비자를 전환합니다. 사용자 정의 도메인을 연결한 뒤, 기존 포털에서 새 문서 URL로 리디렉션을 설정합니다.
- 기존에 측정되던 기능을 활성화합니다. 배포마다 테스트 스위트를 실행하도록 예약하고, 프론트엔드 팀에 모의 URL을 제공합니다.
50개 스펙 작업 공간처럼 Swagger Team 플랜의 상한에 가까운 환경도 일반적으로 일주일 이내에 이동할 수 있습니다. 내보내기 과정은 현재 활성 상태인 스펙을 정리하는 감사 작업으로도 활용할 수 있습니다.
SwaggerHub가 여전히 합리적인 경우
다음 요구 사항이 핵심이라면 SwaggerHub가 더 적합할 수 있습니다.
- 조직 규모의 API 거버넌스가 필요한 경우: 사용자 정의 스타일 가이드, Spectral 규칙 집합, 수백 개 스펙과 수십 개 팀에 걸친 표준화 보고서가 필요하다면 SwaggerHub의 엔터프라이즈 기능이 강점입니다.
- Pact 기반 계약 테스팅이 핵심 워크플로우인 경우: 마이크로서비스 팀 간 Pact 계약 테스팅이 필수라면 SwaggerHub의 전용 계약 테스팅 모듈은 차별화 요소입니다.
- API 게이트웨이와 양방향 동기화가 필요한 경우: AWS API Gateway, Azure API Management, Apigee와 배포 프로세스 내에서 스펙을 동기화해야 한다면 SwaggerHub의 통합이 적합할 수 있습니다.
반대로 팀의 주된 작업이 API 설계, 테스트, 문서화, 모킹이라면 측정된 실행 횟수, 공급업체 브랜딩 포털, 추가 기능 구조가 일상 개발 비용을 높일 수 있습니다. 디자인 우선 도구를 비교한다면 Stoplight도 현재 SmartBear 산하이므로 Stoplight 비교도 함께 확인하는 것이 좋습니다.
자주 묻는 질문
SwaggerHub는 현재 얼마입니까?
재출시된 Swagger 플랫폼 기준으로 개인 플랜은 사용자당 월 $22.80부터 시작합니다. 팀 플랜은 $34.44, 엔터프라이즈 플랜은 $58.80이며 Enterprise Plus는 견적 기반입니다. 엔터프라이즈 SSO($6), Portal Pro($29.40), Contract Testing Pro($23), Test Pro($30)는 사용자당 월별 추가 기능입니다.
SwaggerHub가 측정되는 항목에서 Apidog는 정말 무제한입니까?
예. API, 요청, 테스트 실행, 예약 실행은 무료 티어를 포함한 모든 Apidog 플랜에서 무제한입니다. SwaggerHub는 Enterprise Plus 미만에서 월 50~100회의 테스트 실행을 측정하고, 하위 티어에서는 API를 10~50개로 제한합니다.
SwaggerHub 스펙을 Apidog로 가져올 수 있습니까?
예. OpenAPI YAML 또는 JSON으로 내보낸 뒤 직접 가져올 수 있습니다. 스키마, 엔드포인트, 예제, 설명은 구조를 유지한 채 전달됩니다. 공유 도메인은 내보내는 시점에 스펙으로 해석되어 있어야 합니다.
Apidog는 SwaggerHub처럼 스펙 우선 디자인을 지원합니까?
예. Apidog는 브랜치 기반 검토와 함께 OpenAPI 시각적 에디터 및 코드 에디터를 제공합니다. 스펙은 문서, 모의, 테스트를 자동으로 구동합니다. 다만 조직 전체의 사용자 정의 린팅 규칙 집합은 제공하지 않으며, 이 부분은 SwaggerHub의 거버넌스 강점으로 남아 있습니다.
SwaggerHub의 API 게이트웨이 통합은 어떻습니까?
Apidog는 AWS, Azure, Apigee 게이트웨이에 스펙을 네이티브 방식으로 푸시하지 않습니다. 게이트웨이 동기화가 필수라면 마이그레이션 전에 해당 워크플로우를 검토해야 합니다. OpenAPI 기반 내보내기와 가져오기는 양쪽에서 계속 사용할 수 있습니다.
스펙을 설계하고, 실행하세요
SwaggerHub에서 스펙 하나를 내보내 Apidog로 가져온 뒤, 어떤 결과물이 생성되는지 확인해 보세요. 자체 도메인 문서, 현실적인 데이터를 제공하는 모의 서버, 즉시 예약 가능한 테스트 시나리오를 하나의 스펙에서 구성할 수 있습니다.
Apidog를 다운로드하고 4명 팀 기준 무료 플랜에서 워크플로우를 검증해 보세요. 이후 비용은 사용자당 월 $9이며, SwaggerHub 팀 플랜의 사용자당 월 $34.44 및 추가 기능 비용과 비교할 수 있습니다.
Top comments (0)