Convertir XML a JSON

SE APLICA A: todos los niveles de API Management

La directiva xml-to-json convierte un cuerpo de solicitud o respuesta de XML a JSON. Esta directiva puede usarse para modernizar API basadas en servicios web de back-end de solo XML.

Nota:

Establezca los elementos de la directiva y los elementos secundarios en el orden proporcionado en la instrucción de directiva. Obtenga más información sobre el establecimiento o modificación de directivas de API Management.

Instrucción de la directiva

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

Atributos

Atributo	Descripción	Necesario	Valor predeterminado
kind	El atributo debe establecerse en uno de los siguientes valores. - javascript-friendly: el código JSON convertido presenta un formato intuitivo para los desarrolladores de JavaScript. - direct: el código JSON convertido refleja la estructura del documento XML original. Se permiten expresiones de directiva.	Sí	N/D
apply	El atributo debe establecerse en uno de los siguientes valores. - always: indica que se debe realizar la conversión siempre. - content-type-xml: especifica que solo se debe realizar la conversión si el encabezado Content-Type indica la presencia de XML. Se permiten expresiones de directiva.	Sí	N/D
consider-accept-header	El atributo debe establecerse en uno de los siguientes valores. - true: especifica que se debe aplicar la conversión si se solicita JSON en el encabezado de aceptación (Accept) de la solicitud. - false: indica que se debe aplicar siempre la conversión. Se permiten expresiones de directiva.	No	true
always-array-child-elements	El atributo debe establecerse en uno de los siguientes valores. - true - Convertir siempre los elementos secundarios en una matriz JSON. - false : solo se convierten varios elementos secundarios en una matriz JSON. Convierta un único elemento secundario en un objeto JSON. Se permiten expresiones de directiva.	No	false

Uso

• Secciones de directiva: entrante, saliente, en error
• Ámbitos de la directiva: global, área de trabajo, producto, API, operación
• Puertas de enlace: clásica, v2, consumo, autohospedada y área de trabajo

Ejemplo

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

Directivas relacionadas

• Transformación

Contenido relacionado

Para más información sobre el trabajo con directivas, vea:

• Tutorial: Transformación y protección de una API
• Referencia de directivas para una lista completa de instrucciones de directivas y su configuración
• Expresiones de directiva
• Establecimiento o edición de directivas
• Reutilización de configuraciones de directivas
• Repositorio de fragmentos de código de directiva
• Creación de directivas mediante Microsoft Copilot en Azure