Scalar

Scalar는 API를 문서화, 테스트 및 검색하기 위해 설계된 현대적인 오픈소스 개발자 경험 플랫폼입니다. 표준 OpenAPI/Swagger 파일을 세계적 수준의 상호작용적인 API 문서로 변환하는 포괄적인 도구 모음을 제공합니다. 이 플랫폼은 강력함, 유연성 및 개발자 중심 접근 방식으로 스타트업부터 포춘 500대 기업에 이르기까지 다양한 사용자들에게 신뢰를 받고 있습니다.

Scalar의 핵심은 아름답고 기능성이 뛰어난 API 참조 문서를 생성하는 것입니다. 이 문서들은 정적이지 않으며, 개발자와 사용자가 브라우저 내에서 직접 API 엔드포인트를 테스트할 수 있는 상호작용적인 플레이그라운드를 포함합니다. 이러한 문서화와 테스트의 원활한 통합은 온보딩 시간을 크게 줄이고 개발 워크플로우를 단순화합니다. 또한 이 플랫폼은 강력한 Swagger 편집기를 포함하여 사용자가 OpenAPI 사양을 쉽게 미리 보고, 편집하고, 관리할 수 있도록 합니다.

Scalar 사용 방법

Scalar를 시작하는 것은 간단합니다. 개발자는 기존 OpenAPI/Swagger 파일(버전 3.1, 3.0, 2.0 지원)을 가져오거나 통합된 Swagger 편집기를 사용하여 처음부터 새로 만들 수 있습니다. 사양이 로드되면 Scalar는 자동으로 상호작용적인 문서를 생성합니다.

프로젝트에 통합하기 위해 Scalar는 .NET, Fastify, Next.js, Laravel, Express 등과 같은 수많은 프레임워크를 위한 패키지를 제공합니다. dotnet add package Scalar.AspNetCore와 같은 간단한 명령만으로도 충분한 경우가 많습니다. 그런 다음 개발자는 애플리케이션에 몇 줄의 코드를 추가하여 Scalar API 참조 문서를 제공할 수 있습니다. 이 플랫폼은 또한 웹, macOS, Linux 및 Windows에서 사용할 수 있는 독립적인 오프라인 우선 API 클라이언트를 제공하며, 견고한 API 테스트를 위해 독립적으로 또는 문서와 함께 사용할 수 있습니다.

Scalar의 핵심 기능

• 상호작용적인 API 문서: 내장된 테스트 플레이그라운드를 통해 OpenAPI/Swagger 파일에서 아름답고 사용자 친화적인 API 문서를 자동으로 생성합니다.
• 통합 API 클라이언트: 포괄적인 API 테스트 및 디버깅을 위해 모든 주요 데스크톱 플랫폼에서 사용할 수 있는 강력한 오프라인 우선 REST API 클라이언트입니다.
• Swagger 편집기: 플랫폼 내에서 직접 Swagger/OAS 파일을 미리 보고, 편집하고, 관리할 수 있는 무료 오픈소스 도구입니다.
• 광범위한 사용자 정의: 무료 플랜에서도 사용자 정의 테마, 색상, 타이포그래피 및 사용자 정의 CSS/JavaScript를 추가할 수 있는 완전한 브랜딩 기능을 제공합니다.
• 프레임워크 통합: .NET, Nitro, FastAPI, Hono, NestJS 등을 포함한 다양한 인기 백엔드 프레임워크를 위한 사용하기 쉬운 패키지를 제공합니다.
• Git + Markdown 동기화: 문서가 코드와 함께 존재하도록 허용하며, Markdown으로 작성되고 OpenAPI 파일에 연결된 문서를 지원합니다.
• 오픈소스 코어: 커뮤니티에 의해, 커뮤니티를 위해 만들어져 투명성, 지속적인 개선 및 벤더 종속성 없음을 보장합니다.
• 코드 샘플 생성: 사용자가 API를 사용하는 데 도움이 되도록 다양한 인기 프로그래밍 언어로 코드 샘플을 자동으로 생성합니다.

Scalar의 사용 사례

Scalar는 API를 구축, 유지 관리 또는 사용하는 모든 개인이나 팀에게 이상적입니다. 주요 사용 사례는 공개 또는 내부 API에 대해 탁월한 개발자 경험을 제공하려는 기업입니다. 예를 들어, Supabase, Maersk, Tailscale과 같은 회사는 API 문서를 강화하기 위해 Scalar를 사용합니다. 또한 작업 중인 API를 빠르고 쉽게 시각화하고 테스트해야 하는 개인 개발자에게도 완벽합니다. 팀은 프로 플랜의 협업 기능을 사용하여 API 테스트 작업 공간을 동기화하고 개발 라이프사이클 전반에 걸쳐 일관성을 보장할 수 있습니다.

Scalar의 장점

Scalar의 주요 장점은 문서화와 테스트를 단일의 응집력 있는 플랫폼으로 원활하게 통합한다는 점입니다. 이러한 기능을 분리하는 다른 도구와 달리, Scalar는 사용자가 엔드포인트에 대해 읽고 페이지를 떠나지 않고 즉시 테스트할 수 있도록 합니다. 오픈소스 특성과 OpenAPI 사양에 대한 약속은 벤더 종속성을 방지합니다. 높은 수준의 사용자 정의 기능은 기업이 브랜드 일관성을 유지할 수 있도록 합니다. 또한, 오프라인 우선 API 클라이언트는 지속적인 인터넷 연결 없이 작업해야 하는 개발자에게 상당한 이점입니다. 넉넉한 무료 플랜은 모든 사람이 접근할 수 있도록 하며, 저렴한 프로 플랜은 전문 팀을 위한 강력한 기능을 제공합니다.

가격 및 플랜

Scalar는 유연한 프리미엄(freemium) 가격 모델을 제공합니다:

• 무료 플랜: 사용자 1명, 무제한 작업 공간, 무료 하위 도메인(apidocumentation.com), API 참조, 테마 및 사용자 정의 CSS/JS를 사용한 전체 스타일링, 내장된 Scalar API 클라이언트를 포함합니다.
• 프로 플랜(좌석당 월 $12): 무료 플랜의 모든 기능에 더해 사용자 정의 도메인, GitHub와의 동기화, 가이드 및 버전 관리, 고급 검색(TypeSense 제공), 우선 지원이 포함됩니다.
• 엔터프라이즈 플랜(맞춤 가격): 모든 프로 기능에 더해 SSO/SAML, 월간 문서 감사, 검증된 작업 공간, 전용 Slack 지원 채널이 포함됩니다.