Atualizado em 20 de outubro de 2026.
Se utiliza o plugin Semly, comece pela documentação da ligação. O diagnóstico abaixo continua a referir-se à REST API padrão do WordPress; uma palavra-passe de aplicação não é um requisito do mecanismo de emparelhamento do plugin Semly.
Este procedimento aplica-se a WordPress alojado pelo próprio utilizador e à API REST padrão. WordPress.com ou um conector específico podem exigir outros mecanismos.
Identificar o pedido
Registe método HTTP, URL sem segredos, hora, estado, tipo de conteúdo e os campos code e message, quando existirem. A rota dos artigos padrão é /wp-json/wp/v2/posts. Uma instalação numa subpasta ou um tipo de conteúdo personalizado pode alterar o endereço.
Consulte o índice /wp-json/. A forma ?rest_route=/wp/v2/posts pode ajudar a diagnosticar a reescrita de URL. Conseguir ler uma rota não demonstra permissão para criar um artigo.
Interpretar o estado no contexto
| Estado | Verificar |
|---|---|
| 401 | Credenciais, método de autenticação, HTTPS e transmissão do cabeçalho Authorization |
| 403 | Capacidades do utilizador, extensão de segurança, firewall de aplicações ou proxy |
| 404 | Endereço, método, rota, subpasta e identificador do artigo |
O estado por si só não identifica a causa. rest_cannot_create não demonstra que a autenticação tenha funcionado. Um intermediário também pode devolver JSON; confronte a resposta com os registos do administrador.
Verificar sem revelar credenciais
Para um cliente externo compatível, utilize em HTTPS uma palavra-passe de aplicação associada ao utilizador previsto. Não guarde a palavra-passe principal nem o valor de Authorization em registos ou pedidos de suporte. Verifique a transmissão do cabeçalho sem registar o seu conteúdo.
Ler /wp-json/wp/v2/users/me pode confirmar a identidade, mas não o direito de criar ou publicar. A autenticação por cookies e nonce é um mecanismo distinto: não misture os seus requisitos com os das palavras-passe de aplicação.
Testar um rascunho
No seu próprio site, prepare um POST para https://example.com/wp-json/wp/v2/posts, configure a autenticação no cliente e use Content-Type: application/json:
{"title":"API test","content":"Test","status":"draft"}
Verifique o identificador devolvido, o estado e o rascunho na administração. Se a criação for incerta, procure o artigo antes de repetir o POST. Um rascunho guardado e legível é o critério de sucesso; publicar exige capacidades adicionais.
Entregar um diagnóstico útil
Envie ao responsável hora, método, URL e resposta sem segredos. Corrija a causa confirmada. Não atribua o papel de administrador nem desative globalmente as proteções apenas para passar o teste.
