Como converter JSON para XML (arrays, atributos, elemento raiz e valores null explicados)
Converta JSON para XML online: cole ou solte o arquivo, nomeie a raiz e os itens de array, decida o que fazer com null e chaves inválidas e baixe XML válido.
Atualizado em 8 de novembro de 20269 min de leitura
Para converter JSON para XML, cole o JSON ou solte o arquivo no conversor JSON para XML, defina o elemento raiz e como os itens dos arrays são nomeados, clique em Converter para XML e baixe ou copie o resultado. O botão é a parte fácil. JSON e XML não descrevem dados da mesma forma: o XML precisa de exatamente um elemento raiz, não tem tipo array, tem atributos que o JSON não conhece e recusa muitos nomes de chave que o JSON aceita sem reclamar. Todo conversor de JSON para XML online precisa tomar uma decisão em cada um desses pontos. Este guia mostra qual é cada decisão, o que o padrão produz e qual configuração mudar quando o XML precisa bater com um sistema que espera um formato específico.
JSON para XML em quatro passos
Adicione seu JSON
Abra o conversor JSON para XML e cole o JSON na caixa, ou solte um arquivo .json, .jsonl, .ndjson, .geojson ou .txt. Um arquivo com um valor JSON por linha (JSON Lines) é reconhecido sozinho; não é preciso trocar de modo.
Nomeie a raiz e os itens de array
Digite o Elemento raiz (root por padrão). Em Nome dos elementos de array, escolha Tag fixa (todos os itens usam a Tag de array, item por padrão), Chave pai ou Singular.
Decida como os valores são escritos
Escolha o que os Valores null viram, o que acontece com as Chaves que não são nomes XML e se quer ativar Chaves @ como atributos. Depois escolha a indentação, a declaração XML e a codificação.
Converta e exporte
Clique em Converter para XML. A Pré-visualização do XML acompanha suas configurações à medida que você as muda. Baixe o arquivo .xml ou copie-o. Se você mudar uma configuração depois de converter, o resultado fica marcado como desatualizado até você aplicar de novo.
Como cada valor JSON vira XML
O JSON tem objetos, arrays, strings, números, booleanos e null. O XML tem elementos, atributos e texto. Com as configurações padrão, a correspondência é esta:
| JSON de entrada | XML de saída (padrão) | Por quê |
|---|---|---|
{"name": "Ada"} | <root><name>Ada</name></root> | Cada chave vira um elemento filho; a raiz envolve o documento |
"tags": ["a", "b"] | <tags><item>a</item><item>b</item></tags> | Um array vira o mesmo elemento repetido, uma vez por item |
"age": 36 | <age>36</age> | O XML não tem tipo numérico; os dígitos são escritos como texto |
"active": true | <active>true</active> | Booleanos também são texto |
"city": null | <city></city> | Null vira um elemento vazio, a menos que você escolha outra coisa |
"meta": {} ou "list": [] | um elemento vazio | Não há nada dentro, então nada é escrito dentro |
As chaves mantêm a ordem que têm na sua origem, inclusive as que parecem números. Os números são copiados caractere por caractere, então um código de pedido de 20 dígitos continua exato e 1e-7 continua 1e-7 em vez de ser arredondado. Caracteres como &, < e > são escapados. Caracteres de controle que o XML não consegue representar de jeito nenhum são removidos, e a ferramenta informa quantos foram.
O elemento raiz: o XML precisa de exatamente um
Um arquivo JSON pode começar com um objeto, um array ou até uma única string. Um documento XML precisa ter exatamente um elemento de nível superior, então o conversor tem que inventar um. É para isso que serve a caixa Elemento raiz. O padrão é root; troque pelo que o sistema de destino espera, como orders, response ou catalog.
Se você digitar um nome que não é válido em XML, por exemplo my data com espaço, ele é reparado e a mudança é mostrada em vez de ser aplicada em silêncio. Quando o seu JSON começa com um array, cada item é escrito sob a raiz, e o nome da raiz também faz o papel de chave pai para os modos de nomeação de arrays descritos a seguir.
Arrays: tag fixa, chave pai ou singular
O XML não tem arrays. Uma lista é escrita como o mesmo elemento repetido, e o conversor precisa decidir como esse elemento se chama. Veja {"books": [{"title": "Emma"}, {"title": "Dune"}]}:
| Nome dos elementos de array | Resultado | Use quando |
|---|---|---|
| Tag fixa (padrão) | <books><item>…</item><item>…</item></books> | Quem consome espera uma tag genérica para todas as listas |
| Chave pai | <books><books>…</books><books>…</books></books> | O esquema repete o nome do contêiner |
| Singular | <books><book>…</book><book>…</book></books> | Você quer o XML que uma pessoa escreveria à mão |
Singular lida com plurais comuns do inglês: books vira book, categories vira category, children vira child. Quando uma palavra não pode ser encurtada, a tag fixa é usada no lugar, assim você nunca recebe por acidente um elemento aninhado dentro de outro com o mesmo nome. Um arquivo JSON Lines é tratado como um array de nível superior: cada linha vira um elemento repetido sob a raiz.
Atributos com chaves @ e #text
O JSON não tem nada que corresponda a um atributo XML, então atributos precisam de uma convenção. Ative Chaves @ como atributos e uma chave que começa com @ vira atributo do seu elemento, enquanto a chave #text vira o texto do próprio elemento. Assim, {"price": {"@currency": "EUR", "#text": "9.50"}} é escrito como <price currency="EUR">9.50</price>.
- A opção vem desativada, porque
@e#textpodem ser simplesmente chaves comuns nos seus dados. - Um atributo só pode guardar texto simples. Se uma
@keycontém um objeto ou um array, ela é escrita como um elemento filho normal, e a quantidade é informada. Nada se perde. - É a mesma convenção que a ferramenta XML para JSON lê, então dados convertidos de um lado e de volta mantêm o formato. Os detalhes dessa direção estão no guia para converter XML para JSON.
Chaves que não são nomes XML válidos
Qualquer string pode ser uma chave JSON. Um nome de elemento XML precisa começar com uma letra ou sublinhado, não pode ter espaços nem a maioria dos sinais de pontuação, e nomes que começam com as letras xml são reservados. Exportações de planilhas e APIs quebram essas regras o tempo todo: first name, 2024, unit-price ($). A configuração Chaves que não são nomes XML oferece duas opções.
| Configuração | "first name": "Ada" vira | Contrapartida |
|---|---|---|
| Reparar (padrão) | <first_name>Ada</first_name> | Nomes limpos; cada renomeação aparece ao lado da pré-visualização |
| Manter em um atributo | <key name="first name">Ada</key> | O texto original fica intacto; o XML fica mais difícil de consultar |
Um dígito inicial ganha um sublinhado na frente em vez de ser apagado, então 2024 vira _2024. Se duas chaves forem reparadas para o mesmo nome, como first name e first-name, a segunda vira first_name_2, e nenhum valor se perde. Chaves com acentos ou em alfabetos não latinos, como Führung ou 名前, já são nomes XML válidos e ficam como estão. Emojis em chaves viram um sublinhado, porque os leitores de XML não concordam sobre aceitá-los.
Valores null, declaração, indentação e codificação
Um null do JSON tem três grafias possíveis em XML, e cada uma significa algo diferente para quem lê o arquivo:
- Elemento vazio, o padrão:
<city></city>. A maioria dos sistemas lê isso como uma string vazia. - xsi:nil:
<city xsi:nil="true"/>, com o namespace schema-instance declarado na raiz. É a forma que um sistema validado por XSD espera para dizer “sabidamente sem valor”. - Omitir: o elemento não é escrito. Isso vale só para membros de objetos. Um null dentro de um array continua sendo escrito, porque removê-lo deslocaria a posição de todos os itens seguintes.
Em Saída, a linha de Declaração XML informa a versão e a codificação no topo do arquivo e vem ativada. A Indentação pode ser 2 espaços, 4 espaços, Tabulação ou Nenhuma, que grava o documento inteiro em uma única linha, para programas e não para pessoas. A indentação nunca adiciona espaços dentro de um elemento que contém texto, então a saída formatada e a compacta carregam os mesmos valores. Codificação oferece UTF-8, UTF-16 e ISO-8859-1, e os bytes são de fato codificados assim. Em ISO-8859-1, caracteres fora do Latin-1 são escritos como referências numéricas de caractere, como € para o símbolo do euro, o que é XML válido e não perde nada. Escolha UTF-8, a menos que o sistema de destino peça outra coisa.
Quando a conversão falha, e o que o plano grátis cobre
JSON inválido é a falha mais comum. O conversor mostra a mensagem, a linha e a coluna, e um trecho com a posição marcada; a causa costuma ser uma vírgula sobrando no final, uma string entre aspas simples ou um colchete faltando. O Validador JSON é o lugar mais rápido para corrigir. Chaves duplicadas são JSON válido, mas ambíguo, por isso são apontadas em vez de a ferramenta ficar em silêncio com a última.
| Grátis | Pro | |
|---|---|---|
| Arquivos por conversão | 1 | Até 50, baixados em um único ZIP |
| Tamanho por arquivo | 10 MB | Sem limite fixo, até o que o seu dispositivo aguentar |
| Raiz, nomes de array, null, reparo de nomes, atributos | Sim | Sim |
| Indentação, declaração, as três codificações | Sim | Sim |
| Esquema XSD, namespace e prefixo, anotações de tipo | Não | Sim |
Um arquivo acima de 10 MB é recusado logo de início, com o tamanho real. Espaços costumam ser uma parte grande de uma exportação formatada, então passar o arquivo antes pelo Minificador JSON pode colocá-lo abaixo do limite. Conte com um XML maior que o JSON, cerca do dobro para dados comuns, porque cada valor fica entre uma tag de abertura e outra de fechamento. Se os seus dados vêm de uma planilha, CSV para XML pula a etapa do JSON por completo.
Cole ou solte JSON, nomeie a raiz e os itens de array, escolha como tratar null e chaves inválidas e baixe XML válido. Grátis: um arquivo de até 10 MB com todas as configurações de estrutura e saída. Pro: até 50 arquivos em um ZIP, XSD, namespaces e anotações de tipo. Tudo roda no seu dispositivo, não nos nossos servidores.
Converter JSON para XMLPerguntas frequentes
Como converter JSON para XML online?
Cole o JSON ou solte o arquivo no conversor JSON para XML, defina o elemento raiz e como os itens de array são nomeados, clique em Converter para XML e baixe ou copie o XML. O plano grátis cobre um arquivo de até 10 MB.
Como um array JSON é convertido para XML?
Como o mesmo elemento repetido uma vez por item, dentro de um elemento com o nome da chave do array. O elemento repetido se chama item por padrão; você pode nomeá-lo pela chave pai ou pelo singular dela, e assim um array books grava elementos book.
Dá para criar atributos XML a partir de JSON?
Sim. Ative Chaves @ como atributos: uma chave que começa com @ vira atributo, e #text vira o texto do elemento. Uma chave @ que contém um objeto ou array é escrita como elemento filho.
Por que meu XML tem first_name se o JSON dizia first name?
Espaços não são permitidos em nomes de elementos XML, então a chave foi reparada. Cada renomeação aparece ao lado da pré-visualização. Escolha Manter em um atributo para gravar o texto original em um atributo name.
O que acontece com valores null ao converter JSON para XML?
Por padrão, um null vira um elemento vazio. Você pode gravá-lo como xsi:nil, que os esquemas entendem, ou omiti-lo. Omitir vale só para membros de objetos; nulls dentro de arrays são sempre escritos.
Por que o arquivo XML é maior que o meu JSON?
No XML cada valor fica entre uma tag de abertura e uma de fechamento que repetem o nome do elemento, enquanto o JSON nomeia a chave uma vez só. Com dados comuns o XML fica com cerca do dobro do tamanho. A indentação Nenhuma deixa o arquivo menor.