---
schema_version: "1"
id: 364d9823acd49bdf978c32332670cf5a81e1c62591779daf2f9da57e9d85611b
title: APIkit for REST Module リファレンス
collection: mulesoft
version: current
locale: ja-jp
portal_url: https://docs.salesforce.com/mulesoft/current/ja-jp/apikit/latest/apikit-4-xml-reference.md
canonical_url: https://docs.mulesoft.com/jp/apikit/latest/apikit-4-xml-reference
source_site: docs.mulesoft.com
content_type: documentation
content_hash: 0d4a4ac2069ee93fe837c3291d765eb3ce633043f5fa495869896fa333f2b01e
description: MuleSoft Documentation Site
release: 4.x
latest: true
---
# APIkit for REST Module リファレンス

連動関係、名前空間、スキーマ、および APIkit for REST に関するその他の情報についての基礎を学びます。

## [](#apikit-for-rest-連動関係情報)APIkit for REST 連動関係情報

<dependency>
  <groupId>org.mule.modules</groupId>
  <artifactId>mule-apikit-module</artifactId>
  <version>LATEST\_VERSION</version> **(1)**
  <classifier>mule-plugin</classifier>
</dependency>

<table><tbody><tr><td><i class="conum" data-value="1"></i><b>1</b></td><td><strong>LATEST_VERSION</strong>​ を入手するには、 <a href="https://docs.mulesoft.com/release-notes/apikit/apikit-release-notes">APIkit リリースノート</a>​を確認してください。</td></tr></tbody></table>

## [](#apikit-for-rest-の設定と操作)APIkit for REST の設定と操作

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 34.0909%;">
<col style="width: 56.8181%;">
<col style="width: 9.091%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">要素名</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">必須</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>apikit:config</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>APIkit 設定。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>はい</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>apikit:console</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>API Console URL を定義する api-console フロー内の ​<code>http:listener</code>​ 要素の ​<code>config-ref</code>​ のプロパティ。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>いいえ</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>apikit:router</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>フロー要素内でネストされた REST ルーティングメッセージプロセッサー。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>はい</p>
</div></div></td>
</tr>
</tbody>
</table>

### [](#apikitconfig-の属性)apikit:config の属性

`apikit:config`​ 属性は ​`NonBlankString`​ 型です。

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 22%;">
<col style="width: 10%;">
<col style="width: 68%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">属性名</th>
<th class="tableblock halign-left valign-top">必須</th>
<th class="tableblock halign-left valign-top">説明</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>outboundHeadersMapName</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>いいえ</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>応答ヘッダーを含むマップの名前。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>httpStatusVarName</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>いいえ</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>応答の HTTP 状況コードを保存する変数の名前。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>keepRamlBaseUri</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>いいえ</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>同等の ​<code>keepApiBaseUri</code>​ 属性の別名。</p>
</div>
<div class="paragraph">
<p>この属性は、バージョン APIkit 1.2.0 で非推奨になりました。APIkit 1.1.x との互換性を提供するために含まれています。<br>
API 実装では、​<code>keepRamlBaseUri</code>​ の代わりに ​<code>keepApiBaseUri</code>​ を使用します。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>name</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>はい</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>apikit:router</code>​ などの他の要素が参照する設定名。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>raml</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>はい</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>同等の ​<code>api</code>​ 属性の別名。</p>
</div>
<div class="paragraph">
<p>この属性は、バージョン APIkit 1.2.0 で非推奨になりました。APIkit 1.1.x との互換性を提供するために含まれています。<br>
API 実装では、​<code>raml</code>​ の代わりに ​<code>api</code>​ を使用します。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>parser</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>いいえ</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>要求の検証に使用されるパーサー。</p>
</div>
<div class="paragraph">
<p>APIkit 1.2.0 以降で有効な属性。</p>
</div>
<div class="paragraph">
<p>可能な値:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>AUTO</p>
<div class="paragraph">
<p><strong>APIkit ルーター</strong>​は AMF を使用して開始されます。エラーがある場合は、RAML パーサーを使用して開始されます。</p>
</div>
</li>
<li>
<p>AMF</p>
<div class="paragraph">
<p><strong>APIkit ルーター</strong>​は AMF を使用して API を読み取り、受信要求を検証します。</p>
</div>
</li>
<li>
<p>RAML</p>
<div class="paragraph">
<p><strong>APIkit ルーター</strong>​は AMF を使用して開始され、エラーがある場合は RAML パーサーを使用して開始されます。</p>
</div>
</li>
</ul>
</div>
<div class="paragraph">
<p>デフォルト値: AUTO。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>api</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>いいえ</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>ルート API ファイルの場所。</p>
</div>
<div class="paragraph">
<p>この属性は、APIkit 1.2.0 以降で有効です。</p>
</div>
<div class="paragraph">
<p><code>api</code>​ 属性には、​<code>src/main/resources/api</code>​ の下位にあるファイルへの相対パス、または ​<code>API Sync</code>​ リソースパスの任意の URL を使用できます。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>keepApiBaseUri</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>いいえ</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>APIkit 1.2.0 以降で有効な属性。</p>
</div>
<div class="paragraph">
<p><code>false</code>​ に設定すると、API の RAML 定義内の ​<code>baseUri</code>​ が書き換えられます。<br>
<code>true</code>​ に設定すると、​<code>baseUri</code>​ 項目は書き換えられません。</p>
</div></div></td>
</tr>
</tbody>
</table>

リバースプロキシの背後で APIkit を使用し、​`keepRamlBaseUri`​ を ​`true`​ に設定する場合は、​**API Console**​ を使用してプロキシの URL を​`baseUri`​ プロパティに設定します。

### [](#apikitrouter-の属性)apikit:router の属性

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 22%;">
<col style="width: 10%;">
<col style="width: 68%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">属性名</th>
<th class="tableblock halign-left valign-top">必須</th>
<th class="tableblock halign-left valign-top">説明</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>disableValidations</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>いいえ</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>要求の検証を無効にします。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>headerStrictValidation</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>いいえ</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>要求ヘッダーが RAML ファイルで定義されているか、既知のヘッダーのセットに属していることを検証します。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>queryParamsStrictValidation</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>いいえ</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>要求クエリパラメーターが RAML ファイルで定義されていることを検証します。</p>
</div></div></td>
</tr>
</tbody>
</table>

## [](#apikit-for-rest-の名前空間とスキーマ)APIkit for REST の名前空間とスキーマ

xmlns:apikit="http://www.mulesoft.org/schema/mule/mule-apikit"
xsi:schemaLocation="http://www.mulesoft.org/schema/mule/mule-apikit http://www.mulesoft.org/schema/mule/mule-apikit/current/mule-apikit.xsd"

## [](#apikit-for-rest-のシステムプロパティ)APIkit for REST のシステムプロパティ

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 10%;">
<col style="width: 20%;">
<col style="width: 30%;">
<col style="width: 40%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">システムプロパティ</th>
<th class="tableblock halign-left valign-top">デフォルト</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">Since (以降)</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>mule.xml.expandExternalEntities</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>false</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>パーサーが XML 外部エンティティを展開できるようにします。攻撃を防ぐため、デフォルト値は ​<code>false</code>​ です。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>1.3.7</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>mule.xml.expandInternalEntities</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>false</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>パーサーが XML 内部エンティティを展開できるようにします。攻撃を防ぐため、デフォルト値は ​<code>false</code>​ です。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>1.3.7</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>apikit.console.disabled</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>false</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>コンソールを無効にします。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>1.3.7</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>apikit.console.stream.amf.model</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>true</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>AMF パーサーモデルをコンソールにストリーミングします。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>1.5.0</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>raml.json_schema.fail_on_warning</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>false</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>RAML パーサーが設定されるときに、ペイロードの検証中に ​<code>warning</code>​ があると失敗します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>1.1.15</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>yagi.json_duplicate_keys_detection</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>true</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>RAML パーサーが設定されるときに、重複する JSON オブジェクト項目名がないことを確認します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>1.1.15</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>yagi.json_block_unsafe_polymorphic_base_types</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>true</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>RAML パーサーが設定されるときに、安全でないベース種別の使用をブロックします。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>1.5.0</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>mule.apikit.parser</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>AUTO</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>パーサー種別を上書きします。可能な値:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>AMF</p>
</li>
<li>
<p>RAML</p>
</li>
<li>
<p>AUTO</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>1.3.7</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>apikit.multipart.size.limit</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>268435456</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>受信したマルチパートペイロードが制限 (バイト単位) を超えた場合に ​<code>InvalidFormParameterException</code>​ をスローすることで、検証されるマルチパートペイロードのサイズを制限します。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>1.8.0</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>fullDomain</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>localhost</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>コンソールの URL を上書きします。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>1.1.15</p>
</div></div></td>
</tr>
</tbody>
</table>