최고의 에피어리 대안

Apiary 서비스가 종료됩니다. Oracle은 Apiary 지원 종료 발표를 게시했으며, API 툴링 업계 전반의 보고에 따르면 호스팅 서비스는 2026년 9월경 최종 종료될 예정입니다. 사이트는 현재도 접속되지만, 이러한 방향은 수년 전부터 감지되었습니다. Oracle은 2017년 1월 Apiary를 인수했고, 2018년 유료 플랜을 중단했으며, 주변 오픈소스 도구인 Dredd와 Gavel은 아카이브 상태입니다. API 문서가 apiary.io에 있다면 대안을 평가하는 데만 시간을 쓰지 말고 지금 마이그레이션을 시작해야 합니다. 마감일은 바꿀 수 없습니다.

지금 Apidog 사용해 보기

직접적인 답부터 말하면, Apidog는 Apiary 대안으로 고려할 수 있는 플랫폼입니다. Apiary의 설계 우선 사양 편집, 호스팅된 대화형 문서, 모의 서버를 대체하면서 자동화된 API 테스트, 사양 기반 유효성 검사, CI 통합을 제공합니다. 최대 4인까지 무료로 사용할 수 있고, 유료 플랜은 사용자당 월 $9부터 시작합니다.

한 가지 확인할 점도 있습니다. Apidog는 API Blueprint 파일을 직접 가져오지 않으므로, Blueprint 기반 프로젝트는 먼저 OpenAPI로 한 번 변환해야 합니다. 이 글에서는 종료 전에 내보낼 항목, Blueprint 변환 절차, Apidog로 가져온 뒤 검증하는 방법을 단계별로 다룹니다.

Apiary에 실제로 무슨 일이 일어나고 있는가

2011년에 설립된 Apiary는 사실상 설계 우선(design-first) API 워크플로우를 제품으로 구현한 선구자였습니다. OpenAPI가 대세가 되기 전, 마크다운 기반 API 설명 형식인 API Blueprint를 만들었고, 3열 문서 레이아웃, 호스팅된 모의 서버, GitHub 동기화, 계약 테스트 도구인 Dredd와 Gavel을 제공했습니다.

하지만 2017년 1월 Oracle 인수 이후 제품 개발은 장기간 정체되었습니다. 2018년 유료 등급이 중단되면서 Apiary는 무료 레거시 서비스로 남았고, Oracle은 기업 고객을 자체 API Platform Cloud로 안내했습니다. 이후 새로운 기능 개발은 중단됐고 Dredd와 Gavel은 아카이브되었습니다.

이제 공식적인 종료가 다가오고 있습니다. Oracle의 지원 종료 발표와 함께 호스팅 서비스는 2026년 9월경 종료될 예정입니다. 마이그레이션 가이드를 제공하는 Bump.sh는 작별 게시물에서 서비스 종료 전에 API 설명을 내보내야 하며, 이후에는 내보낼 데이터가 없다고 명확히 안내합니다.

실무적으로는 다음 두 가지를 처리해야 합니다.

1. Apiary에만 있는 데이터를 즉시 내보냅니다. API 설명, 문서 본문, 팀 구성, 모의 URL 의존성을 확인합니다.
2. API Blueprint를 OpenAPI로 전환합니다. Blueprint 생태계의 후속 도구는 유지보수되지 않고 있으므로, 목적지 플랫폼과 무관하게 OpenAPI가 현실적인 표준 형식입니다.

무엇을 대체해야 하는가

마이그레이션 전에 Apiary가 팀에서 담당하던 기능을 목록화하세요. 새 도구가 아래 기능을 모두 대체하는지 검증해야 합니다.

• 설계 우선 사양 편집기
  
  브라우저에서 API Blueprint 또는 OpenAPI 3.0을 작성하고 문서를 실시간으로 갱신했습니다.

• 호스팅된 대화형 문서
  
  apiary.io URL에서 예시 요청을 포함한 API 레퍼런스 문서를 제공했습니다.

• 모의 서버
  
  사양의 예시 응답을 기반으로, 백엔드 구현 전에 소비자가 통합할 수 있는 호스팅된 모의 엔드포인트를 제공했습니다.

• GitHub 동기화
  
  사양 파일을 저장소와 동기화했습니다.

• Dredd 기반 계약 테스트
  
  실제 구현에 사양을 재생하고 불일치를 보고했습니다. Dredd는 현재 아카이브 상태이며, Dredd 없이 API를 사양에 맞춰 검증하는 방법에서 대체 접근 방식을 확인할 수 있습니다.

즉, 단순 문서 렌더러가 아니라 설계, 문서, 모의, 검증을 함께 제공하는 플랫폼이 필요합니다.

해답: Apidog

Apidog는 50만 명 이상의 개발자가 사용하는 API 개발 플랫폼입니다. 하나의 사양을 기준으로 설계, 문서화, 모의, 디버깅, 자동화된 테스트를 관리합니다.

Apiary에서 이전할 때 확인할 기능은 다음과 같습니다.

1. OpenAPI 기반 설계 우선 워크플로우
   
   Apidog는 OpenAPI 3.x용 시각적 편집기와 코드 편집기를 제공합니다. 엔드포인트, 스키마, 예시를 한 번 정의하면 문서, 모의 서버, 테스트가 동일한 정의를 사용합니다.

2. 호스팅된 대화형 문서
   
   게시된 문서는 사용자 지정 도메인과 버전 관리, “시도해 보기” 콘솔을 지원합니다. 더 이상 apiary.io URL에 의존할 필요가 없습니다.

3. 스키마 기반 스마트 모의 서버
   
   Apiary의 모의 서버가 작성된 예시를 재생했다면, Apidog의 스마트 모의 서버는 사양의 스키마를 기반으로 응답을 생성합니다. 필요한 경우 특정 응답을 위한 사용자 지정 모의 규칙도 추가할 수 있습니다.

4. Dredd 대체를 위한 계약 유효성 검사
   
   Apidog 테스트 시나리오는 실제 구현에 요청을 보내고 응답을 사양 스키마와 비교합니다. 어설션, 데이터 기반 테스트, Apidog CLI를 통한 CI 실행도 지원합니다.

문서는 MCP 서버와 함께 게시할 수 있으므로 AI 에이전트가 사양을 직접 읽도록 구성할 수도 있습니다. 자세한 내용은 Apidog MCP 서버란 무엇인가를 참고하세요.

Apiary에서 단계별 마이그레이션

Apiary 마이그레이션은 일반적인 도구 전환보다 한 단계가 더 필요합니다. API Blueprint를 사용한 프로젝트는 먼저 OpenAPI로 변환해야 합니다.

Apidog 가져오기 문서에 따르면 Apidog는 다음 형식을 가져올 수 있습니다.

• Swagger 2.0
• OpenAPI 3.0 및 3.1
• Postman 컬렉션
• HAR
• RAML
• JMeter
• apiDoc
• I/O Docs
• WADL
• Google Discovery

API Blueprint는 이 목록에 없으므로 아래 절차를 따르세요.

1. Apiary에서 모든 데이터를 내보내기

각 Apiary 프로젝트에서 다음 항목을 확보합니다.

• API 설명 파일
• 문서에 직접 작성한 본문
• 예시 요청 및 응답
• 현재 모의 서버 URL
• GitHub 동기화 저장소와 브랜치
• 팀 구성 및 권한 정보

프로젝트가 GitHub와 동기화되어 있다면 원본 사양은 저장소에 있을 수 있습니다. 단, Apiary 편집기 기준 최신 상태와 저장소의 파일이 일치하는지 먼저 확인하세요.

Apiary에서 OpenAPI 3.0으로 작성한 프로젝트라면 변환 단계 없이 바로 가져올 수 있습니다. 하지만 다른 작업보다 내보내기부터 먼저 완료하세요. 내보내기는 마감일이 있는 작업입니다.

2. API Blueprint를 OpenAPI로 변환

유지보수되는 변환기를 사용해 API Blueprint를 OpenAPI로 변환합니다.

• api-spec-converter — API Blueprint를 OpenAPI로 직접 변환할 수 있는 도구
• apib2swagger — Blueprint를 Swagger/OpenAPI로 변환하는 데 특화된 도구
• openapi-format — 변환 결과를 정규화하거나 OpenAPI 3.1로 정리할 때 사용할 수 있는 도구

변환 후에는 반드시 결과를 린트하고 수동 검토하세요. 특히 아래 두 항목은 누락되거나 불완전하게 변환될 수 있습니다.

1. 인증 스키마
   
   API Blueprint에서 공식적으로 모델링되지 않은 인증 정의는 변환기가 완전히 복구하지 못할 수 있습니다.

2. 마크다운 본문에 있던 설명
   
   엔드포인트 정의가 아닌 Blueprint의 일반 마크다운 섹션에 있던 설명은 OpenAPI 설명 필드로 자동 이전되지 않을 수 있습니다.

실무적으로는 API 하나당 약 1시간 정도를 잡고, 변환 결과를 검토하는 편이 안전합니다.

3. Apidog로 OpenAPI 가져오기

Apidog에서 다음 순서로 가져옵니다.

1. 프로젝트를 엽니다.
2. 프로젝트 설정에서 수동 가져오기(Manual Import) 를 선택합니다.
3. OpenAPI 파일을 업로드하거나 URL 가져오기를 선택합니다.
4. 가져온 엔드포인트, 스키마, 예시, 태그 그룹을 검토합니다.
5. 생성된 API 문서와 모의 엔드포인트를 확인합니다.

가져오기가 끝나면 참조 문서가 생성되고, 스마트 모의 서버가 가져온 엔드포인트에서 동작합니다. 이를 통해 Apiary의 소비자용 모의 URL 기능을 새 환경에서 복원할 수 있습니다.

4. Apiary에서 운영하던 워크플로우 재구축

가져오기는 시작일 뿐입니다. 실제 운영에 필요한 항목을 다시 연결하세요.

• 문서 도메인 연결
  
  게시된 문서에 사용자 지정 도메인을 연결합니다. 플랫폼 서비스 상태와 문서 URL을 분리할 수 있습니다.

• Dredd 검사 재구축
  
  기존 Dredd 검사를 Apidog 테스트 시나리오로 옮깁니다. 실제 요청, 응답 어설션, 스키마 유효성 검사를 구성합니다.

• CI 실행 추가
  
  테스트를 로컬과 CI에서 실행하도록 CLI 기반 워크플로우를 구성합니다.

• 소비자에게 새 모의 URL 공지
  
  기존 Apiary 모의 URL에 의존하는 팀이나 고객에게 새 기본 URL과 전환 일정을 전달합니다.

단일 API 프로젝트는 변환과 검증을 포함해 하루 안에 처리할 수 있습니다. 여러 Blueprint API를 운영한다면 인증 스키마와 문서 본문 검토에 가장 많은 시간이 소요될 수 있습니다.

Apiary vs Apidog 한눈에 비교

항목	Apiary (현재)	Apidog
미래	종료 예정; 지원 중단, 서비스 종료 2026년 9월경 예상	활발하게 개발 중
사양 형식	API Blueprint, 이후 OpenAPI 3.0	OpenAPI 3.x, Swagger 2.0 가져오기, 시각적 + 코드 편집기
호스팅 문서	예, apiary.io URL	예, 사용자 지정 도메인, 버전 관리, 시도해 보기 콘솔
모의 서버	작성된 예시 재생	스키마 인식 스마트 모의 + 사용자 지정 규칙
계약 테스트	Dredd, 현재 아카이브됨	내장 테스트 시나리오, 스키마 유효성 검사, CLI 기반 CI
자동화된 테스트 스위트	아니요	예, 시각적 시나리오, 데이터 기반, 무제한 실행
GitHub 동기화	예	URL 또는 파일에서 사양 가져오기/동기화, 브랜치 기반 버전 관리
가격	무료, 유료 플랜은 2018년 중단	4인까지 무료, 이후 사용자당 월 $9
내보내기 경로	API Blueprint / OpenAPI 다운로드	OpenAPI, 마크다운, HTML 내보내기

무료 도구를 대체하는 데 드는 비용

Apiary의 가장 큰 장점 중 하나는 무료였다는 점입니다. 따라서 마이그레이션 전에는 기능뿐 아니라 팀 규모별 비용도 비교해야 합니다.

정가 기준으로 Apidog는 4인까지 무료이며 이후 사용자당 월 $9입니다. SwaggerHub Team은 사용자당 월 $34.44, ReadMe Pro는 연간 청구 시 월 $250입니다.

팀 규모	Apidog 연간	SwaggerHub Team 연간	ReadMe Pro 연간
3명	$0 (무료 플랜)	$1,240	$3,000
5명	$540	$2,066	$3,000
10명	$1,080	$4,133	$3,000
25명	$2,700	$10,332	$3,000

사양 하나를 무료로 렌더링할 장소만 필요하다면 문서 전용 도구의 무료 플랜도 선택지가 될 수 있습니다. 하지만 모의 서버, 계약 테스트, 협업 기능까지 필요하다면 전체 워크플로우 비용을 비교해야 합니다.

Apidog의 무료 플랜은 최대 4명에게 사양 편집, 게시된 대화형 문서, 스마트 모의 서버, API 테스트를 제공합니다. 많은 Apiary 사용자에게 실제 마이그레이션 비용은 도구 구독료보다 Blueprint 변환과 검증에 사용하는 시간일 수 있습니다.

Apidog가 적합하지 않다면

Apiary를 계속 사용하는 것은 선택지가 아니므로, 팀의 우선순위에 따라 목적지를 정해야 합니다.

• 문서 렌더링만 필요합니다.
  
  사양 생성과 테스트가 다른 시스템에서 이미 처리되고 있고, 호스팅 문서와 변경 로그만 필요하다면 Bump.sh 같은 문서 우선 제품이 적합할 수 있습니다. 이 경우에도 Blueprint는 OpenAPI로 변환해야 합니다.

• SmartBear 스택으로 표준화하고 있습니다.
  
  SwaggerHub는 Apiary의 호스팅 사양 레지스트리와 가장 가까운 철학을 공유합니다. 다만 사용자당 비용과 테스트 실행 단위를 검토해야 합니다. 최고의 SwaggerHub 대안도 참고할 수 있습니다.

• 대규모 플랫폼 팀의 설계 거버넌스가 중심입니다.
  
  Stoplight는 스타일 가이드와 거버넌스 도구를 제공합니다. 도입 전 최고의 Stoplight 대안과 비교해 보세요.

• API Blueprint를 계속 유지하고 싶습니다.
  
  현재 Blueprint 관련 툴링은 유지보수되지 않고 있으며, Apiary도 종료됩니다. 한 번 OpenAPI로 변환하고 표준 형식으로 운영하는 편이 장기적으로 안전합니다. API Blueprint 가이드는 역사적 참고 자료로 활용할 수 있습니다.

자주 묻는 질문

Apiary는 정확히 언제 종료됩니까?

Oracle은 포럼에서 Apiary 지원 종료를 발표했습니다. 현재 API 툴링 공급업체들의 보고에 따르면 호스팅 서비스는 2026년 9월경 종료될 예정입니다. 가장 안전한 대응은 지금 모든 데이터를 내보내는 것입니다.

Apidog는 API Blueprint 파일을 직접 가져올 수 있습니까?

아니요. Apidog는 OpenAPI/Swagger, Postman, HAR, RAML, JMeter, apiDoc, I/O Docs, WADL, Google Discovery 형식을 가져옵니다.

API Blueprint 프로젝트는 먼저 api-spec-converter 또는 apib2swagger 같은 도구로 OpenAPI로 변환한 뒤 가져와야 합니다. 변환 후에는 인증 스키마를 수동으로 확인하세요.

Apiary 모의 서버는 무엇으로 대체됩니까?

Apidog의 내장 스마트 모의 서버를 사용할 수 있습니다. Apiary가 작성한 예시를 재생했다면, Apidog는 스키마에서 응답을 자동으로 생성하고 특정 케이스에는 사용자 지정 모의 규칙을 적용할 수 있습니다.

계약 테스트를 위한 Dredd는 무엇으로 대체됩니까?

Apidog의 자동화된 테스트 시나리오를 사용할 수 있습니다. 실제 구현에 요청을 보내고, 사양의 스키마에 대해 응답을 검증하며, 어설션과 CLI 기반 CI 실행을 지원합니다.

Apidog는 소규모 팀에게 실제로 무료입니까?

예. 무료 플랜은 최대 4명의 사용자를 지원하며, 사양 편집기, 게시된 대화형 문서, 스마트 모의 서버, API 테스트를 포함합니다. 4명 이상부터는 사용자당 월 $9입니다.

오늘 내보내고, 나중에 플랫폼을 선택하십시오

작업 순서는 중요합니다.

1. Apiary에서 먼저 모든 데이터를 내보냅니다.
2. API Blueprint를 OpenAPI로 변환합니다.
3. 변환 결과의 인증, 설명, 예시를 검토합니다.
4. 그다음 목적지 플랫폼으로 가져옵니다.
5. 문서, 모의 서버, 테스트, CI를 재구축합니다.

첫 두 단계에는 마감일이 있지만, 목적지 플랫폼을 평가하는 단계에는 상대적으로 시간이 있습니다. 준비가 되면 OpenAPI 파일을 Apidog로 가져오세요. 문서, 모의 서버, 테스트 워크플로우를 한 프로젝트에서 다시 구성할 수 있습니다.

Apidog 다운로드 후 시작하거나 브라우저에서 작업을 시작할 수 있습니다.