{"id":53954,"date":"2022-10-20T14:06:02","date_gmt":"2022-10-20T21:06:02","guid":{"rendered":"https:\/\/dhblog.dream.press\/blog\/?p=53954"},"modified":"2025-05-26T12:59:21","modified_gmt":"2025-05-26T19:59:21","slug":"tutorial-sobre-wp-rest-api","status":"publish","type":"post","link":"https:\/\/www-dev.dreamhost.com\/blog\/pt\/tutorial-sobre-wp-rest-api\/","title":{"rendered":"Uma Introdu\u00e7\u00e3o \u00e0 API REST do WordPress"},"content":{"rendered":"\n

Quando a REST API foi finalmente adicionada ao n\u00facleo do WordPress<\/a>, foi o fim de uma longa jornada. Muitos anteciparam essa mudan\u00e7a como o maior avan\u00e7o para o WordPress na hist\u00f3ria da plataforma. No entanto, se voc\u00ea n\u00e3o est\u00e1 familiarizado com a REST API, pode estar confuso sobre o que tudo isso significa.<\/p>\n\n\n\n

Em resumo, a adi\u00e7\u00e3o da API REST do WordPress<\/a> transformou o WordPress em uma estrutura de aplica\u00e7\u00e3o totalmente caracterizada. Isso aumentou significativamente sua ‘extensibilidade’, ou sua capacidade de ser expandido com novas funcionalidades e capacidades. Al\u00e9m disso, expandiu o potencial da plataforma para se comunicar com outros sites e aplica\u00e7\u00f5es.<\/p>\n\n\n\n

Introdu\u00e7\u00e3o \u00e0s APIs REST<\/b><\/h2>\n\n\n\n

Antes de aprofundarmos na API REST do WordPress, \u00e9 importante esclarecer nossa terminologia. Este \u00e9 um assunto onde precisaremos usar muitas siglas, ent\u00e3o vamos esclarecer essas primeiro.<\/p>\n\n\n\n

Primeiramente, voc\u00ea precisar\u00e1 saber o que s\u00e3o Application Programming Interfaces (APIs)<\/a>. Em termos simples, uma API \u00e9 um meio pelo qual um sistema permite que outros sistemas se conectem aos seus dados.<\/p>\n\n\n\n

Por exemplo, quando um site adiciona um bot\u00e3o de ‘curtir’ do Facebook a uma p\u00e1gina, ele faz isso ao se conectar \u00e0 API do Facebook. Isso permite que a p\u00e1gina da web use a API para receber dados (o c\u00f3digo do bot\u00e3o de curtir) e enviar dados (a solicita\u00e7\u00e3o de curtir).<\/p>\n\n\n\n

Ent\u00e3o, o que \u00e9 especificamente uma API REST? Representational State Transfer (REST)<\/a> \u00e9 um tipo de API espec\u00edfico para servi\u00e7os web. Cont\u00e9m um conjunto padronizado de instru\u00e7\u00f5es e regras, facilitando a conex\u00e3o entre todos os servi\u00e7os ‘RESTful’.<\/p>\n\n\n\n

Em resumo, as REST APIs permitem que voc\u00ea fa\u00e7a solicita\u00e7\u00f5es a um sistema externo. Um exemplo disso \u00e9 o Twitter. Voc\u00ea pode usar sua API para solicitar um certo n\u00famero de tweets de um usu\u00e1rio espec\u00edfico. A API ent\u00e3o retornar\u00e1 os tweets com base em sua solicita\u00e7\u00e3o, que voc\u00ea pode incorporar em seu site usando HTML<\/a> e CSS<\/a>.<\/p>\n\n\n\n

Essas solicita\u00e7\u00f5es s\u00e3o realizadas usando JavaScript Object Notation (JSON)<\/a>. Esta \u00e9 uma linguagem especificamente projetada para enviar, receber e armazenar dados.<\/p>\n\n\n\n

Vamos cobrir JSON mais adiante neste artigo, mas recomendamos que voc\u00ea dedique um tempo para se familiarizar com esta linguagem antecipadamente. Isso ajudar\u00e1 a prepar\u00e1-lo para usar a API REST do WordPress e entender alguns dos conceitos sobre os quais falaremos.<\/p>\n\n\n\n

O que \u00e9 a API REST do WordPress (E Por Que \u00e9 Importante)<\/b><\/h2>\n\n\n
\n
\"WordPress<\/figure><\/div>\n\n\n

A API REST do WordPress<\/a> funciona de maneira muito semelhante aos exemplos que j\u00e1 abordamos. Basicamente, a API REST do WordPress oferece acesso total \u00e0s funcionalidades do WordPress a partir de qualquer framework compat\u00edvel com JSON.<\/p>\n\n\n\n

De maneira semelhante a como a API do Twitter permite que voc\u00ea recupere e envie tweets, a API REST do WordPress pode ser usada para gerenciar posts, usu\u00e1rios, categorias e muito mais a partir de plataformas externas. Ela permite que voc\u00ea use o WordPress de v\u00e1rias maneiras anteriormente in\u00e9ditas.<\/p>\n\n\n\n

A REST API foi anunciada<\/a> l\u00e1 em 2013. Inicialmente como um plugin<\/a>, era para ser incorporada ao n\u00facleo do WordPress na Vers\u00e3o 4.1. Como muitas vezes acontece, atrasos adiaram o lan\u00e7amento at\u00e9 que finalmente foi implementada no n\u00facleo com o lan\u00e7amento do WordPress 4.7<\/a> tr\u00eas anos depois.<\/p>\n\n\n\n

Esta foi uma longa mas compensadora espera para muitas pessoas que viam a API REST do WordPress como um passo importante para a plataforma. Voc\u00ea pode estar se perguntando por que essa adi\u00e7\u00e3o foi t\u00e3o importante, especialmente porque muitos usu\u00e1rios provavelmente n\u00e3o notaram muita diferen\u00e7a. Como se v\u00ea, a inclus\u00e3o da API REST foi uma mudan\u00e7a fundamental para o WordPress por muitas raz\u00f5es.<\/p>\n\n\n\n

Ao implementar uma API REST, o WordPress deixou de ser simplesmente uma plataforma para cria\u00e7\u00e3o de sites. Agora, ele se tornou um framework de aplica\u00e7\u00e3o completo. Isso significa que os desenvolvedores podem usar um site WordPress para criar aplica\u00e7\u00f5es para dispositivos m\u00f3veis e para a web, ou como um reposit\u00f3rio de informa\u00e7\u00f5es.<\/p>\n\n\n\n

Esta mudan\u00e7a tamb\u00e9m permitiu que o WordPress se distanciasse de sua depend\u00eancia do PHP<\/a>. Ao tornar o WordPress compat\u00edvel com qualquer linguagem compat\u00edvel com JSON, a API REST ampliou muito as possibilidades para os desenvolvedores, permitindo que eles usassem a funcionalidade do WordPress com praticamente qualquer framework.<\/p>\n\n\n\n

Finalmente, a REST API oferece maior flexibilidade com as interfaces que voc\u00ea pode usar para trabalhar com a plataforma. Ela tornou a interface de administra\u00e7\u00e3o completamente opcional, pois agora voc\u00ea pode interagir com seu site WordPress inteiramente atrav\u00e9s de comandos JSON.<\/p>\n\n\n\n

Agora, vamos ver como o JSON e a REST API se unem para tornar isso poss\u00edvel.<\/p>\n\n\n\n

Como a REST API e o JSON Trabalham Juntos<\/b><\/h2>\n\n\n\n

A esta altura, voc\u00ea j\u00e1 deve ter compreendido os aspectos te\u00f3ricos da REST API do WordPress. Ent\u00e3o, vamos olhar para o lado mais pr\u00e1tico da tecnologia. O manual oficial<\/a> descreve o uso da REST API da seguinte forma:<\/p>\n\n\n\n

\u201cA API REST do WordPress fornece pontos de extremidade de API para tipos de dados do WordPress que permitem aos desenvolvedores interagir com sites remotamente, enviando e recebendo objetos JSON (JavaScript Object Notation).\u201d<\/p>\n\n\n\n

A primeira palavra na qual precisamos focar aqui \u00e9 \u201cendpoints\u201d. A maneira mais f\u00e1cil de pensar em um endpoint \u00e9 como um peda\u00e7o de dados ou uma fun\u00e7\u00e3o que pode ser chamada usando uma solicita\u00e7\u00e3o JSON<\/a>. Por padr\u00e3o, o WordPress fornece um grande n\u00famero de endpoints padr\u00e3o<\/a> para usar, mas os desenvolvedores tamb\u00e9m podem criar endpoints personalizados<\/a>.<\/p>\n\n\n\n

Para alcan\u00e7ar um ponto final, voc\u00ea deve usar uma ‘rota’,<\/a> que assume a forma de uma URL normal. Voc\u00ea pode at\u00e9 mesmo tentar isso agora mesmo.<\/p>\n\n\n\n

V\u00e1 para o seu pr\u00f3prio site WordPress e adicione \/wp-json\/wp\/v2<\/i> ao final do seu URL. Se o seu site for http:\/\/example.com<\/i>, voc\u00ea dever\u00e1 inserir http:\/\/example.com\/wp-json\/wp\/v2<\/i>.<\/p>\n\n\n\n

Quando voc\u00ea carrega esta rota, voc\u00ea chegar\u00e1 ao endpoint, que neste caso, retorna todo o conte\u00fado e meta-dados para seu site em um formato JSON (desorganizado). Ao usar diferentes rotas, voc\u00ea pode acessar diferentes endpoints para obter tipos espec\u00edficos de informa\u00e7\u00f5es e realizar v\u00e1rias tarefas.<\/p>\n\n\n\n

Existem tr\u00eas principais solicita\u00e7\u00f5es JSON<\/a> que voc\u00ea usar\u00e1 com a API REST, ent\u00e3o vamos tamb\u00e9m dar uma olhada r\u00e1pida nelas agora. S\u00e3o:<\/p>\n\n\n\n