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でのオープンソース