apresentação rest api
TRANSCRIPT
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
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
twitter.com/deshawngamer