Преобразование 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>
Связанные политики
Связанный контент
Дополнительные сведения о работе с политиками см. в нижеуказанных статьях.
- Руководство. Преобразование и защита API
- Полный перечень операторов политик и их параметров см. в справочнике по политикам.
- Выражения политики
- Настройка или изменение политик
- Повторное использование конфигураций политик
- Репозиторий фрагментов политик
- Создание политик с помощью Microsoft Copilot в Azure