apresentação rest api

INICIANDO COM A REST API – UMA INTRODUÇÃO AO FUTURO DO WORDPRESS

Matheus GimenezWordPress - 3 anos

Moderador do fórum pt_BRContribuidor do Odin

brasa.art.br @deshawngamer

matheus@brasa.art.br

O que é uma REST API?

REST API é um nome usado para aplicações geradas através de conexões HTTP.Ou seja, conseguimos controlar uma aplicação (nesse caso, o WordPress) através de dados enviados via HTTP.

Usos da REST API no WordPress

Agora que definimos é uma REST API temos que entender os principais usos dela.

NOSSO NEGÓCIO É UNIR

[ IMAGEM ]

APLICAÇÕES MOBILE

NOSSO NEGÓCIO É UNIR

[ IMAGEM ]

Para fazer um painel exclusivo

NOSSO NEGÓCIO É UNIR

[ IMAGEM ]

Webapps e single page application (SPA)

E muito mais!

A REST API utiliza a formatação JSON!

As maiores linguagens de programação possuem interpretadores JSON.Então podemos utilizar em diversos dispositivos.

Instalando o Plugin REST API V2

Nessa palestra trabalharemos com a versão 2 da API.

Como ela ainda não foi adicionada ao core do WordPress, teremos que baixar o plugin...

Para baixarmos é só procurar no repositório pelo nome WordPress REST API (Version 2)

Ou baixe diretamente atráves desse link e faça upload do ZIP no painel:https://wordpress.org/plugins/rest-api/

Tipos de autenticação

A API possui 3 tipos de autenticação

Tipos de autenticação

Cookie Authentication:Essa autenticação, como o nome já diz, é por cookies do browser.

Cookie authentication somente funciona para temas e plugins em uma mesma instancia do WordPress

Tipos de autenticação

Basic Authentication:Esse tipo utiliza a autenticação padrão do protocolo HTTP.Não é indicado, já que as suas credenciais vão ser passadas em cada conexão.

Tipos de autenticação

OAuth:Autenticação OAuth é a autenticação principal usado para conexões externas. No momento, as chaves (tokens) para essa autenticação são geradas através do WP CLI (linha de comando do WordPress).

Usando API sem autenticação

Esse metodo é aconselhavel somente para testes. Não use em sites em produção.

Usaremos o plugin WP-API-CORS para isso:https://github.com/thenbrent/WP-API-CORSFaça o download do arquivo ZIP no GitHub e faça upload dele na página de plugins do painel do WordPress. Ative e vamos pra proxima!

Instalou? Agora vamos ao primeiro teste

Depois de instalado vamos fazer um Query simples com ela e ver se trás resultados.

Vá no seu browser favorito e digite o seguinte endereço:SEU_SITE/wp-json/wp/v2/posts

Temos também uma URL de testes da API online:http://demo.wp-api.org/wp-json/wp/v2/posts

A resposta será algo parecido com isso:

Mas não precisa se assustar! No próximo passo veremos como visualizar esse tipo de resposta.

Visualizando JSON atraves do browser

A maioria dos browsers possui extensões/addons para visualizar JSON.

Mas aqui colocarei um exemplo de um online:

http://json.parser.online.fr/

Melhor agora né?

Fazendo uma busca utilizando a REST API

Agora veremos como fazer um Query simples, buscando um post pelo nome.

Vou fazer esse em localhost, mas a sintaxe é a seguinte:

SEU_SITE/api/wp-json/wp/v2/posts/?filter[s]=termo_da_busca

Com o parametro filter[nome_do_filtro] nós podemos alterar o query de várias formas

Vejam a documentação:

http://wp-api.org/#posts_retrieve-posts_input

Possíveis filtros

● S

● category_name

● author_name

A REST API não é só Query

Com a REST API conseguimos ir além de só retornar posts. Nós podemos também podemos editar, adicionar novos.

Adicionar e editar postsDeletar postse etc.

brasa.art.br/blog

matheus@brasa.art.br

twitter.com/deshawngamer