Vamos falar de API?
API
REST
@miqueiasmedeiros
Termo Rest
REST significa Representational State
Transfer. Em Português, Transferência
de Estado Representacional. Trata-se
de um modelo de arquitetura Web.
Origem do Rest
Os Conceitos do REST foram
submetidos à tese de doutorado de Roy
Fielding (Cientista da Computação)
nos anos 2000 onde o princípio
fundamental é usar o protocolo HTTP
para comunicação de dados.
Esta arquitetura usa várias
representações de recursos para
representar seu tipo, como XML, JSON,
Texto, Imagens e assim por diante.
Vale ressaltar que o REST não se limita
a solicitações e respostas de registros.
Também é possível inserir um novo
registro ou deletar um já existente.
@miqueiasmedeiros
Requisições e Comunicação
O REST precisa que um cliente faça
uma requisição para o servidor para
enviar ou modificar dados. Um
requisição consiste em:
verbo ou método HTTP, que define que
tipo de operação o servidor vai realizar;
Um header, como o cabeçalho da
requisição que passa informações sobre
a requisição;
Um path(caminho ou rota) para o
servidor, por exemplo
[Link]/ws/01001000/json/;
Um Body(informações no corpo da
requisição) , opcional.
@miqueiasmedeiros
Métodos HTTP
Em aplicações REST, os métodos mais utilizados
são:
O método GET é o método mais comum,
geralmente é usado para solicitar que um
servidor envie um recurso;
O método POST foi projetado para enviar
dados de entrada para o servidor. Na prática,
é frequentemente usado para suportar
formulários HTML;
O método PUT edita e atualiza os dados em
um servidor;
O método DELETE que como o próprio nome
já diz, deleta certo dado ou coleção do
servidor.
Código de Respostas
200(OK), requisição atendida com sucesso;
201(CREATED), objeto ou recurso criado com
sucesso;
204(NO CONTENT), objeto ou recurso
deletado com sucesso;
400(BAD REQUEST), ocorreu algum erro na
requisição(podem existir inumeras causas);
404 (NOT FOUND), rota não encontrada;
500(INTERNAL SERVER ERROR), existe algum
erro no servidor.
@miqueiasmedeiros