将 XML 转换为 JSON
适用于:所有 API 管理层级
xml-to-json
策略将请求或响应正文从 XML 转换为 JSON。 此策略可以用来根据仅用 XML 的后端 Web 服务来提升 API。
注意
按照策略声明中提供的顺序设置策略的元素和子元素。 详细了解如何设置或编辑 API 管理策略。
策略语句
<xml-to-json kind="javascript-friendly | direct" apply="always | content-type-xml" consider-accept-header="true | false"/>
属性
属性 | 说明 | 需要 | 默认 |
---|---|---|---|
kind | 属性必须设置为以下值之一。 - javascript-friendly - 转换后的 JSON 具有 JavaScript 开发人员熟知的形式。- direct - 转换后的 JSON 反映了原始 XML 文档的结构。允许使用策略表达式。 |
是 | 空值 |
apply | 属性必须设置为以下值之一。 - always - 始终转换。- content-type-xml - 仅在响应的 Content-Type 标头指示存在 XML 的情况下进行转换。允许使用策略表达式。 |
是 | 空值 |
consider-accept-header | 属性必须设置为以下值之一。 - true - 如果在请求的 Accept 标头中请求了 JSON,则应用转换。- false - 始终应用转换。允许使用策略表达式。 |
否 | true |
使用情况
示例
<policies>
<inbound>
<base />
</inbound>
<outbound>
<base />
<xml-to-json kind="direct" apply="always" consider-accept-header="false" />
</outbound>
</policies>
相关策略
后续步骤
有关使用策略的详细信息,请参阅:
- 教程:转换和保护 API
- 策略参考,其中提供了策略语句及其设置的完整列表
- 策略表达式
- 设置或编辑策略
- 策略示例