Converter XML em JSON
APLICA-SE A: todas as camadas do Gerenciamento de API
A política xml-to-json
converte o corpo da solicitação ou da resposta de XML para JSON. Esta política pode ser usada para modernizar APIs baseadas em serviços Web de back-end somente XML.
Observação
Defina os elementos da política e os elementos filho na ordem fornecida na declaração da política. Saiba mais sobre como definir e editar as políticas de Gerenciamento de API.
Declaração de política
<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 | Descrição | Obrigatório | Padrão |
---|---|---|---|
kind | O atributo deve ser definido como um dos valores a seguir. - javascript-friendly – o JSON convertido tem um formato amigável para desenvolvedores de JavaScript.- direct – o JSON convertido reflete a estrutura do documento XML original.Expressões de política são permitidas. |
Sim | N/D |
aplicar | O atributo deve ser definido como um dos valores a seguir. - always – converter sempre.- content-type-xml – converter somente se o cabeçalho Content-Type da resposta indica a presença de XML.Expressões de política são permitidas. |
Sim | N/D |
consider-accept-header | O atributo deve ser definido como um dos valores a seguir. - true – aplica conversão se JSON é solicitado no cabeçalho Accept da solicitação.- false – sempre aplicar conversão.Expressões de política são permitidas. |
Não | true |
always-array-child-elements | O atributo deve ser definido como um dos valores a seguir. - true - Sempre converter elementos filho em uma matriz JSON.- false - Converter em uma matriz JSON apenas se houver vários elementos filho. Converter um único elemento filho em um objeto JSON.Expressões de política são permitidas. |
Não | false |
Uso
- Seções de política: de entrada, de saída, em caso de erro
- Escopos de política: global, espaço de trabalho, produto, API, operação
- Gateways: clássico, v2, consumo, auto-hospedado, workspace
Exemplo
<policies>
<inbound>
<base />
</inbound>
<outbound>
<base />
<xml-to-json kind="direct" apply="always" consider-accept-header="false" />
</outbound>
</policies>
Políticas relacionadas
Conteúdo relacionado
Para obter mais informações sobre como trabalhar com políticas, consulte:
- Tutorial: Transformar e proteger sua API
- Referência de Política para uma lista completa das instruções de política e suas configurações
- Expressões de política
- Definir ou editar políticas
- Reutilizar configurações de política
- Repositório de snippets de política
- Kit de ferramentas de políticas do Gerenciamento de API do Azure
- Criar políticas usando o Microsoft Copilot no Azure