--- schema_version: "1" id: f1f1dababc42ce1a5a38a1dbad2a02df28c4bae18cc4ecbfcd7e31f81136f2ed title: Exchange API を使用したアセットのパブリッシュ collection: mulesoft version: current locale: ja-jp portal_url: https://docs.salesforce.com/mulesoft/current/ja-jp/exchange/exchange-api.md canonical_url: https://docs.mulesoft.com/jp/exchange/exchange-api source_site: docs.mulesoft.com content_type: documentation content_hash: d97a84570a9158fb66b11b3760d472f04dac129aea4cdf39a9bb996d389fb5bf description: MuleSoft Documentation Site latest: true --- # Exchange API を使用したアセットのパブリッシュ Exchange API を使用すると、アセットをパブリッシュおよびコンシュームしたり、ドキュメントページを追加したり、カテゴリを追加または編集したり、公開ポータルを管理したりできます。このページには、Exchange API の使用例がいくつか示されています。完全な API ドキュメントは [API ドキュメントポータル](https://anypoint.mulesoft.com/exchange/portals/anypoint-platform/f1e97bc6-315a-4490-82a7-23abe036327a.anypoint-platform/exchange-experience-api/)​にあります。 API では、すべての Exchange アセットタイプがサポートされています。 - REST API - SOAP API - HTTP API - AsyncAPI 仕様 - API フラグメント - コネクタ - Mule アプリケーション - 例 - テンプレート - ポリシー - カスタムアセット 新しいアセットは、組織の​[アセット制限](https://docs.mulesoft.com/jp/exchange/to-create-an-asset#asset-limits)​に含まれます。 ## [](#前提条件)前提条件 このドキュメントを活用するには、読者は Exchange、プログラミングの概念、およびコンピューターやサーバーでのコマンドライン操作に精通している必要があります。 アセットをパブリッシュするには、一意のアーティファクト ID と組織 ID が必要です。アーティファクト ID は、グループ ID、アセット ID、バージョンで構成されています。 ## [](#アセットを-exchange-にパブリッシュするために必要なタスク)アセットを Exchange にパブリッシュするために必要なタスク 次のタスクを実行して、アセットを Exchange にパブリッシュし、Exchange API を使用してメタデータを追加します。 1. [組織 ID を見つける](#find-your-organization-id) 2. [認証](#authentication) 1. [アクセストークンを取得する](#obtain-an-access-token) 2. [接続アプリケーション認証を使用する](#use-connected-application-authentication) 3. [アセットをパブリッシュする](#publish-an-asset) 1. [アセットプロパティを指定する](#specify-asset-properties) 2. [同期公開または非同期公開を指定する](#sync-and-async-publication) 3. [可変データの設定](#set-mutable-data) 4. [カテゴリと項目を JSON コレクションとして設定](#set-with-json) 5. [ライフサイクル状態を設定する](#set-lifecycle-state) 6. [アセットアイコンとして使用する画像のアップロード](#upload-asset-icons) 4. [アセットを説明する](#describe-your-assets) 1. [タグを追加する](#add-tags) 2. [カテゴリを追加する](#add-categories) 3. [カスタム項目を追加する](#add-custom-fields) 4. [ライフサイクル状態を昇格する](#promote-lifecycle-state) 5. [アセットメタデータの更新](#update-asset-metadata) 5. [ドキュメントページを追加および更新する](#add-update-doc-pages) 1. [ドラフトモードで新しいページを追加する](#add-new-page-draft) 2. [コンテンツをページに追加する](#add-content-to-page) 3. [ドラフトをパブリッシュする](#publish-draft) 6. [ランタイム情報をアセットに追加する](#add-runtime-info) ## [](#find-your-organization-id)組織 ID を見つける 組織 ID を見つける手順は、次のとおりです。 1. Anypoint Platform にログインし、​**\[Access Management (アクセス管理)\]**​ をクリックします。 2. 最上位組織またはビジネスグループの名前をクリックし、\[organization information (組織情報)\] 画面の組織 ID を参照します。 3. 組織 ID をコピーして、例を試すときに使用します。 ## [](#authentication)認証 Exchange API には、アクセストークンまたは接続アプリケーションによる認証が必要です。 ## [](#obtain-an-access-token)アクセストークンを取得する 1. Anypoint Platform にログインします。 2. cURL コマンドでアクセストークンを取得します。 Postman や別のアプリケーションを使用して HTTP コマンドを送信することもできます。 `ANYPOINT_USERNAME`​ を Anypoint Platform ユーザーアカウント名に置き換えて、​`ANYPOINT_PASSWORD`​ をそのパスワードに置き換えます。 ```console curl --location --request POST 'https://anypoint.mulesoft.com/accounts/login' \ --header 'Content-Type: application/json' \ --header 'Accept: application/json' \ --data-raw '{ "username":"ANYPOINT_USERNAME", "password":"ANYPOINT_PASSWORD" }' | jq -r ".access_token" ``` API コールでこのアクセストークンを使用します。 組織のシステム管理者は、アクセストークンの有効期限を 15 分～ 180 分の値に設定します。検索やより多くの時間を必要とする他の操作を実行する場合、追加のトークンを要求する必要があります。 ## [](#use-connected-application-authentication)接続アプリケーション認証を使用する 接続アプリケーション認証を使用する手順は、次のとおりです。 1. [接続アプリケーションを作成します](https://docs.mulesoft.com/jp/exchange/connected-app-authentication)​。 2. 基本認証を指定し、​`~~~Client~~~`​ としてユーザー名、​`clientID~?~clientSecret`​ としてパスワードを定義します。 1. `clientID`​ をクライアント ID に置き換えます。 2. `clientSecret`​ をクライアントシークレットに置き換えます。 ## [](#publish-an-asset)アセットをパブリッシュする Exchange API バージョン 2 では、マルチパートフォームデータを送信するか、データが含まれる POM ファイルを渡して、アセットを Exchange にパブリッシュできます。 API では、同期または非同期で Exchange にアセットアップロードすることもできます。 API では、サポートされているすべてのアセットタイプ (REST API、SOAP API、HTTP API、AsyncAPI 仕様、API フラグメント、コネクタ、Mule アプリケーション、サンプル、テンプレート、ポリシー、カスタムアセットなど) をアップロードできます。 次の例は、REST API (RAML 仕様) をパブリッシュする方法を示しています。 ### [](#specify-asset-properties)アセットプロパティを指定する アセットを作成する API コールごとに、マルチパートプロパティを指定します。
プロパティ 説明 必須または省略可能

name (名前)

Exchange ポータルページに表示されるアセット名。

必須

description (説明)

アセットの説明。

省略可能

type

作成するアセットタイプ。

ファイル拡張子からタイプを推定できない場合は必須

連動関係

dependencies=GROUP_ID:ASSET_ID:VERSION,GROUP_ID:ASSET_ID:VERSION​ のように定義されるカンマ区切りの連動関係の文字列。

省略可能

keywords (キーワード)

アセットの属性として保存されるカンマ区切り値の文字列 (​keywords=api,raml,auth,jwt,token​ など)。検索クエリでは、アセットをキーワードで検索できます。

省略可能

tags (タグ)

アセットのタグとして送信するカンマ区切り値の文字列 (​tags=tag1,tag2​ など)。タグ項目が要求内に存在しないか空の場合、アセットのタグは変更されません。この文字列は最終バージョンであるため、2 つのタグがあるアセットから 1 つのタグを削除するには、残しておくタグのみを送信します。

省略可能

fields (項目)

プロパティのキーと値が設定されたオブジェクトを項目とする JSON 配列で、カスタム項目を表す。カスタム項目は、組織で設定されている必要があります。カスタムアセットをアップロードする例として、カスタム項目が挙げられます。

省略可能

fields.key

アセットのカスタム項目として送信するカンマ区切り値の文字列。​key​ を、追加または置換するカスタム項目のキーに置き換えます。カスタム項目は、組織で設定されている必要があります。項目要素が要求内に存在しないか空の場合、アセットの項目は変更されません。この文字列は最終バージョンであるため、2 つのカスタム項目があるアセットから 1 つのカスタム項目を削除するには、残しておく項目のみを送信します。

省略可能

categories

プロパティのキーと値が設定されたオブジェクトを項目とする JSON 配列で、カスタム項目を表す。カスタム項目は、組織で設定されている必要があります。カスタムアセットをアップロードする例として、カスタム項目が挙げられます。

省略可能

categories.key

アセットのカテゴリとして送信するカンマ区切り値の文字列。​key​ を、追加または置換するカテゴリのキーに置き換えます。カテゴリは、組織で設定されている必要があります。カテゴリ項目が要求内に存在しないか空の場合、アセットのカテゴリは変更されません。この文字列は最終バージョンであるため、2 つのカテゴリがあるアセットから 1 つのカテゴリを削除するには、残しておくカテゴリのみを送信します。

省略可能

contactName

アセットについて連絡するユーザーの名前。

省略可能

contactEmail

アセットについて連絡するユーザーのメールアドレス。

省略可能

properties

一部のアセットタイプでは、​apiVersion​、​mainFile​、​assetLink​ などのプロパティプレフィックスで追加のプロパティを指定する必要があります (例: properties.apiVersion = v1​)。

一部のプロパティおよびアセットタイプでは必須
次の例では、マルチパートフォームデータを使用して、RAML API 仕様を Exchange にアップロードします。 この例で使用されているファイルは、Exchange API 開発者ポータルの [\[アセット作成](https://anypoint.mulesoft.com/exchange/portals/anypoint-platform/f1e97bc6-315a-4490-82a7-23abe036327a.anypoint-platform/exchange-experience-api/minor/2.0/pages/Asset%20Creation/)\]​ ページからダウンロードします。 `/file-path/training-american-flights-api-1.0.0-raml.zip`​ をローカルファイルパスに置き換えます。 ```console curl -v \ -H 'Authorization: bearer ANYPOINT_TOKEN' \ -H 'x-sync-publication: true' \ -F 'name=RAML asset name' \ -F 'description=Description of the asset' \ -F 'keywords=this, is, the, best, raml' \ -F 'dependencies=68ef9520-24e9-4cf2-b2f5-620025690913:training-american-flight-data-type:1.0.1,68ef9520-24e9-4cf2-b2f5-620025690913:training-american-flights-example:1.0.1' \ -F 'properties.mainFile=american-flights-api.raml' \ -F 'properties.apiVersion=v1' \ -F 'files.raml.zip=@/file-path/training-american-flights-api-1.0.0-raml.zip' \ https://anypoint.mulesoft.com/exchange/api/v2/organizations/:organizationId/assets/:groupId/:assetId/:version ``` ### [](#sync-and-async-publication)同期公開または非同期公開を指定する 同期メソッドを使用するには、ヘッダー ​`x-sync-publication:true`​ を追加します。 非同期メソッドを使用するには、ヘッダー ​`x-sync-publication:false`​ を追加するか、​`x-sync-publication`​ ヘッダーなしで要求を送信します。 アセットが非同期でパブリッシュされる場合、次のような応答が返されます。 ```console { "publicationStatusLink":"https://anypoint.mulesoft.com/exchange/api/v2/organizations/67ac7cde-c02c-457f-b826-da2474e63d5a/assets/67ac7cde-c02c-457f-b826-da2474e63d5a/wsdl-asset/1.0.0/publication/status/d47a22a5-90f6-49eb-bfd0-d9fff575e022" } ``` エンドポイント ​`publicationStatusLink`​ では、アセットのパブリッシュ状況が提供されます。 ### [](#set-mutable-data)可変データの設定 この例は、アセットを作成し、同じ要求内でアセットを説明する可変データを設定する方法を示しています。アセットの可変データには、カテゴリ、カスタム項目、タグ、ドキュメントページが含まれます。 アセットのパブリッシュエンドポイントで、新しいアセットが作成されます。アセットがすでに存在する場合、要求はエラー 409 (競合) で失敗します。既存のバージョンの可変データは変更しないでください。代わりに、更新された可変データを使用して新しいパッチバージョンを作成します。たとえば、現在のバージョンが 1.2.3 の場合、バージョン 1.2.4 を作成します。 この例では、キー ​`categoryKey`​ と ​`fieldKey`​ を使用するカテゴリとカスタム項目をパブリッシュします。組織にカテゴリまたはカスタム項目が設定されていない場合、パブリッシュは失敗します。 `files.docs.zip`​ として送信されるドキュメントアーカイブファイルで、アーカイブのルートディレクトリに ​`Getting Started.md`​ などの名前のマークダウンファイルとして各ドキュメントページを含めます。​`Getting Started`​ をページのタイトルに置き換えます。契約条件ページを含めるには、​`terms.md`​ というファイルにコンテンツを配置します。省略可能なサブディレクトリ ​`resources`​ に画像などのリソースを含めます。省略可能なファイル ​`config.json`​ のメインオブジェクトのルートにあるプロパティ ​`pageOrder`​ を使用して、ページの順序を指定します。 ```console { "pageOrder": ["home", "Getting Started", "Examples"] } ``` ```console curl --location --request POST 'https://anypoint.mulesoft.com/exchange/api/v2/organizations/:organizationId/assets/:groupId/:assetId/:version' \ --header 'Authorization: bearer YOUR_TOKEN' \ --header 'x-sync-publication: true' \ --form 'type="custom"' \ --form 'name="Comprehensive Test"' \ --form 'tags="1, 2, 3, 4"' \ --form 'categories.categoryKey="value1, value2"' \ --form 'fields.fieldKey="value1, value2"' \ --form 'contactName="Max Mule"' \ --form 'contactEmail="maxmule@example.com"' \ --form 'files.docs.zip=@"/file-path/docs.zip"' ``` ### [](#set-with-json)カテゴリと項目を JSON コレクションとして設定 マルチパートフォーム内で JSON 形式のカテゴリやカスタム項目を設定または変更するには、プロパティのキーと値を含むオブジェクトの配列を送信します。 組織にカテゴリやカスタム項目が設定されていない場合は要求が失敗します。 カテゴリやカスタム項目をすべて削除するには、空の配列を送信します。 ```none --form 'categories="[]"' --form 'fields="[]"' ``` マルチパートフォームでは JSON 形式のデータが優先されるため、この例では ​`categoryKey2`​ または ​`fieldKey2`​ が設定されません。 例: ```none curl --location --request POST 'https://anypoint.mulesoft.com/exchange/api/v2/organizations/:organizationId/assets/:groupId/:assetId/:version' \ --header 'Authorization: bearer YOUR_TOKEN' \ --header 'x-sync-publication: true' \ --form 'type="custom"' \ --form 'name="Comprehensive Test"' \ --form 'tags="1, 2, 3, 4"' \ --form 'categories="[{"key":"categoryKey", "value":"value1, value2"}]"' \ --form 'categories.categoryKey2="value3"' \ --form 'fields="[{"key":"fieldKey", "value":"value1, value2"}]"' \ --form 'fields.fieldKey2="value3"' \ --form 'files.docs.zip=@"/file-path/docs.zip"' ``` ### [](#set-lifecycle-state)ライフサイクル状態を設定する 新しいアセットバージョンは、​`development`​ 状態またはデフォルトの ​`stable`​ 状態 (​`published`​ とも呼ばれる) のいずれかになります。非推奨にする前のアセットバージョンは stable である必要があります。 Exchange API バージョン 2 を使用してアセットを作成し、そのライフサイクル状態を設定するには、プロパティ ​`status`​ をマルチパート要求に追加します。状態が指定されていない場合、アセットはデフォルトの ​`stable`​ 状態で作成されます。 次の REST API アセットの例は、アセットの作成方法とそのライフサイクル状態の設定方法を示しています。 1. Anypoint Platform にログインし、 [サンプルファイル](https://anypoint.mulesoft.com/exchange/organizations/68ef9520-24e9-4cf2-b2f5-620025690913/assets/68ef9520-24e9-4cf2-b2f5-620025690913/training-american-flights-api/1.0.0/files/fat-raml/zip)​をダウンロードします。 2. `/file-path/training-american-flights-api-1.0.0-raml.zip`​ をダウンロードしたファイルのローカルパスに置き換えます。 3. `ANYPOINT_TOKEN`​、​`:organizationId`​、​`:groupId`​、​`:assetId`​、​`:version`​ を実装に固有の値に置き換えます。 4. プロパティ ​`status`​ を ​`development`​ または ​`published`​ に設定します。 5. Execute (実行): ```console curl -v \ -H 'Authorization: bearer ANYPOINT_TOKEN' \ -H 'x-sync-publication: true' \ -F 'name=RAML asset name' \ -F 'description=Description of the asset' \ -F 'keywords=best, raml' \ -F 'status=development' \ -F 'properties.mainFile=american-flights-api.raml' \ -F 'properties.apiVersion=v1' \ -F 'files.raml.zip=@/file-path/training-american-flights-api-1.0.0-raml.zip' \ https://anypoint.mulesoft.com/exchange/api/v2/organizations/:organizationId/assets/:groupId/:assetId/:version ``` Exchange API バージョン 1 を使用してアセットを作成し、そのライフサイクル状態を設定するには、項目として status プロパティを設定します。 ### [](#upload-asset-icons)アセットアイコンとして使用する画像のアップロード パブリッシュエンドポイントを使用して、アセットアイコンとして使用する画像をアップロードします。Exchange ポータルに表示されるアイコンは、ユーザーがアセットを探すときに役立ちます。アイコンは会社のログやその他の画像にできます。次のファイルの種類がサポートされています。 - GIF - JPG - JPEG - PNG - SVG アセットアイコンは、バージョンに依存しません。これらは、アセットがバージョン設定されても新しいアイコンに置き換わることはありません。 \+ 次の例は、png ファイル画像をアップロードし、アセットアイコンとして使用する方法を示しています。アセットを指定するには、識別子 ​`:groupId`​、​`:assetId`​、​`:version`​ 実装に固有の値に置き換えます。​`files.icon.png`​ が ​`my-asset-icon.png`​ と同じファイルの種類であることを確認します。 ```console curl -v \ -H 'Authorization: bearer ANYPOINT_TOKEN' \ -H 'x-sync-publication: true' \ -F 'name=My asset name' \ -F 'description=Asset with an uploaded icon' \ -F 'files.raml.zip=@/file-path/training-american-flights-api-1.0.0-raml.zip' \ -F 'files.icon.png=@/file-path/my-asset-icon.png' \ https://anypoint.mulesoft.com/exchange/api/v2/organizations/:organizationId/assets/:groupId/:assetId/:version ``` ## [](#describe-your-assets)アセットを説明する アセットをパブリッシュしたら、省略可能な​[タグ](https://docs.mulesoft.com/jp/exchange/to-describe-an-asset#add-asset-tags)​、​[カテゴリ](https://docs.mulesoft.com/jp/exchange/to-manage-categories)​、​[カスタム項目](https://docs.mulesoft.com/jp/exchange/to-manage-custom-fields)​を追加して、メタデータを強化し、アセットを見つけやすくします。 ### [](#add-tags)タグを追加する 次の例は、アセットのタグを挿入または置き換える方法を示しています。各アセットは、グループ ID、アセット ID、バージョンの組み合わせで一意に識別されます。アセットを指定するには、識別子 ​`:groupId`​、​`:assetId`​、​`:version`​ を置き換えます。 次のコマンドでは、アセットの既存のタグが置き換えられます。 ```console curl 'https://anypoint.mulesoft.com/exchange/api/v2/assets/:groupId/:assetId/:version/tags' \ -X 'PUT' \ -H 'accept: application/json' \ -H 'authorization: bearer ANYPOINT_TOKEN' \ -H 'content-type: application/json' \ -d '[{"value":"rest-api"}, {"value":"documentation"}]' ``` ### [](#add-categories)カテゴリを追加する カテゴリは、組織のシステム管理者が追加および管理する管理項目です。 次の例では、以前に作成した ​`apiType`​ という名前のカテゴリを使用し、アセットのそのカテゴリの値を ​`System API`​ に設定します。各アセットは、グループ ID、アセット ID、バージョンの組み合わせで一意に識別されます。アセットを指定するには、識別子 ​`:groupId`​、​`:assetId`​、​`:version`​ を置き換えます。 ```console curl -X PUT \ https://anypoint.mulesoft.com/exchange/api/v2/assets/:groupId/:assetId/:version/tags/categories/apiType \ -H 'Authorization: bearer ANYPOINT_TOKEN' \ -H 'Content-Type: application/json' \ -d '{ "tagValue": ["System API"] }' ``` ### [](#add-custom-fields)カスタム項目を追加する 次の例では、以前に作成した ​`subType`​ という名前のカスタム項目を使用して、アセットのそのカテゴリの値を ​`OAS`​ に設定します。各アセットは、グループ ID、アセット ID、バージョンの組み合わせで一意に識別されます。アセットを指定するには、識別子 ​`:groupId`​、​`:assetId`​、​`:version`​ を置き換えます。 ```console curl -X PUT \ https://anypoint.mulesoft.com/exchange/api/v2/assets/:groupId/:assetId/:version/tags/fields/subType \ -H 'Authorization: bearer ANYPOINT_TOKEN' \ -H 'Content-Type: application/json' \ -d '{ "tagValue": ["OAS"] }' ``` ### [](#promote-lifecycle-state)ライフサイクル状態を昇格する 考えられる 3 つの​[アセットライフサイクル状態](https://docs.mulesoft.com/jp/exchange/lifecycle)​の昇格を次に示します。 1. `development`​ から ​`stable` 2. `stable`​ から ​`deprecated` 3. `deprecated`​ から ​`stable` `stable`​ 状態は ​`published`​ とも呼ばれます。 この例では、​`ANYPOINT_TOKEN`​、​`:groupId`​、​`:assetId`​、​`:version`​ を実装に固有の値に置き換え、​`:status`​ を ​`development`​、​`published`​、​`deprecated`​ のいずれかに置き換えます。 ```console curl -X https://anypoint.mulesoft.com/exchange/api/v2/assets/:groupId/:assetId/:version/status \ -H 'Authorization: bearer ANYPOINT_TOKEN' \ -d '{"status": ":status"}' ``` ### [](#update-asset-metadata)アセットメタデータの更新 この例は、バージョン番号を変更したり、アセットの新しいバージョンを作成したりせずに、既存のアセットを説明する可変メタデータを更新する方法を示しています。この可変データには、カテゴリ、カスタム項目、タグ、ドキュメントページが含まれます。 キー ​`categoryKey`​ はカテゴリをパブリッシュし、キー ​`fieldKey`​ はカスタム項目をパブリッシュします。組織にカテゴリまたはカスタム項目が設定されていない場合、パブリッシュは失敗します。 `files.docs.zip`​ というドキュメントファイルをアップロードすると、アセットのドキュメントが更新されます。アーカイブのルートディレクトリには、​`Getting Started.md`​ などの名前のマークダウンファイルとして各ドキュメントページが含まれています。他の各ページは、ファイル名の ​`Getting Started`​ がページのタイトルに置き換えられます。省略可能な契約条件ページには、ファイル名 ​`terms.md`​ が使用されます。省略可能なサブディレクトリ ​`resources`​ には、画像などのリソースが含まれます。省略可能なファイル ​`config.json`​ のメインオブジェクトのルートにあるプロパティ ​`pageOrder`​ では、ページの順序が指定されます。 ```console { "pageOrder": ["home", "Getting Started", "Examples"] } ``` ```console curl --location --request PATCH 'https://anypoint.mulesoft.com/exchange/api/v2/organizations/:organizationId/assets/:groupId/:assetId/:version/mutabledata' \ --header 'Authorization: bearer YOUR_TOKEN' \ --form 'tags="1, 2, 3, 4"' \ --form 'categories.categoryKey="value1, value2"' \ --form 'fields.fieldKey="value1, value2"' \ --form 'files.docs.zip=@"/file-path/docs.zip"' ``` 可変データは非同期で更新され、要求は次のような応答を返します。 ```console { "mutableDataStatusLink":"https://anypoint.mulesoft.com/exchange/api/v2/organizations/:organizationId/assets/:groupId/:assetId/:version/mutabledata/status/170d1e6f-d567-48e2-a2f4-00b2e3951be6" } ``` `mutableDataStatusLink`​ へのコールで、パブリッシュの状況が表示されます。 ```console curl https://anypoint.mulesoft.com/exchange/api/v2/organizations/:organizationId/assets/:groupId/:assetId/:version/mutabledata/status/170d1e6f-d567-48e2-a2f4-00b2e3951be6 \ --header 'Authorization: bearer YOUR_TOKEN' ``` 要求で認証ヘッダーが提供されない場合、エラー​**「Unauthorized (未認証)」**​で失敗します。 ## [](#add-update-doc-pages)ドキュメントページを追加および更新する 各 Exchange アセットには、アセットに関する概要やその他の情報を提供するドキュメントが関連付けられています。Exchange API でドキュメントを追加または更新するには、「Exchange administrator (Exchange 管理者)」権限またはる「Exchange Contributor (Exchange コントリビューター)」権限が必要です。 Exchange API を使用してドキュメントを追加または更新する手順は、次のとおりです。 1. ドラフトモードで新しいページを追加します。 2. コンテンツをページに追加します。 3. ドラフトをパブリッシュします。 ### [](#add-new-page-draft)ドラフトモードで新しいページを追加する 新しいドキュメントページを追加するには、次のコマンドを使用して ​`:groupId`​、​`:assetId`​、​`:version`​ をアセットの値に置き換えます。 ```console curl https://anypoint.mulesoft.com/exchange/api/v2/assets/:groupId/:assetId/:version/portal/draft/pages \ -X POST \ -H 'Authorization: bearer ANYPOINT_TOKEN' \ -H 'Content-Type: application/json' \ -d '{ "pagePath": "Security" }' ``` コマンドが成功したら、新しく作成されたページの ​`pageId`​ 値が返されます。 Exchange では、アセットの Exchange ポータルページのデフォルトのホームページに新しいドラフトページが表示されます。このページを編集してドラフトをパブリッシュするには、ポータルユーザーインターフェースまたは Exchange API を使用します。 ### [](#add-content-to-page)コンテンツをページに追加する ドキュメントページは、GitHub マークダウンで作成されます。詳細は、​[「マークダウンに関する注意」](https://docs.mulesoft.com/jp/exchange/to-describe-an-asset#markdown-notes)​を参照してください。 マークダウンコンテンツを追加するには、次のコマンドを使用して、​`:pageId`​ を前に取得したページ ID に置き換えます。 ```console curl https://anypoint.mulesoft.com/exchange/api/v2/assets/:groupId/:assetId/:version/portal/draft/pages/:pageId \ -X PUT \ -H 'Authorization: bearer ANYPOINT_TOKEN' \ -H 'Content-Type: text/markdown' \ -d 'markdown *content* for this page' ``` ### [](#publish-draft)ドラフトをパブリッシュする ドラフトをパブリッシュすると、アセットに関連付けられていて現在 \[draft (ドラフト)\] 状況のすべてのページとコンテンツがパブリッシュされます。コンテンツの準備ができたら場合、ページの状況を \[draft (ドラフト)\] から \[published (パブリッシュ済み)\] に変更します。 ```console curl https://anypoint.mulesoft.com/exchange/api/v2/assets/:groupId/:assetId/:version/portal \ -X PATCH \ -H 'Authorization: bearer ANYPOINT_TOKEN' ``` ## [](#add-runtime-info)ランタイム情報をアセットに追加する API アセットにコンシューマーが API を検出、学習、理解するために必要なすべての情報が追加されたら、コンシューマーが API を呼び出すことができるようにサーバーまたはインスタンス情報を追加します。​`:groupId`​、​`:assetId`​、​`:versionGroup`​ を API アセットのグループ ID、アセット ID、バージョン ID に置き換えます。 ```console curl https://anypoint.mulesoft.com/exchange/api/v2/assets/:groupId/:assetId/versionGroups/:versionGroup/instances/external \ -X POST \ -H 'Authorization: bearer ANYPOINT_TOKEN' \ -d '{ "name": "Production - US", "endpointUri": "http://dog.domain.tld.com/much/doge", "isPublic": false }' ``` ## [](#関連情報)関連情報 - [EU Exchange](https://eu1.anypoint.mulesoft.com/exchange/) - [Exchange API](https://anypoint.mulesoft.com/exchange/portals/anypoint-platform/f1e97bc6-315a-4490-82a7-23abe036327a.anypoint-platform/exchange-experience-api/)