Gateway Node.js とライブラリを使用して API を作成し Express、 Swagger API ドキュメントを統合するには、次の手順を実行します。
ステップ 1: プロジェクトをセットアップしてライブラリをインストールする
- プロジェクト用に新しいディレクトリを作成します。
- Command Prompt またはを 開き Terminal 、プロジェクト ディレクトリに移動します
cd path_to_directory
。 - npm パッケージを初期化します
npm init -y
。 - 必要なライブラリをインストールします: 。
npm install express ocelot swagger-ui-express
ステップ 2: 構成 Express と Ocelot
app.js
プロジェクト ディレクトリに という名前のファイルを作成し、それを開いて設定します Express。
ocelot-config.json
リクエストのルーティングを定義するために 次の名前の構成ファイルを作成します。
ステップ 3: 統合する Swagger
ファイルに app.js
次のコードを追加して統合します Swagger。
swagger.json
プロジェクト ディレクトリに 次の名前のファイルを作成し、API ドキュメント情報を定義します。
ステップ 4: プロジェクトを実行する
Command Prompt または を 開き Terminal 、プロジェクト ディレクトリに移動します。
次のコマンドを使用してプロジェクトを実行します node app.js
。
ステップ 5: Swagger UIにアクセスする
Swagger 次のアドレスで UI にアクセスします http://localhost:3000/api-docs
。
これは、API をデプロイし Gateway、 Swagger Node.js を使用して統合する方法の簡単な例であることに注意してください。 実際には、セキュリティ、バージョン管理、カスタム構成、その他の考慮事項などの側面を考慮する必要があります。