Integração WordPress (OAuth + REST API)

O Typedit se conecta ao WordPress via OAuth 2.0 com renovação automática de tokens, usando a REST API nativa do WordPress (sem plugin obrigatório). Esta página documenta o handshake, os escopos requeridos, o mapeamento de entidades editoriais e o fluxo de atualização de matérias já publicadas.

OAuth 2.0

O fluxo de autorização segue o padrão Authorization Code com PKCE. Após o usuário autorizar a aplicação Typedit no admin do WordPress (ou na plataforma WordPress.com), o token é trocado por um access token + refresh token armazenados no servidor.

• Escopos: posts:read, posts:write, media:write, categories:read, tags:read, users:read.
• Refresh: tokens são renovados antes do vencimento via refresh token rotativo.
• Revogação: o usuário pode revogar a conexão a qualquer momento pelo admin do WP — o Typedit detecta a revogação no próximo request e notifica o editor por email.

REST API

Para WordPress self-hosted (.org), o Typedit usa a REST API nativa em /wp-json/wp/v2/. Para WordPress.com, usa a API oficial em public-api.wordpress.com/wp/v2/. O mapeamento de entidades é o mesmo em ambos os casos.

HTTP
POST /wp-json/wp/v2/posts
Authorization: Bearer <access_token>
Content-Type: application/json
Idempotency-Key: <uuid>

{
  "title": "...",
  "content": "...",
  "status": "draft",
  "categories": [12, 34],
  "tags": [56],
  "featured_media": 789,
  "meta": {
    "_yoast_wpseo_title": "...",
    "_yoast_wpseo_metadesc": "..."
  }
}

Mapeamento de entidades

• Categorias: sincronizadas a cada conexão — IDs do WP são respeitados.
• Autores: mapeados por usuário do WP. O Typedit publica em nome do autor humano selecionado pelo editor (não cria autor "AI").
• Mídia: imagens são enviadas para a biblioteca do WP via /media com alt text preenchido.
• Yoast/Rank Math: meta tags são populadas via campos custom (_yoast_wpseo_*, rank_math_*) sem requerer plugins extras do Typedit.

Atualizações de matérias publicadas

Diferente de soluções de push básico, o Typedit suporta atualizar uma matéria já publicada — útil para correções, retificações, retrabalho de SEO ou nota do editor. A atualização preserva o permalink original e regista no audit trail editorial.

HTTP
PATCH /wp-json/wp/v2/posts/{id}
Authorization: Bearer <access_token>
Content-Type: application/json
Idempotency-Key: <uuid>

{
  "content": "...",
  "meta": {
    "_typedit_correction_note": "Correção: número da pesquisa atualizado conforme errata oficial"
  }
}

Segurança

• Tokens armazenados criptografados no banco. Nunca expostos no client.
• Comunicação WP↔Typedit obrigatoriamente sobre TLS 1.2+.
• Rate limiting por workspace para evitar exaustão de recursos do WP cliente.
• Logs de cada request ficam disponíveis para auditoria por 90 dias.