Conversion de XML à JSON

S’APPLIQUE À : Tous les niveaux de Gestion des API

La stratégie xml-to-json convertit le corps de la demande ou de la réponse de XML en JSON. Cette stratégie peut être utilisée pour moderniser les API basées sur des services web exclusivement en XML.

Notes

Définissez les éléments enfants et de stratégie dans l’ordre fourni dans l’instruction de stratégie. En savoir plus sur comment définir ou modifier des stratégies du service Gestion des API.

Instruction de la stratégie

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

Attributs

Attribut	Description	Obligatoire	Default
kind	L’attribut doit avoir l’une des valeurs suivantes. - javascript-friendly : le JSON converti présente un format familier aux développeurs JavaScript. - direct : le JSON converti reflète la structure d’origine du document XML. Les expressions de stratégie sont autorisées.	Oui	N/A
apply	L’attribut doit avoir l’une des valeurs suivantes. - always : toujours convertir. - content-type-xml : ne convertir que si l’en-tête de réponse Content-Type indique la présence de XML. Les expressions de stratégie sont autorisées.	Oui	N/A
consider-accept-header	L’attribut doit avoir l’une des valeurs suivantes. - true : appliquer la conversion si le format JSON est demandé dans l’en-tête d’acceptation de la demande. - false : toujours appliquer la conversion. Les expressions de stratégie sont autorisées.	Non	true
always-array-child-elements	L’attribut doit avoir l’une des valeurs suivantes. - true - Convertissez toujours les éléments enfants en un tableau JSON. - false - Convertissez uniquement plusieurs éléments enfants en un tableau JSON. Convertissez un seul élément enfant en un objet JSON. Les expressions de stratégie sont autorisées.	Non	false

Usage

• Sections de la stratégie : inbound, outbound, on-error
• Étendues de la stratégie : global, espace de travail, produit, API, opération
• Passerelles : classiques, v2, consommation, auto-hébergées, espace de travail

Exemple

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

Stratégies connexes

• Transformation

Contenu connexe

Pour plus d’informations sur l’utilisation des stratégies, consultez :

• Tutoriel : Transformer et protéger votre API
• Référence de stratégie pour obtenir la liste complète des instructions et des paramètres de stratégie
• Expressions de stratégie
• Définir ou modifier des stratégies
• Réutilisation de configurations de stratégie
• Référentiel d’extrait de stratégie
• Créer des stratégies à l’aide de Microsoft Copilot dans Azure