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
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
- Kit de ressources de la stratégie Gestion des API Azure
- Créer des stratégies à l’aide de Microsoft Copilot dans Azure