Fern

Fern은 API 정의에서 자동으로 SDK 및 API 문서를 생성하는 플랫폼입니다. OpenAPI, AsyncAPI 또는 gRPC 사양을 제공하면 Fern이 TypeScript, Python, Go, Java, Ruby, C#, PHP, Swift와 같은 언어로 바로 사용할 수 있는 클라이언트 라이브러리를 생성합니다.

이 플랫폼은 또한 전문적이고 브랜드 아이덴티티에 맞는 문서 웹사이트를 구축합니다. 이 사이트에는 대화형 API 참조, 코드 예제, 그리고 개발자가 문서를 벗어나지 않고도 API를 테스트할 수 있는 플레이그라운드가 포함되어 있습니다.

Fern은 오픈 소스이며 GitHub에서 사용할 수 있습니다. npm 및 PyPI와 같은 패키지 레지스트리에 SDK를 직접 게시하여 기존 워크플로우와 통합됩니다. 이 도구는 수동 SDK 유지 관리를 위한 엔지니어링 리소스 투입 없이도 우수한 개발자 경험을 제공하려는 기업을 위해 설계되었습니다.

Fern을 시작하는 것은 간단합니다. 사용 방법은 다음과 같습니다:

• 터미널에서 설치 명령어를 실행하여 npm을 사용해 Fern CLI를 설치하세요. Node.js 버전 18 이상이 필요합니다.

• OpenAPI 명세와 함께 init 명령어를 실행하여 Fern 프로젝트를 초기화하세요. 로컬 파일을 사용하거나 API 명세의 URL을 제공할 수 있습니다.

• generators 파일에서 원하는 출력물을 구성하세요. 여러 언어로 SDK를 생성하거나 문서를 만들거나 둘 다 선택할 수 있습니다.

• generate 명령어를 실행하여 SDK와 문서를 생성하세요. Fern이 API 정의를 처리하고 요청한 산출물을 출력합니다.

• 마크다운 페이지를 추가하고, 색상과 글꼴을 조정하며, 맞춤 도메인을 설정하여 문서를 사용자화하세요.

• 자동 게시를 설정하여 API 변경 시 Fern이 SDK를 패키지 레지스트리에 푸시하고 문서 사이트를 업데이트할 수 있도록 하세요.

• 8개 이상의 프로그래밍 언어로 자동 SDK 생성

• Stripe 스타일의 API 문서 웹사이트

• 패키지 레지스트리로 직접 게시

• OpenAPI 및 AsyncAPI 지원

• 실시간 테스트가 가능한 인터랙티브 API 플레이그라운드

• 맞춤 브랜딩 및 도메인 지원

• 내장된 OAuth 2.0 및 인증

• 자동 페이지네이션 및 재시도 로직

• WebSocket 및 SSE 지원

• Git을 통한 버전 관리

• AI 기반 검색 도우미

• GitHub 오픈 소스