Neste tutorial sobre a API REST WordPress, explicaremos como essa ferramenta funciona e como usá-la. Você também aprenderá sobre seus usos mais comuns e as práticas recomendadas para garantir um desenvolvimento eficiente. Vamos lá?<\/p> \n\n\n\n\n<\/p> <\/p> A API REST do WordPress é uma interface que permite integrar o CMS a outros aplicativos. Ela permite que você desenvolva software ou sites que usam dados, funcionalidade e conteúdo do WordPress sem precisar acessá-los diretamente.<\/p> A WordPress REST API funciona fornecendo endpoints que recuperam e manipulam o conteúdo como dados JSON para garantir a compatibilidade, independentemente das linguagens de programação utilizadas.<\/p>\n <\/div>\n\n\n\n<\/p> Uma interface de programação de aplicativos (API) fornece um conjunto de regras que permite a interação entre dois serviços da web. Enquanto isso, REST significa Representational State Transfer<\/em>, um padrão arquitetônico que define essas comunicações.<\/p> Um aplicativo web que adere aos princípios REST é considerado RESTful. Por exemplo, ele deve usar uma interface uniforme, fornecendo um único ponto de acesso para permitir que outros aplicativos acessem seus dados.<\/p> Para trocar dados, a API REST envia ao banco de dados do WordPress uma solicitação<\/strong>, que é um conjunto de instruções especificando as informações de que seu aplicativo precisa. Em troca, ele envia uma resposta contendo o conteúdo e a confirmação de que o processo foi bem-sucedido.<\/p> Seu aplicativo ou cliente usa rotas <\/strong>para determinar quais dados devem ser recuperados. As rotas são URLs que localizam conteúdo específico por meio da API REST do WP, como publicações ou metadados do WordPress. Por exemplo, a rota abaixo permite que você acesse páginas:<\/p> Essas rotas acessarão as funções de endpoint <\/strong>na API REST do WP que manipulam os dados solicitados. Você pode recuperar, adicionar, editar ou remover as informações, dependendo dos métodos <\/strong>do <\/strong>protocolo HTTP:<\/p> Todos os dados recuperados serão exibidos no formato JSON<\/strong><\/a>, o que significa que você deve analisá-los antes de passá-los para outro código.<\/p> A API REST é ativada por padrão na instalação do WordPress. Após adquirir um plano de hospedagem WordPress rápida<\/a><\/span><\/strong><\/a> e configurar o CMS, acesse o link a seguir para verificar se a API REST está ativada:<\/p> Lembre-se de substituir seudominio.com <\/strong>pelo endereço de seu próprio site. Se você vir uma lista de endpoints, a API REST do WordPress está ativa. Observe que esse recurso só está disponível para o WordPress 4.7 <\/strong>ou posterior.<\/p> Recomendamos configurar um ambiente de teste local para suas atividades de desenvolvimento do WordPress, para evitar configurações incorretas ou erros indesejados que possam afetar a disponibilidade do site ou a experiência do usuário.<\/p>\n <\/div>\n\n\n\n<\/p> Em seguida, instale o utilitário cURL<\/strong><\/a> na interface de linha de comando (CLI) de sua máquina local, como o Prompt de Comando ou o Terminal. Ele permite que você envie e receba solicitações do servidor WordPress para testes.<\/p> Depois, instale o manipulador da API REST Basic Auth<\/strong><\/a> para configurar seu método de verificação. Ele permite que você acesse dados privados que exigem privilégios administrativos.<\/p> Após instalar o plugin, podemos começar a enviar solicitações HTTP por meio da API REST do WordPress. Para fazer isso, abra o WP-CLI<\/strong><\/a> e conecte-se ao seu site via SSH. Os usuários da Hostinger podem encontrar essas credenciais acessando o hPanel <\/strong>→ Gerenciamento de site <\/strong>→ Avançado <\/strong>→ Acesso SSH<\/strong>.<\/p> Vamos tentar acessar dados restritos para verificar se a autenticação da API REST do WP funciona corretamente.<\/p> Por exemplo, executaremos o seguinte prompt no sistema local para recuperar postagens não publicadas:<\/p> Depois de configurar seu ambiente de hospedagem e teste, podemos começar a usar a REST API do WordPress. Aqui estão alguns de seus cenários de uso mais comuns:<\/p> Importante! <\/strong>Antes de continuar, verifique se você entende os métodos de chamada da API e o formato JSON para interpretar os dados brutos com mais rapidez.<\/p><\/div>\n\n\n\n<\/p> Use o método GET para recuperar dados do seu site WordPress por meio da API REST JSON. Por exemplo, vamos buscar conteúdo do endpoint de posts<\/strong>:<\/p> Essa solicitação de API imprimirá todos os posts do seu site WordPress, incluindo detalhes como ID, conteúdo e título. Se você executá-la usando o cURL, a saída deverá ter a aparência mostrada abaixo.<\/p> Você também pode buscar páginas usando o endpoint correspondente:<\/p> O resultado é semelhante, mas o comando recuperará todas as páginas <\/strong>em vez dos posts<\/strong>. Você também pode consultar o tipo de post personalizado<\/strong><\/a> especificando seu nome no endpoint:<\/p> Por exemplo, use o prompt a seguir para recuperar posts personalizados de páginas de produtos<\/strong>:<\/p> Importante! <\/strong>Lembre-se de usar o cURL para testar as solicitações da API REST via WP-CLI. Para o código real do aplicativo, use funções ou bibliotecas como a Fetch do JavaScript<\/a>.<\/p><\/div>\n\n\n\n<\/p> Você pode usar um parâmetro de consulta para modificar a saída, como paginar ou classificar os dados. Por exemplo, use o seguinte endpoint para reordenar as postagens com base na data de criação em ordem crescente:<\/p> Você também pode usar os parâmetros de consulta page <\/strong>e per_page <\/strong>para recuperar um número específico de posts de uma determinada página. Aqui está um exemplo:<\/p> Usando o endpoint, o método GET agrupará as postagens em várias páginas, cada uma contendo 10 entradas, e buscará a segunda.<\/p> O WordPress fornece vários outros parâmetros de consulta para filtrar dados com base em critérios específicos. Para saber mais sobre eles, leia a documentação sobre as referências da API REST para posts<\/strong><\/a>.<\/p> O método POST permite que você adicione novo conteúdo ao banco de dados do WordPress usando um endpoint específico. Por exemplo, use o prompt a seguir para criar uma postagem em branco:<\/p> Você também pode criar novas páginas ou entradas de postagem personalizadas usando seus respectivos endpoints da API REST do WordPress da seguinte forma:<\/p> Para criar uma entrada adequada com um título<\/strong>, status de publicação <\/strong>e conteúdo<\/strong>, especifique esses detalhes no código do aplicativo.<\/p> Além disso, a solicitação POST da API REST do WordPress geralmente requer privilégios administrativos. Se você estiver usando métodos de autenticação como a autenticação aberta (OAuth), certifique-se de adicionar o token de verificação.<\/p> Você também deve adicionar validação de resposta, permitindo que seu aplicativo confirme se a solicitação de API POST foi bem-sucedida.<\/p> O método PUT da API REST permite que você modifique um post, uma página ou uma entrada de post personalizada específica usando seu ID. Por exemplo, você pode inserir novo conteúdo ou alterar o status de publicação.<\/p> A sintaxe é semelhante a outros métodos de chamada de API, mas com o ID do post no final da rota:<\/p> Em seguida, especifique os dados que você deseja modificar. Por exemplo, para inserir novo conteúdo, adicione a seguinte linha:<\/p> Você também pode excluir posts, páginas ou entradas de posts personalizados com o ID deles, como no exemplo abaixo:<\/p> Por padrão, o método DELETE move os dados para a lixeira, permitindo que você os recupere posteriormente, se necessário. Para exclusão permanente, adicione o parâmetro force, <\/strong>da <\/strong>seguinte forma:<\/p> \n Atenção!<\/strong> Recomendamos evitar o argumento force<\/strong> se possível, pois ele pode causar perda acidental de dados. <\/p>\n \n\n\n\n<\/p> A API REST do WordPress fornece vários endpoints padrão com funcionalidades predefinidas. No entanto, eles podem ser insuficientes se seu aplicativo precisar de dados específicos.<\/p> Embora você possa personalizar as saídas dos endpoints padrão usando filtros ou parâmetros de consulta, este processo pode ser ineficaz devido à quantidade de código que você precisará adicionar. Além disso, pode ser difícil obter conteúdo extra, como envios de formulários.<\/p> Para simplificar o acesso aos dados para necessidades específicas, crie endpoints personalizados no WordPress. Você pode fazer isso modificando o arquivo functions.php<\/strong> do seu tema por meio do editor de arquivos do tema <\/strong>ou criando um plugin personalizado para WordPress.<\/p> Adicione o seguinte trecho de código para registrar um endpoint personalizado, incluindo sua rota, função de retorno de chamada e método de consulta:<\/p> Em seguida, especifique a função de retorno de chamada a ser acionada quando o ponto de extremidade for acessado. Ela tratará da manipulação de dados e retornará a resposta solicitada.<\/p> Por exemplo, digamos que seu site WordPress tem formulários cujos envios são registrados como posts personalizados. Você pode criar um endpoint personalizado que permita recuperar as entradas adicionando o seguinte trecho de código:<\/p> A função get_posts<\/strong><\/a> repete os envios, que você pode acessar usando o método GET:<\/p> A autenticação da API REST do WordPress garante a transmissão segura de dados com clientes válidos. Os usuários podem implementar vários mecanismos de autenticação, dependendo dos requisitos de seus aplicativos.<\/p> O WordPress usa a autenticação de cookies <\/strong>por padrão. Ele atribui aos usuários conectados cookies de autenticação, que serão incluídos no cabeçalho da solicitação para chamadas de API subsequentes. Esse método é simples, mas inadequado para serviços de terceiros que exigem autenticação fora do WordPress.<\/p> Outro método é o OAuth, que usa um token de autenticação para validar solicitações de seu serviço da web. Por não usar credenciais de usuário, ele oferece maior flexibilidade e confiabilidade. No entanto, o processo de configuração pode ser mais complicado.<\/p> Para configurar o OAuth, use o plugin oficial da API REST no repositório do GitHub<\/strong><\/a>. Além disso, recomendamos o OAuth 2.0, pois ele é mais simples de implementar, mais escalável e usa uma arquitetura mais moderna do que a versão 1.0.<\/p> A API REST é útil para várias tarefas e aplicativos de desenvolvimento web. Por exemplo, você pode recuperar posts do CMS e exibi-los em outros sites para distribuição de conteúdo.<\/p> Outro caso de uso é permitir o envio de dados de um site estático existente para o back-end do WordPress. Isso simplifica o processo de desenvolvimento, pois você pode aproveitar os recursos do CMS para armazenar os dados em vez de configurar um banco de dados manualmente.<\/p> A integração da API do WordPress também permite que você atualize automaticamente o conteúdo do seu site. Por exemplo, você pode enviar publicações do Apple News para o seu site usando o método PUT sem fazer login.<\/p> Um caso de uso mais avançado da API REST é a criação de um CMS headless. Por exemplo, você pode criar aplicativos móveis de notícias que usam o painel do WordPress para gerenciamento de conteúdo.<\/p> As aplicações da API incluem a obtenção de dados específicos de postagens no banco de dados para o editor de blocos. Outro exemplo é a exibição do Google Maps em sites do WordPress usando plugins.<\/p> Para usar com eficiência a API REST do WordPress em suas tarefas de desenvolvimento e integração, considere as práticas recomendadas a seguir.<\/p> Configure a Autenticação Adequada<\/strong><\/p> Configurar a autenticação adequada aumenta a segurança da API REST WordPress, garantindo que somente usuários ou aplicativos autorizados possam acessar dados confidenciais.<\/p> Isso ajuda a minimizar as vulnerabilidades de segurança, evitando o acesso não autorizado e as violações de dados. Para escolher o melhor método, considere a escalabilidade, a facilidade de implementação e seus requisitos.<\/p> Limpe as Entradas<\/strong><\/p> A limpeza das entradas na API REST do WordPress é importante, especialmente quando se trabalha com dados públicos que todos os usuários podem acessar. Isso envolve a validação e a limpeza da entrada de fontes externas para evitar que códigos mal-intencionados se infiltrem no CMS.<\/p> Ele também ajuda a proteger seu WordPress contra vulnerabilidades de segurança, como injeção de SQL e XSS.<\/p> O WordPress fornece funções internas para sanitizar dados de entrada, como sanitize_text_field()<\/strong>, sanitize_email()<\/strong>, para e-mail, <\/strong>e sanitize_url()<\/strong>. Adicione-as ao código do seu aplicativo para aqueles que receberão e analisarão o conteúdo recuperado.<\/p> Use Cache<\/strong><\/p> O armazenamento em cache ajuda a otimizar o desempenho e a escalabilidade do seu site WordPress. Ele reduz a carga do servidor e melhora os tempos de resposta ao armazenar dados acessados com frequência na memória, permitindo que os clientes e a API recuperem os dados mais rapidamente.<\/p> Minimizar a carga do servidor também ajuda a manter o tempo de atividade da API do WordPress durante picos de tráfego. Se muitos clientes enviarem solicitações simultaneamente, o banco de dados poderá não ser capaz de lidar com elas, causando tempo de inatividade.<\/p>![\"\"](\"https:\/\/blog.hostinger.io\/pt-tutoriais\/wp-content\/uploads\/sites\/26\/2022\/12\/WordPress-Cheat-Sheet-BR-1024x283.png\")
<\/a><\/figure>O Que é a API REST do WordPress?<\/h2>\n
Como Funciona a API REST do WordPress<\/strong><\/h3>
http:\/\/seudominio.com\/wp-json\/wp\/v2\/pages<\/pre>
\n
Como Configurar seu Ambiente Para a API REST do WordPress<\/strong><\/h2>
http:\/\/seudominio.com\/wp-json\/<\/pre>
![\"lista](\"https:\/\/blog.hostinger.io\/br-tutoriais\/wp-content\/uploads\/sites\/53\/2017\/11\/list-of-endpoints-in-wp-json-file.png\")
<\/figure>Dica<\/h4>\n
![\"\"](\"https:\/\/blog.hostinger.io\/pt-tutoriais\/wp-content\/uploads\/sites\/26\/2024\/06\/BR-New-WP_in-text-banner.png\")
<\/a><\/figure><\/div>curl -X GET --user nomedeusuario:senha -i http:\/\/seudominio.com\/wp-json\/wp\/v2\/posts?status=draft<\/pre>
![\"recuperando](\"https:\/\/blog.hostinger.io\/br-tutoriais\/wp-content\/uploads\/sites\/53\/2017\/11\/api-rest-wordpress-1024x503.png\")
<\/figure><\/div>Como Usar a API REST do WordPress<\/strong><\/h2>
1. Obtenha Dados com Solicitações GET<\/strong><\/h3>
GET http:\/\/seudominio.com\/wp-json\/wp\/v2\/posts\/<\/pre>
![\"recuperando](\"https:\/\/blog.hostinger.io\/br-tutoriais\/wp-content\/uploads\/sites\/53\/2017\/11\/api-rest-wordpress-1-1024x420.png\")
<\/figure><\/div>GET http:\/\/seudominio.com\/wp-json\/wp\/v2\/pages\/<\/pre>
GET http:\/\/seudominio.com\/wp-json\/wp\/v2\/custom-post-type\/<\/pre>
GET http:\/\/seudominio.com\/wp-json\/wp\/v2\/product-page<\/pre>
\/wp-json\/wp\/v2\/posts?orderby=date&order=desc<\/pre>
\/wp-json\/wp\/v2\/posts?page=2&per_page=10<\/pre>
2. Crie Conteúdo com Solicitações POST<\/strong><\/h3>
POST http:\/\/seudominio.com\/wp-json\/wp\/v2\/posts\/<\/pre>
POST http:\/\/seudominio.com\/wp-json\/wp\/v2\/pages\/
POST http:\/\/seudominio.com\/wp-json\/wp\/v2\/custom-post-types\/<\/pre>3. Atualize e Exclua Conteúdo<\/strong><\/h3>
PUT http:\/\/seudominio.com\/wp-json\/wp\/v2\/posts\/ID<\/pre>
{
\"content\" = \"publish\"
}<\/pre>DELETE http:\/\/seudominio.com\/wp-json\/wp\/v2\/posts\/ID<\/pre>
DELETE http:\/\/seudominio.com\/wp-json\/wp\/v2\/posts\/567?force=true<\/pre>
4. Trabalhe com Endpoints Personalizados<\/strong><\/h3>
![\"editando](\"https:\/\/blog.hostinger.io\/br-tutoriais\/wp-content\/uploads\/sites\/53\/2017\/11\/editando-functions-php-1024x522.png\")
<\/figure><\/div>add_action( 'rest_api_init', function () {
register_rest_route( 'your_namespace\/v1', '\/your_endpoint\/', array(
'methods' => 'GET',
'callback' => 'your_endpoint_callback',
) );
} );<\/pre>function your_endpoint_callback( $data ) {
\/\/ Sua lógica para lidar com a solicitação como retornar uma resposta JSON
return array( 'message' => 'Seu endpoint personalizado funciona!' );
}<\/pre>add_action( 'rest_api_init', function () {
register_rest_route( 'custom\/v1', '\/form-submissions', array(
'methods' => 'GET',
'callback' => 'get_form_submissions',
) );
} );
function get_form_submissions() {
$args = array(
'post_type' => 'form_submission',
'posts_per_page' => -1,
);
$form_submissions = get_posts( $args );
$response = array();
foreach ( $form_submissions as $submission ) {
$response[] = array(
'id' => $submission->ID,
'title' => $submission->post_title,
'content' => $submission->post_content,
'author' => $submission->post_author,
'created_at' => $submission->post_date,
\/\/ Adicione mais campos conforme necessário
);
}
return $response;
}<\/pre>GET http:\/\/seudominio.com\/wp-json\/custom\/v1\/form-submissions<\/pre>
5. Selecione sua Autenticação<\/strong><\/h3>
Exemplos da API REST do WordPress<\/strong><\/h2>
Práticas Recomendadas Para Usar a API REST do WordPress<\/strong><\/h2>