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
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
- Kit de herramientas de directivas de Azure API Management
- Creación de directivas mediante Microsoft Copilot en Azure