Cada item JSON deve ter um identificador estável, uma lesma única, uma data de publicação e uma data de modificação. O arquivo também deve anunciar sua versão do esquema e sua própria data de atualização.
Estes campos definem um contrato editorial proposto; a norma JSON não exige slug nem data.
A decisão de tomar primeiro
Versão Os dados e sua estrutura. Adicionar um campo opcional é simples; Renomear ou remover um campo requer migração explícita, controle de unidade e histórico verificável.
Um método concreto
- Atribua um identificador independente de título imutável.
- Mantenha lesmas publicados ou prepare um redirecionamento.
- Classifique as chaves de forma consistente para obter diferenças legíveis.
- Verifique duplicatas, tipos e datas antes de cada confirmação.
- Etiqueta no Git Lotes editoriais importantes.
A armadilha principal
Reutilize um identificador ou regenere todas as lesmas cria colisões, links quebrados e perda de rastreabilidade. A identidade de um artigo não deve depender de um campo editável.
Próximo passo recomendado
Escreva um controle de CLI que conte artigos, localize lesmas duplicados e valide os campos obrigatórios em cada idioma.
Referências documentadas para este tema
| Referência | Valor ou sintaxe | Âmbito |
|---|---|---|
| RFC 8259 · JSON | application/json · UTF-8 | JSON padrão não admite comentários nem vírgulas finais; as cadeias usam aspas duplas. |
| WordPress · Tools Export | WXR / XML | A exportação de conteúdos WordPress pode incluir artigos, páginas, tipos de conteúdo, comentários, campos personalizados e taxonomias. O âmbito depende dos filtros. Verifique separadamente ficheiros multimédia, tema, extensões e configuração antes de falar de migração completa. |
| HTTP · If-Match | If-Match: "r7" → 412 | If-Match compara um validador forte antes de escrever. No contrato ilustrado, uma versão antiga recebe 412; conserve o rascunho para comparar alterações. |
As datas indicam a consulta das fontes. Estes dados não constituem uma auditoria do site nem uma declaração global de conformidade.
Oficina de verificação: provas antes da decisão
Exercício proposto para um âmbito escolhido, com dados fictícios se necessário. Registe o que observa; este cenário não descreve um teste já efetuado no seu site.
- Operação a experimentar
Numa cópia de trabalho, corrija uma frase do artigo JSON mantendo o identificador. Compare dados e regenere a página.
- Registo a conservar
Guarde diff, resultado do analisador JSON e página. Verifique título, URL, relações e conteúdos vizinhos.
- O que a prova não demonstra
JSON válido pode conter erros factuais. Um identificador estável não garante publicação ou recuperação corretas.
uma mudança que vale a pena ver
Uma equipe corrige o tempo de resposta indicado em doze artigos JSON. Ele atualiza o fato de origem, registra os doze IDs afetados e verifica se os títulos, datas e links não foram alterados acidentalmente. Uma comparação de arquivos antes do lançamento mostra exatamente quais respostas foram editadas.
Mantenha um ID estável para cada artigo e valide JSON antes da implantação. Uma correção de uma frase não deve criar um novo URL ou apagar o histórico. Registre por que a mudança foi feita e quem a aprovou.