Configurando o WordPress como Backend Headless

Fala aí! Agora que entendemos o que é a REST API do WordPress, é hora de preparar nosso site para atuar como um backend desacoplado.

Isso envolve otimizações, configurações essenciais e algumas precauções para que o WordPress possa servir dados para o frontend moderno (React, Vue, Next.js) de forma estável e segura.

🧠 Ajustando Permalinks

A REST API depende de permalinks amigáveis (pretty permalinks). Verifique em:

Configurações > Links Permanentes
Escolha algo como: /post-name/

Sem essa configuração, a API pode retornar 404 ou apresentar inconsistências.

🌐 Habilitando CORS (Cross-Origin Resource Sharing)

Ao separar o frontend e o backend em domínios diferentes, o navegador vai bloquear requisições sem uma política CORS.

No functions.php ou plugin customizado, adicione:

add_action('init', function() {
    header("Access-Control-Allow-Origin: *");
    header("Access-Control-Allow-Methods: GET, POST, OPTIONS, PUT, DELETE");
    header("Access-Control-Allow-Headers: Content-Type, Authorization");
});

🔐 Nota: Em produção, substitua o * pelo domínio do seu frontend, para maior segurança.

🔐 Configurando Autenticação

Por padrão, a API é pública para leitura e restrita para escrita.

Você precisará de uma estratégia de autenticação, como:

• JWT Authentication (plugin recomendado)
• OAuth 1.0a (mais complexo, para apps robustos)
• Application Passwords (para testes rápidos)

Exemplo com JWT:
1️⃣ Instale o plugin JWT Authentication for WP REST API
2️⃣ Configure as chaves secretas no wp-config.php
3️⃣ Use tokens JWT para autenticar chamadas de escrita (ex: criar post, upload).

🛡️ Limitando Endpoints Disponíveis

Você pode restringir ou customizar a API removendo endpoints desnecessários:

add_filter('rest_endpoints', function($endpoints) {
    unset($endpoints['/wp/v2/users']);
    return $endpoints;
});

🧩 Expondo Custom Post Types na API

Se você usa Custom Post Types (ex: produtos, portfólio), garanta que estão visíveis na API:

register_post_type('meu_cpt', [
  'label' => 'Meu CPT',
  'public' => true,
  'show_in_rest' => true,
  'supports' => ['title', 'editor', 'thumbnail'],
]);

🔍 Verificando a Configuração

Acesse no navegador:

https://seudominio.com/wp-json/

Você verá a raiz da API, com todos os endpoints disponíveis.

🚀 Pronto para o Frontend

Com essas configurações, seu WordPress está apto a servir dados para o frontend Headless.

Nos próximos dias, vamos montar o frontend com Next.js, listar posts e integrar campos personalizados (ACF).