1. Homepage
  2. Design Center
  3. API Designer

  4. API Designer の外部で作成された API 仕様のアップロード

API Designer の外部で作成された API 仕様のアップロード

API 仕様は、API Designer を経由しなければ Anypoint Exchange にパブリッシュすることはできません。API Designer の外部で作成した API 仕様をパブリッシュするには、API Designer で API 仕様プロジェクトを作成し、外部で作成してある仕様をインポートしてから Anypoint Exchange にパブリッシュします。

始める前に

Anypoint Platform で、自分のユーザー ID に Design Center 開発者権限を割り当てておく必要があります。

手順

  1. Anypoint Platform のホームページから Design Center を開きます。

  2. 作業できる API 仕様プロジェクトを作成します。

    1. Design Center の ​[Projects (プロジェクト)]​ ページで、​[Create (作成)]​ をクリックして ​[New API Specification (新しい API 仕様)]​ をクリックします。

    2. [New API Specification (新しい API 仕様)]​ ダイアログで、プロジェクトに名前を付けます。名前は後で必要に応じて変更できます。

    3. [I’m comfortable designing it on my own (自分でデザインします)]​ を選択します。

    4. [Specification Language (仕様言語)]​ 項目で、API 使用を記述する言語を選択します。

    5. [Create API (VPN を作成)]​ をクリックします。 + ​結果​: Design Center で API 仕様プロジェクトが作成されます。このプロジェクトには 2 つのファイルが含まれます。

      • プロジェクトと同じ名前のデフォルトの空白の仕様。

        後の手順でこのファイルを削除できます。現在、これはプロジェクトのルートファイルとして設定されています。ルートファイルとして設定されているファイルを削除することはできません。

      • Anypoint Exchange で必要とされるメタデータを含む ​exchange.json​ という名前のファイル。

        このファイルは参照のみです。

  3. API 仕様をインポートします。

    1. テキストエディターの右上隅にある歯車アイコンをクリックして ​[Import (インポート)]​ を選択します。

    2. [Import (インポート)]​ ダイアログで、​[File or Zip (ファイルまたは Zip)]​ を選択します。

    3. ファイルまたは ZIP ファイルを参照して選択します。 + ​結果:​ エディターの左側のペインにファイルのリストが表示されます。インポートした ZIP ファイルに、フォルダー構造内のファイルが含まれる場合、ペインにそのフォルダー構造が表されます。

  4. 仕様を右クリックし、​[Set as root file (ルートファイルとして設定)]​ を選択して、プロジェクトのルートファイルを設定します。

  5. API Designer がデフォルトで作成した空白の仕様を削除します。

次のステップ

API 仕様プロジェクトを Anypoint Exchange にパブリッシュします。​「API 仕様のパブリッシュ」​を参照してください。

関連情報

Anypoint Exchange