重要である理由
IAMの管理を手動で行うには手間ががかります。OpenAPI(Swagger)仕様を使用して、APIがすでにしっかりとドキュメント化されている場合はなおさらです。 Open API仕様から直接、Kongサービスやルートを自動生成できたらいいのにと思いませんか?
このObjectScriptメソッドはまさにその処理を行います。仕様クラスの XData ブロック内に保管されているOpenAPI 2.0仕様を読み取り、IAM構成を同期するために使用できるdecKと互換性があるYAMLファイルを生成します。
このアプローチは:
- 手動による構成エラーを削減します
- ゲートウェイをAPI仕様に常に同期します
- デプロイメントとオンボーディングを高速化します
前提条件:
- InterSystems IRIS、またはIRISベースのプラットフォーム
- InterSystems API Manager
- Deck CLIツール
メソッドの内容
メソッド ConvertOpenAPIXDataToDeckYAML の機能は次のとおりです。
-
OpenAPI仕様を読み取る: 指定したクラス内の
OpenAPIという名前のXDataブロックから読み取ります。 -
JSONを解析する:動的オブジェクトに変換します。
-
エンドポイントを抽出する :HTTPメソッドも抽出します。
.png)

.png)
.png)
.png)
.png)