Flex Gateway新着情報
Governance新着情報
Monitoring API ManagerAPI Designer のビジュアル API エディターを使用して、RAML 1.0、OAS 2.0 または 3.0 (JSON) で API 仕様をスキャフォールディングできます。これを行うには、言語に依存しないフォームを入力します。
Anypoint Platform で、自分のユーザー ID に Design Center 開発者権限を割り当てておく必要があります。
ビジュアル API エディターは 3 つのパネルに分かれています。
このパネルには、開発している API 仕様の名前が表示されます。また、提供されているコントロールを使用して、リソース、データ型、およびセキュリティスキームを作成することもできます。これらのコンポーネントは仕様の本文内にすべて含まれ、個別のファイルとして作成されません。
このパネルには、仕様のコンポーネントのプロパティを指定するためのフォームがあります。エディターを初めて開くと、仕様の主要なプロパティを指定し、仕様をドキュメント化するためのフォームが表示されます。左側のパネルで項目の名前をクリックすると、そのフォームが中央のパネルで開きます。
このパネルには、RAML Viewer と OAS Viewer が表示されています。これらは共に参照のみです。パネルの下部にあるタブをクリックすると、これらが切り替わります。これらのビューアーには、仕様の現在のドラフトが RAML 1.0 または OAS 3.0 形式で表示されます。中央のパネルに表示されたフォームに値を入力すると、ドラフトがその値で更新されます。
また、このパネルでは、モッキングサービスを実行して、セットアップしたエンドポイントをテストすることもできます。
Design Center の [Projects (プロジェクト)] ページで、[Create new (新規作成)] をクリックします。
[New API Specification (新しい API 仕様)] を選択します。
[New API Specification (新しい API 仕様)] ダイアログで、プロジェクトに名前を付けます。
名前は後で必要に応じて変更できます。
[Guide me through it (手順に従って操作)] オプションを選択して、ビジュアル API エディターを使用します。
[Create API Spec (API 仕様を作成)] をクリックします。
結果: ビジュアル API エディターが開きます。
作業中は、モッキングサービスを実行して、API 仕様のコールをシミュレートできます。詳細については、このトピックの最後にある「関連情報」にある「API コールのシミュレーション」を参照してください。
仕様を直接編集またはカスタマイズする (RAML フラグメントをインポートするなど) 必要がある場合は、[Edit RAML (RAML を編集)] または [Edit OAS (OAS を編集)] をクリックすると、いつでも API エディターに切り替えることができます。ただし、一度切り替えた後は、ビジュアル API エディターに戻って API 仕様の作成を継続することはできません。
API 仕様が完成したら、RAML 1.0 形式で Exchange にパブリッシュすることができます。「API 仕様のパブリッシュ」を参照してください。
また、[Edit RAML (RAML を編集)] または [Edit OAS (OAS を編集)] をクリックして、API エディターで仕様をカスタマイズできます。