Formatar texto JSON

JSON minificado, em uma linha ou com indentação inconsistente é difícil de ler em revisões de código, tickets de suporte e dumps de log. Esta ferramenta de formatação de texto JSON aceita uma string JSON bruta, valida com análise estrita e re-serializa o valor com indentação de espaços consistente para que objetos e arrays aninhados se alinhem de forma previsível. Quando a carga é inválida, a tarefa falha com invalid_input e informa a posição de caractere do erro de análise para que você possa ir direto à vírgula, aspas ou fragmento sobrante incorretos. Sem reordenar chaves além da serialização JSON padrão, sem idas à rede e sem tokens de modelo—apenas parse e stringify determinísticos ao preço base publicado US$ 0,002 por chamada bem-sucedida.

O que a formatação de uma string JSON realmente faz

Formatar texto JSON significa pegar uma string que afirma ser JSON, analisá-la em um valor e reescrever esse valor com um número fixo de espaços por nível de aninhamento. Esta capacidade usa o campo text como string de origem, executa um parse JSON estrito e devolve um novo campo text com indentação consistente controlada pelo parâmetro opcional indent (inteiro de zero a oito, padrão dois espaços). O algoritmo não busca schemas remotos, não repara JSON quebrado e não reordena chaves de objeto além da ordem natural de serialização do motor sobre o objeto analisado.

Contrato de entrada, campos de resposta e posições de erro de análise

Opcionalmente envie indent como inteiro entre zero e oito; omita para usar dois espaços. Quando o parse falha, a mensagem de erro sempre inclui uma posição de caractere: motores que reportam “at position N” são ecoados com esse N, entrada incompleta é mapeada para o fim da string e outras falhas defaultam para posição zero para que o cliente sempre tenha um alvo de cursor. Envie por POST um corpo JSON com a string text obrigatória contendo o documento a formatar. Text vazio, não string e indent fora do intervalo falham com invalid_input e não são cobrados. Em sucesso a resposta inclui text (o documento formatado), indent (o espaçamento efetivo usado), bytes_in (comprimento UTF-8 da string de origem) e bytes_out (comprimento UTF-8 do resultado formatado). Exemplo: text igual a um objeto minificado com arrays aninhados e indent igual a dois devolve JSON multilinha com passos de dois espaços e chaves casadas. Exemplo de falha: um objeto truncado sem chave de fechamento gera invalid_input citando a posição perto do fim do fragmento. Combine este endpoint com o editor ou visualizador de log saltando para o deslocamento informado; você não precisa de uma segunda chamada de validação.

Onde formatar texto JSON gera valor

Jobs de CI podem rejeitar ou reescrever arquivos de configuração que chegam minificados de geradores upstream, falhando rápido com posição de parse quando um artefato de release é truncado no meio do upload. Validação falha não consome saldo. Desenvolvedores colam respostas de API em chats e tickets; formatar texto JSON transforma linhas opacas em árvores revisáveis sem instalar formatador de desktop. Ferramentas de suporte mostram aos clientes o deslocamento exato de um corpo de webhook malformado em vez de um banner genérico de “JSON inválido”. Como a implementação é parse de nível A puro, cada chamada bem-sucedida custa o preço base publicado US$ 0,002 sem tokens de modelo e sem rede de saída. Prefira este contrato texto-entrada e texto-saída quando o pipeline já guarda JSON como string—logs, conteúdos de arquivo, corpos de mensagem—em vez de objeto pré-analisado.