Exchange への API 仕様およびフラグメントのパブリッシュ

logo cloud IDE Cloud IDE

logo desktop IDE Desktop IDE

これは進行中のベータリリースです。ベータ状態での Anypoint Code Builder の使用には、該当するベータサービス契約条件が適用されます。

API 仕様またはフラグメントを Anypoint Exchange にパブリッシュして、他のチームメンバーがそれらを見つけて使用できるようにします。

始める前に

API 仕様またはフラグメントをパブリッシュする前に次の操作を実行します。

Exchange に API 仕様をパブリッシュする

Exchange に API 仕様をパブリッシュする手順は、次のとおりです。

Anypoint Code Builder で API 仕様を開きます。
コマンドパレットを開きます。
手順を表示
- キーボードショートカットを使用する。
  
  Mac: Cmd+Shift+p
  
  Windows: Ctrl+Shift+p
- デスクトップ IDE で、[View (表示)] > [Command Palette (コマンドパレット)] を選択する。
- クラウド IDE で、 (メニュー) アイコンをクリックし、[View (表示)] > [Command Palette (コマンドパレット)] を選択する。
「publish」と入力し、次のコマンドを選択します。
```
MuleSoft: Publish API Specification to Exchange
```
プロンプトが表示されたら、[Allow (許可)] をクリックして、Anypoint Platform を使用したサインインを許可します。

コミットされていない変更がある場合は、Exchange にパブリッシュする前にその変更をプッシュします.
[Set Project Name (プロジェクト名を設定)] で、プロジェクト名を確認または入力して、Enter キーを押します。
各項目を確認または変更して、Enter キーを押します。
- Artifact ID (アーティファクト ID) (OAS-Example など)。
- Asset version (アセットバージョン) (1.0.0 など)。
- API version (API バージョン) (v1 など)。
パブリッシュをキャンセルするには、Escape キーを押します。

ステータスバーに進行状況が表示されます。完了したら、API 仕様が Exchange に正常にパブリッシュされたことを示すメッセージが表示されます。
API を実装するように促されたら、次のように選択します。
- インテグレーションに API 仕様をスキャフォールディングしないようにするには、[No (いいえ)] を選択します。
- インテグレーションに API 仕様をスキャフォールディングするには、[Yes (はい)] を選択します。
  
  スキャフォールディングが失敗する場合は、「実装エラー」を参照してください。

Exchange で API を見つける

API 仕様をパブリッシュしたら、Anypoint Exchange でその API 仕様を見つけることができます。

Anypoint Platform に移動し、ログイン情報を使用してログインします。
手順を表示
US クラウド (非 EU ホスト): Anypoint Platform (US)

EU クラウド (EU ホスト): Anypoint Platform (EU)
Anypoint Exchange に移動します。
手順を表示
US クラウド (非 EU ホスト): Exchange (US)

EU クラウド (EU ホスト): Exchange (EU)
API 仕様が組織のアセットとして表示されます。次に例を示します。

API を選択し、その概要に移動して、前のタスクで定義したすべてのエンドポイントを表示できます。

Exchange に GraphQL API 仕様をパブリッシュする

GraphQL API 仕様を Exchange にパブリッシュする手順は、次のとおりです。

Anypoint Platform に移動し、ログイン情報を使用してログインします。
手順を表示
US クラウド (非 EU ホスト): Anypoint Platform (US)

EU クラウド (EU ホスト): Anypoint Platform (EU)
Anypoint Exchange に移動します。
手順を表示
US クラウド (非 EU ホスト): Exchange (US)

EU クラウド (EU ホスト): Exchange (EU)
[Publish new asset (新規アセットをパブリッシュ)] をクリックします。
[Publish a new asset (新規アセットをパブリッシュ)] フォームに情報を入力します。
1. [Name (名前)] にアセットの名前を入力します。
2. [Asset types (アセットタイプ)] では、[GraphQL API] を選択します。
3. [Method (方法)] では、[Upload a GraphQL API Schema (GraphQL API スキーマをアップロード)] を選択します。
4. [File upload (ファイルアップロード)] では、[Choose file (ファイルを選択)] をクリックして目的の .graphql スキーマファイルを探します。
5. バージョン番号を変更するには、[Advanced (詳細)] をクリックします。
6. [Lifecycle state (ライフサイクル状態)] では、[Stable (安定)] を選択します。
[Publish (パブリッシュ)] をクリックします。