Formate e confira JSON no Mac: da resposta da API a dados legíveis

Para inspecionar uma resposta JSON compacta no Mac, cole o próprio JSON na ferramenta JSON do Frset e escolha a formatação. Use a compactação quando precisar voltar a uma versão enxuta. As duas operações verificam a sintaxe JSON; nenhuma confirma se os dados contêm os campos ou valores corretos para sua API.

Copie o corpo da resposta, sem o restante do log

Um cliente de API pode mostrar texto de status, cabeçalhos e o corpo da resposta juntos. Um formatador precisa da parte em JSON. Uma linha como «Resposta recebida:» antes de um objeto ou um bloco de código copiado de uma mensagem pode impedir que um JSON válido seja analisado.

Mantenha a resposta original disponível antes de editar. Por exemplo, {"project":"demo","enabled":true,"items":[1,2]} é um objeto pequeno e válido que você pode usar para conferir o fluxo. A formatação facilita a leitura da estrutura sem alterar os valores pretendidos.

Formate ou compacte com o Frset

1. Abra a busca do Frset e selecione JSON, usando a palavra-chave padrão /json se ainda não a tiver alterado.
2. Cole o corpo JSON na entrada da ferramenta.
3. Escolha Format para adicionar recuo legível ou Minify para remover espaços em branco desnecessários.
4. Execute a ferramenta e inspecione o resultado.
5. Cole o resultado copiado no editor, cliente de API ou nota de trabalho.

Resultados bem-sucedidos são adicionados ao histórico do Frset e copiados para a área de transferência do sistema. Você pode voltar a um resultado anterior pelo gerenciador da área de transferência, conforme o acesso e as regras de retenção do seu plano. Os limites de uso das ferramentas também dependem do plano.

A formatação JSON é uma operação local e não exige um provedor de IA nem um site de formatação online. A ferramenta preserva a ordem das chaves, os literais numéricos e o conteúdo das strings enquanto altera a disposição. A compactação remove espaços de formatação, não espaços dentro dos valores de string; não é compressão de arquivos nem criptografia.

Investigue um erro de sintaxe

Quando a análise falhar, confira a entrada copiada em vez de presumir que a ferramenta deveria corrigi-la. Alguns problemas comuns:

• Vírgulas ausentes ou chaves e colchetes sem par.
• Aspas simples em chaves ou strings onde JSON exige aspas duplas.
• Vírgula depois do último membro ou elemento de uma lista.
• Comentários, prefixos de log ou uma página de erro HTML misturados à entrada.
• Aspas não escapadas ou quebras de linha dentro de uma string.

A especificação JSON, RFC 8259 define o formato. Um literal de objeto JavaScript ou um formato de configuração que permite comentários não é necessariamente um JSON válido. Corrija a fonte deliberadamente e tente novamente; o formatador não adivinha o valor pretendido de um campo ausente.

Diferencie dados legíveis de dados corretos

Uma formatação bem-sucedida significa que a entrada pôde ser analisada. Não confirma que um identificador existe, que um timestamp usa a unidade esperada ou que um campo atende ao contrato da API que o recebe. Valide o esquema e as regras de negócio nos recursos de desenvolvimento apropriados para o seu app.

Confira também se um valor é string ou número. Mudar "0012" para 12 altera os dados, mesmo que o resultado ainda possa ser analisado. Se um campo de data contiver um número inteiro desconhecido, use o guia de conversão de timestamps para investigar a unidade e o fuso horário separadamente.

Para tarefas recorrentes, dê nomes a cópias importantes ou mantenha um exemplo atualizado em uma nota. Veja como salvar trechos de código e configuração. Uma resposta legível é um ponto de partida melhor para depuração, mas a solicitação original e o comportamento da API continuam sendo relevantes.