JSON WordPress

JSON WordPress é o formato de dados usado pelo CMS para troca de informações entre o site e aplicações externas, principalmente via REST API. Cada post, página, usuário ou configuração pode ser exposto como objeto JSON consumível por qualquer linguagem de programação. É o formato que permite WordPress funcionar como backend para aplicativos mobile, dashboards externos, sites em React/Vue e integrações com sistemas de terceiros.

O que é JSON

JSON é a sigla para JavaScript Object Notation. É um formato de dados textual leve, fácil de ler para humanos e simples de processar para máquinas. Foi criado por Douglas Crockford em 2001 como formato de intercâmbio de dados, originalmente uma simplificação de objetos JavaScript. Tornou-se padrão da web moderna e da maioria das APIs REST do mundo.

O javascript object notation funciona com estrutura de pares chave-valor, idêntica a um objeto JavaScript: chaves entre aspas, valores podem ser strings, números, booleanos, null, arrays ou outros objetos JSON. Sintaxe simples: chave-de-abertura, nome-em-aspas, dois-pontos, valor, e vírgula entre múltiplos pares. Em JSON, os tipos são limitados, mas isso é uma vantagem — toda linguagem moderna sabe ler e escrever JSON sem ambiguidade.

O que é json para um post WordPress: um objeto contendo campos como id, title, content, excerpt, author, date, categories, tags, featured_image, slug. Cada campo é uma chave com valor correspondente. JSON do post completo tem dezenas de campos, incluindo metadados, links de navegação e dados embedded de outros recursos relacionados.

JSON virou padrão por três razões: legibilidade (fácil de inspecionar e debugar), simplicidade (fácil de gerar e parsear em qualquer linguagem) e ubiquidade (presente em toda biblioteca padrão moderna). Comparado a XML — formato dominante anteriormente — JSON ocupa menos espaço, é mais simples sintaticamente e tem parsing mais rápido.

JSON no WordPress: REST API

O WordPress incorporou suporte nativo a JSON com a REST API em 2016, na versão 4.7. A partir desse momento, qualquer instalação WordPress padrão ganhou endpoints automáticos retornando JSON em /wp-json/wp/v2/. Acesse seusite.com/wp-json/wp/v2/posts e veja todos os posts publicados em formato JSON, prontos para serem consumidos por qualquer aplicação.

O json wp api segue convenções REST padrão. GET para ler, POST para criar, PUT/PATCH para modificar, DELETE para remover. Endpoints por tipo de recurso: /posts (artigos), /pages (páginas), /media (mídia), /users (usuários), /categories (categorias), /tags (tags), /comments (comentários). Cada um retorna JSON com schema documentado.

A REST API tem dois usos principais. O primeiro é alimentar o próprio painel WordPress: o editor Gutenberg consome a REST API para listar posts, salvar drafts, gerenciar mídia. Ou seja, o painel moderno do WordPress JÁ é uma SPA consumindo a própria REST API. Quando você usa o editor de blocos, está usando JSON sob o capô.

O segundo uso é integração externa. Aplicativos mobile que mostram conteúdo do blog. Dashboards customizados que agregam métricas. Sites headless com Next.js ou Gatsby consumindo conteúdo via REST. Outros sistemas que precisam ler ou escrever no WordPress. Tudo via JSON.

Combine REST API com AJAX ou fetch nativo no frontend, e você consegue fazer interfaces dinâmicas em qualquer site WordPress. Endpoints customizados podem ser registrados via register_rest_route no PHP, expondo lógica de negócio própria como endpoints REST com JSON estruturado.

Como ler e gerar JSON no WordPress

Para ler JSON externo no PHP, use as funções nativas wp_remote_get e wp_remote_retrieve_body, depois json_decode. Exemplo: response = wp_remote_get(‘https://api.exemplo.com/dados’), body = wp_remote_retrieve_body(response), data = json_decode(body, true). Você obtém array PHP associativo (true como segundo parâmetro do json_decode) e pode acessar os dados.

Para gerar JSON em endpoints customizados da REST API, registre a rota com register_rest_route. Dentro do callback, retorne array PHP — o WordPress automaticamente converte para JSON e adiciona headers HTTP corretos. wp_send_json_success e wp_send_json_error fazem o mesmo em contexto de AJAX. Sempre prefira essas funções nativas em vez de json_encode + echo manual.

Para consumir REST API do WordPress no JavaScript, use fetch nativo. Exemplo: fetch(‘/wp-json/wp/v2/posts’).then(response retorno response.json()).then(posts cada post.title.rendered). Para autenticação em endpoints protegidos, use Application Passwords (introduzidos em WordPress 5.6) ou nonce via wp_localize_script.

Os hooks WordPress permitem modificar JSON gerado pela REST API antes de enviar. Filter rest_prepare_post permite ajustar campos do JSON de cada post. Filter rest_post_query permite modificar query padrão. Permissões customizadas via filter rest_authentication_errors. Tudo extensível pelos padrões nativos do CMS.

Cuidados ao trabalhar com JSON em produção: validar input antes de json_decode (JSON malformado quebra), tratar erros (JSON pode vir vazio se o servidor remoto cair), cachear chamadas externas (não chamar APIs remotas em toda requisição). Combine com cache de objeto via Redis para guardar respostas e reduzir latência de integrações externas.

JSON vs XML

A discussão JSON vs XML hoje é mais histórica que prática. JSON ganhou para 95% dos casos de API moderna. Mas vale entender quando XML ainda faz sentido — porque WordPress ainda usa em alguns lugares (RSS feeds, sitemap, certos webhooks) e você ainda encontra integrações legadas baseadas em XML.

JSON é mais leve. O mesmo dado em JSON ocupa entre 30% e 50% menos espaço que em XML, porque XML tem tags de abertura e fechamento para cada campo enquanto JSON usa só chaves de uma vez. Em APIs com alto volume de tráfego, isso vira economia real de banda e tempo de transferência.

JSON é mais rápido para parsear. JavaScript tem parsing nativo via JSON.parse, fração mais rápida que parsear XML via DOMParser. PHP tem json_decode, mais rápido que SimpleXML. Em endpoints de alta frequência, a diferença é mensurável.

XML tem vantagens em três casos: schemas mais rigorosos via XSD (JSON tem JSON Schema, mas é menos maduro), suporte a comentários (JSON puro não suporta, embora algumas variantes permitam), e integração com sistemas enterprise legados (SAP, Oracle, sistemas bancários antigos frequentemente usam XML/SOAP).

Para WordPress, a regra é simples: APIs novas, sempre JSON. Integrações com sistemas legados que exigem XML, use XML. Não force formato — adapte ao consumidor. A REST API do WordPress já fala JSON nativo, e isso resolve a maioria dos casos modernos.

Para projetos que precisam consumir ou expor dados via JSON em integrações sérias com sistemas externos — CRM, ERP, plataformas de e-commerce, dashboards de BI — a FULL Services entrega a stack profissional WordPress com REST API otimizada, plugins de integração já configurados, cache adequado para chamadas externas e infraestrutura calibrada para sustentar tráfego de API em produção. Em vez de configurar plugin a plugin e gambiarra de cache, você roda em uma operação preparada para JSON em escala desde o primeiro deploy.