次の方法で共有


XML から JSON への変換

適用対象: すべての API Management レベル

xml-to-json ポリシーは、要求本文または応答方文を XML から JSON に変換します。 このポリシーを使用すると、XML のみのバックエンド Web サービスに基づく API を最新化することができます。

Note

ポリシーの要素と子要素を、ポリシー ステートメントで指定された順序で設定します。 API Management ポリシーを設定または編集する方法について説明します。

ポリシー ステートメント

<xml-to-json kind="javascript-friendly | direct" apply="always | content-type-xml" consider-accept-header="true | false" always-array-child-elements="true | false"/>

属性

属性 説明 必要 Default
kind この属性の値は次のいずれかに設定する必要があります。

- javascript-friendly - 変換後の JSON が JavaScript 開発者にとってわかりやすい形になります。
- direct - 変換後の JSON に元の XML ドキュメントの構造が反映されます。

ポリシー式を使用できます。
はい 該当なし
apply この属性の値は次のいずれかに設定する必要があります。

- always - 常に変換します。
- content-type-xml - 応答の Content-Type ヘッダーに XML の存在が示されている場合のみ変換を行います。

ポリシー式を使用できます。
はい 該当なし
consider-accept-header この属性の値は次のいずれかに設定する必要があります。

- true - 要求の Accept ヘッダーで JSON が要求されている場合に変換を適用します。
- false - 常に変換を適用します。

ポリシー式を使用できます。
いいえ true
always-array-child-elements この属性の値は次のいずれかに設定する必要があります。

- true - 子要素を常に JSON 配列に変換します。
- false - 複数の子要素のみを JSON 配列に変換します。 1 つの子要素を JSON オブジェクトに変換します。

ポリシー式を使用できます。
いいえ false

使用法

<policies>
    <inbound>
        <base />
    </inbound>
    <outbound>
        <base />
        <xml-to-json kind="direct" apply="always" consider-accept-header="false" />
    </outbound>
</policies>

ポリシーに対する処理の詳細については、次のトピックを参照してください。