Você pode ter ouvido falar sobre a API REST JSON do WordPress. Esta é uma grande notícia para os usuários do WordPress e motivo de comemoração!

JSON, REST, API – no entanto, isso é muito jargão para um nome, então vamos detalhar tudo.

O que é uma API?

API significa “interface de programação de aplicativos”, que é um conjunto de instruções e padrões de programação para acessar um aplicativo de software baseado na web ou uma ferramenta da web. Imagine o “software um” que está dando instruções ao “software dois”. Uma API é um acordo entre os dois e as linhas de comunicação são abertas. Basicamente, o que eles dizem um para o outro é algo como “quando você me der uma instrução, eu executarei a ação ou retornarei a informação correta”.

À medida que pesquisamos na web e usamos várias soluções de software, estamos acostumados a interfaces de usuário com layouts, botões e gráficos específicos com os quais interagimos para concluir nossas tarefas desejadas. Tudo isso é inútil para uma máquina porque tudo o que importa são os dados e o que eles precisam fazer e como eles interagem com eles. Uma API é a alternativa do software à “interface do usuário”, dando instruções a um segundo software sobre como obter dados e outras tarefas específicas. Eles são completamente invisíveis para os usuários que estão usando o aplicativo da Web e são simplesmente uma interface de software para software.

Exemplos de API

Ter acesso a uma API é incrível quando você está desenvolvendo aplicativos da web. Quando uma API é lançada ao público, significa que os desenvolvedores criaram soluções que são alimentadas pelo serviço do software. Muitas vezes, tiram a necessidade de reinventar a roda para muitas tarefas, pois já foram criadas.

Um ótimo exemplo de API é a Amazon. A Amazon lançou sua API para que os desenvolvedores possam ter acesso fácil aos produtos e suas informações. Ter acesso a isso facilita a postagem de links de produtos na amazon, com preços atualizados e opção de compra.

Outro exemplo de interação de APIs seria a compra de ingressos para shows. Para comprar ingressos oficialmente, você precisa inserir as informações do seu cartão de crédito. Uma API é usada para enviar as informações do cartão de crédito para um aplicativo remoto, que verifica se as informações do cartão de crédito estão corretas. Depois que tudo for confirmado, o aplicativo remoto envia uma resposta de volta ao site de ingressos dizendo que não há problema em prosseguir, e nesse ponto você comprou os ingressos com sucesso. Quando tudo isso está acontecendo, você vê apenas uma interface, que é o site de ingressos. É um processo contínuo; nos bastidores, muitos aplicativos estão trabalhando juntos usando APIs, mas você, como usuário, não percebe quando as tarefas são passadas de um aplicativo para outro.

API e WordPress

A Amazon e as compras de ingressos são ótimos exemplos de como as APIs funcionam juntas, mas como isso se aplica ao WordPress?
Bem, todas as mesmas idéias se aplicam. Com a API do WordPress, você pode enviar e extrair dados do WordPress.

A API é uma ferramenta importante que os desenvolvedores podem usar para compartilhar facilmente dados de seu site WordPress para outros sites ou aplicativos. Especificamente, essa API permite que você execute ações de create , read , update e delete (CRUD) no conteúdo do WordPress. Alguns exemplos dos tipos de conteúdo são:

• Postagens
• Tipos de postagem personalizados
• Páginas
• Taxonomias
• Comercial
• meios de comunicação

O que significa RESTO?

Não há cochilo ou ronco aqui, mas REST se refere ao estilo arquitetônico de uma API. REST significa Transferência de Estado Representacional. Lembra como mencionamos que uma API fornece as especificações para comunicação para que os programas possam se comunicar uns com os outros? As APIs REST são projetadas de forma a fornecer um método de comunicação leve, que economiza largura de banda. A API REST JSON do WordPress faz exatamente isso, tornando-se uma ótima opção quando há um grande volume de dados.

Acabamos de arranhar a superfície do REST; se você quiser saber mais, confira este tutorial útil REST.

Formato JSON

Para acessar os dados, precisamos de uma fonte para extrair. É aí que entra o JSON. JSON significa JavaScript Object Notation. JSON é fácil para humanos e máquinas lerem e entenderem. É a maneira perfeita de armazenar informações de maneira organizada e de fácil acesso. Como o JSON é tão simples de acessar, isso o torna uma ótima opção para criar APIs REST e é a solução perfeita para a API REST JSON do WordPress.

Aqui está uma ideia básica de como é o formato JSON:

{"employees":[
	{"firstName":"Jane", "lastName":"Smith"},
	{"firstName":"Anna", "lastName":"Olsen"},
	{"firstName":"Josh", "lastName":"Jones"}
]}

Formato JSON no WordPress

O JSON não se escreve sozinho, mas não se preocupe, você não precisa criar manualmente o arquivo JSON. Existe um ótimo plugin que o cria para você. Com esta ferramenta, os dados do site estarão no formato correto, incluindo usuários, posts, páginas, taxonomias e muito mais. O plugin pode ser encontrado aqui. Além disso, há alguma documentação útil que será valiosa quando você começar.

Usando a API REST JSON

O uso da API é bastante autoexplicativo; você estará pegando os dados do seu site em formato JSON simples. E se você tiver o plugin instalado, você pode brincar vendo as postagens do seu site em forma de dados.

Recuperar ou atualizar dados é tão simples quanto enviar uma solicitação HTTP. HTTP é um protocolo de solicitação/resposta. Primeiro, você envia uma solicitação de dados e, em seguida, os dados são enviados de volta como resposta.

método GET

O método GET é usado para recuperar informações e não tem efeito sobre os dados. Basta enviar uma solicitação GET para /wp-json/wp/v2/posts . Quer pesquisar algo? Por exemplo, se você estiver pesquisando “desenvolvimento”, obterá os resultados com a solicitação GET /wp-json/wp/v2/posts?search=development .

Solicitação POST

Uma solicitação POST é usada para enviar dados. Com os recursos da nova API, por exemplo, você pode atualizar um usuário. Digamos que você queira atualizar o usuário com o ID 10. Tudo o que você precisa fazer é enviar uma solicitação POST para /wp-json/wp/v2/users/10 .

Para experimentar isso, recomendo usar o Postman, uma extensão do Google Chrome.

Mais Javascript na mistura

Backbone.js e APIs

O Backbone.js é uma ótima maneira de trabalhar com a API porque é uma estrutura projetada para trabalhar com APIs REST. A API do WordPress inclui uma API Javascript fácil de usar baseada em modelos de Backbone. Isso permite que os desenvolvedores de plugins e temas comecem a funcionar sem esforço e conhecimento super aprofundados sobre os detalhes da conexão. Há muito mais do que isso, mas o Backbone fornece estrutura para aplicativos da Web, fornecendo modelos, coleções e visualizações, e conecta tudo à API do WordPress por meio de uma interface REST JSON.

O que tudo isso significa para os desenvolvedores do WordPress?

Com a disponibilidade da API do WordPress, novas formas de utilizá-la aumentaram e continuarão a fazê-lo à medida que ganha popularidade. A API do WordPress pode melhorar praticamente qualquer funcionalidade existente do WordPress que dependa de Javascript. Aqui estão alguns exemplos:

• validação/envio de formulário
• Temas ou plugins do Backbone.js
• rolagem infinita

Também é uma ótima maneira de mostrar conteúdo de outras fontes. Agora, é fácil exibir conteúdo de um site individual em uma configuração de vários sites. Também é possível exibir conteúdo de um site WordPress totalmente separado. Além de mostrar o conteúdo, o conteúdo também pode ser atualizado.

Agora que analisamos algumas das terminologias básicas, sabemos que JSON é a notação, REST é o estilo de arquitetura e API é a interface que eles compõem. Conhecer o básico da API e seus recursos garantirá que você tenha um bom começo ao explorar as novas possibilidades com a API do WordPress.