Поделиться через


Преобразование XML в JSON

ОБЛАСТЬ ПРИМЕНЕНИЯ: все уровни Управление API

Политика xml-to-json преобразует текст запроса или ответа в формате XML в формат JSON. Эту политику можно использовать для модернизации интерфейсов API, основанных на серверных веб-службах (только XML).

Примечание.

Задайте элементы политики и дочерние элементы в порядке, указанном в правиле политики. Узнайте, как устанавливать или изменять политики службы управления API.

Правило политики

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

Атрибуты

Атрибут Description Обязательное поле По умолчанию.
kind Для атрибута нужно задать одно из следующих значений:

- javascript-friendly — преобразованный JSON имеет понятное для разработчиков JavaScript форму.
- direct — преобразованный JSON отражает структуру исходного XML-документа.

Допустимы выражения политики.
Да Н/П
apply Для атрибута нужно задать одно из следующих значений:

- always — всегда преобразуйте.
- content-type-xml — преобразуется только в том случае, если заголовок Content-Type ответа указывает на наличие XML.

Допустимы выражения политики.
Да Н/П
consider-accept-header Для атрибута нужно задать одно из следующих значений:

- true — примените преобразование, если JSON запрашивается в заголовке accept запроса.
- false -всегда применять преобразование.

Допустимы выражения политики.
No true
always-array-child-elements Для атрибута нужно задать одно из следующих значений:

- true — Всегда преобразуйте дочерние элементы в массив JSON.
- false — Преобразуйте только несколько дочерних элементов в массив JSON. Преобразуйте один дочерний элемент в объект JSON.

Допустимы выражения политики.
No false

Использование

  • Разделы политики: входящий трафик, исходящий трафик, при возникновении ошибок
  • Области политики: глобальная, рабочая область, продукт, API, операция
  • Шлюзы: классическая, версия 2, потребление, локальное размещение, рабочая область

Пример

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

Дополнительные сведения о работе с политиками см. в нижеуказанных статьях.