Flex Gateway新着情報
Governance新着情報
Monitoring API ManagerAPI Designer のビジュアル API エディターを使用して、RAML 1.0、OAS 2.0 または 3.0 (JSON) で API 仕様をスキャフォールディングできます。これを行うには、言語に依存しないフォームを入力します。
ビジュアル API エディターは 3 つのパネルに分かれています。
このパネルには、開発している API 仕様の名前が表示されます。また、提供されているコントロールを使用して、リソース、データ型、およびセキュリティスキームを作成することもできます。これらのコンポーネントは仕様の本文内にすべて含まれ、個別のファイルとして作成されません。
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 エディターで仕様をカスタマイズできます。