Uma introdução à API REST do WordPress

Publicados: 2017-01-13

O lançamento do WordPress 4.7 gerou muito entusiasmo na comunidade, e com razão. Além das muitas melhorias e recursos introduzidos, o verdadeiro ladrão de show foi o anúncio de integração do núcleo da API REST. Como mencionamos em posts anteriores, isso efetivamente transforma o WordPress de uma plataforma de blog para um Sistema de Gerenciamento de Conteúdo (CMS). Mas como será essa transformação? E quais serão os benefícios para os usuários?

Neste artigo, primeiro apresentaremos alguns conceitos fundamentais e, em seguida, mostraremos como você pode começar a brincar com a API e seu site.

Todos os sites de nossos clientes já foram atualizados para WordPress 4.7.1. Então vamos começar!

O que é uma API?

API significa Interface de Programação de Aplicativos . É um conjunto de estruturas documentadas em conformidade com um funcionamento padrão como blocos LEGO para desenvolvedores de software. Essas estruturas podem ser estruturas de dados, chamadas de função, componentes de nível superior, praticamente qualquer coisa. Os desenvolvedores de software usam APIs para construir softwares mais complexos a partir deles. Eles são frequentemente usados como um método de comunicação entre vários componentes de software, sejam eles hospedados localmente (pense em bibliotecas de software) ou remotamente na Internet, como é o caso das APIs REST.

Existem APIs para muitos níveis diferentes de software, desde o sistema operacional até a web.

O que é uma API REST?

REST significa REpresentational State Transfer e permite a mesma interoperabilidade e comunicação de componentes, mas em um nível mais alto: a Web. Com REST, você pode ter diversos softwares baseados na web escritos em Python, Java ou PHP, comunicando e trocando dados entre si, mesmo que estejam hospedados em sistemas diferentes. Como cada sistema sabe “falar” REST, pode falar com todos que o fazem!

REST usa o protocolo HTTP como transporte de comunicação e as requisições HTTP padrão para implementar suas operações básicas. Essas operações são chamadas de verbos. Os mais usados são: PUT, GET, PATCH, DELETE. Esses verbos atuam nas coisas que o REST chama de Recursos. Eles são implementados pelo desenvolvedor de software e implementam efetivamente todas as quatro operações fundamentais do computador que funcionam no armazenamento: Criar, Ler, Atualizar, Excluir ( CRUD ).

Para representação e troca de dados, o REST usa uma especificação de dados leve chamada JSON ( Javascript Object Notation ). A estrutura do JSON é muito simples. Sua simplicidade e facilidade de uso, comparadas às especificações de mil páginas de XML et al, renderam a adoção imediata pelos desenvolvedores, tornando-o o padrão de intercâmbio de dados de fato da Web.

Como o WordPress o implementa?

Então temos o conceito de verbos (Criar, Ler, Atualizar, Deletar) atuando nos Recursos. O WordPress define como um recurso REST praticamente todos os itens discretos de informação que existem na plataforma. Dos usuários de um site a configurações, postagens, taxonomias de postagens, notificações, mídia, estatísticas e tudo mais. Isso inclui as operações que podem ser definidas para esses recursos. Por exemplo, as operações definidas para comentários são as seguintes:

Obtenha uma lista de comentários recentes.
Obtenha uma lista de comentários recentes em uma postagem.
Receba um único comentário.
Editar um comentário.
Crie um comentário em uma postagem.
Crie um comentário como resposta a outro comentário.
Excluir um comentário.
Obter os gostos para um comentário.
Como um comentário.
Remova sua curtida de um comentário.
Obtenha seu status de curtida para um comentário.

Dê uma olhada na página de documentação oficial da API para WordPress à vontade, para ter uma ideia da amplitude e profundidade da API e verificar o que ela pode fazer. As possibilidades são tantas!

O WordPress, assim, torna-se uma plataforma de desenvolvimento e um CMS tratando cada bit de dados que existe nele como um recurso REST . Ele expõe todos eles em uma API pública e padronizada, permitindo que partes externas realizem operações CRUD neles . Dessa forma, o WordPress se abre e se torna interoperável com o resto do mundo do software, seja Java, Python ou Ruby; e praticamente com todas as linguagens ou sistemas que sabem se comunicar usando REST.

Experimente você mesmo

Existem várias maneiras pelas quais você pode começar a mexer na API REST do seu site. O mais fácil de usar um plug-in de teste REST no seu navegador. Existem vários, mas o mais popular é o Postman (disponível para MacOSX, Windows e Chrome).

Por exemplo, digamos que você queira recuperar um objeto JSON contendo todos os posts do nosso blog. Para fazer isso, primeiro você precisa consultar a Referência REST oficial do WordPress, a fim de descobrir a Rota Base dessa chamada de solicitação (é /wp/v2/posts ).

Tudo o que precisamos fazer agora é o seguinte:

Selecione GET no menu suspenso. Existem muitos verbos REST disponíveis como você pode ver, mas cobrir todos eles não é o escopo deste artigo.
Anexe a Rota Base ( /wp/v2/posts ) à URL raiz REST do seu site (http://www.acme_shop_2.onpressidium.com /wp-json/ ) formando a URL que você vê na tela.
Clique no botão Enviar .

Se tudo correr bem, você poderá ver a resposta JSON do seu site na guia Corpo abaixo. Você pode experimentar diferentes Rotas Base e Verbos consultando a documentação. A API REST do WordPress é algo com que nos preocuparemos em posts futuros, nos quais faremos amplo uso dela, em artigos mais orientados ao desenvolvedor.

O futuro do WordPress é brilhante!

Ao longo dos anos, o WordPress evoluiu muito e deu novas possibilidades aos usuários. Para todos, desde blogueiros individuais, jornalistas, editores até proprietários de empresas e agora para desenvolvedores de software de outras comunidades de código aberto. O WordPress continua capacitando seus usuários. Continua a ser um exemplo do que as pessoas podem alcançar quando são movidas pela mesma paixão, mas vindas de diversas origens. Sua integração da API REST ao núcleo do WordPress, não apenas abre um novo mundo de possibilidades, mas também cria um novo mundo de complexidade . É disso que trata a nossa solução de hospedagem WordPress gerenciada, essa é a nossa contribuição para a comunidade. Trata-se de capacitar você e sua empresa diária . Trata-se de lutar contra toda essa complexidade, mantendo tudo funcionando e funcionando e estando lá, quando as coisas, inevitavelmente, vão quebrar.