O guia definitivo da wp REST API (2026): Headless, auth & endpoints personalizados

Pare de pensar no WordPress como uma “Ferramenta de Blog”. Em 2026, o WordPress é um Motor CMS Headless.

A ponte para a web moderna é a WP REST API. Ela expõe o seu conteúdo como JSON: oseusite.pt/wp-json/wp/v2/posts.

Neste guia de 1500 palavras, vamos além dos pedidos GET padrão.

Parte 1: Porque a REST API importa em 2026

A API permite:

1. Frontends Desacoplados: Use Next.js ou Astro.
2. Apps Móveis: Dados diretamente para React Native ou Swift.
3. Integrações: Automação com CRMs.

Parte 2: Autenticação (segurança primeiro)

Para operações de LEITURA, a API é pública. Para ESCRITA, precisa de autenticação.

1. Passwords de aplicação (nativo)

Desde o WP 5.6 é padrão.

• Uso: Scripts, Zapier.
• Header: Authorization: Basic base64(user:password)

2. Jwt (JSON web tokens)

Para Utilizadores Frontend Headless.

• Mecanismo: Login -> Token -> Token no Header.

Parte 3: Criar endpoints personalizados

Endpoints padrão são muitas vezes pesados. Registe as suas próprias rotas.

Cenário: Queremos apenas Título e Preço para uma app.

add_action( 'rest_api_init', function () {
  register_rest_route( 'wppoland/v1', '/featured-products', array(
    'methods' => 'GET',
    'callback' => 'wppoland_get_featured_products',
  ) );
} );

Parte 4: Performance e caching

A REST API é lenta porque carrega todo o núcleo do WordPress.

A solução: Object caching

Faça cache das suas respostas API com Transients.

Resumo

A REST API é o futuro da escalabilidade WordPress.

1. Proteja com Passwords de Aplicação.
2. Estenda com register_rest_route.
3. Faça Cache.