3MTZ_API

Prévia do material em texto

O QUE É UM PROTOCOLO
Um protocolo são regras que definem como será feita a comunicação entre
computadores.
Isso garante com que diferentes fornecedores iram seguir as mesmas regras no
desenvolvimento de aplicações 
Sendo assim se os sistemas quiserem trocar dados através da Web deverão
utilizar o protocolo HTTP
A Voo tem a oportunidade de trabalhar com a Ciber Marinha Ltda. para criar
uma rede que alavanca o material existente de ambas as empresas.
H T T P E A P I
HTTP significa Hypertext transfer protocol, é um dos protocolos mais populares
atualmente, tenho certeza que você já ouviu falar dele. 
Podemos encontrar informações detalhadas nas especificações do protocolo
acessando o link (https://tools.ietf.org/html/rfc2616).
Este protocolo é utilizado para solicitar recursos de um servidor através de
mensagens HTTP.
PROTOCOLO HTTP
A Voo tem a oportunidade de trabalhar com a Ciber Marinha Ltda. para criar
uma rede que alavanca o material existente de ambas as empresas.
H T T P E A P I
Request (Requisição)
Response (Resposta)
O HTTP tem como base a comunicação entre cliente e servidor, ou seja, um
servidor irá fornecer um serviço e um cliente irá solicitar recursos deste serviço.
Na prática podemos utilizar o exemplo de acessar um site.
Quando acessamos https://docs.python.org/3/ através do nosso browser, estamos
enviando uma requisição e os servidores do que hospedam a documentação do
python e eles irão nos retorna uma resposta. 
Podemos então destacar dois pontos de partida para entender este protocolo.
As primeiras coisas que devemos entender sobre o protocolo HTTP é a estrutura
de mensagem os principais métodos e também o código de resposta também
conhecido como status.
FUNCIONAMENTO DO HTTP
PRINCIPAIS MÉTODOS HTTP
Para entender melhor quando é utilizado cada método HTTP, vamos ver
detalhadamente os principais.
GET
Recupera algum recurso do servidor.
Este recurso pode ser por exemplo a página de um site, a lista de usuários de
um sistema entre outros recurso.
Não deve ser usado para disparar uma ação ao servidor como veremos com
os demais métodos;
POST
Enviamos informações adicionais no corpo da mensagem (body).
Essas informações podem ser utilizadas para cadastrar um recurso (por
exemplo um usuário no sistema) ou para fazer um processamento interno, por
exemplo gerar um relatório.
O servidor é responsável por decidir o que fazer com os dados
PUT
Este método garante que um recurso existe.
Por exemplo, ao enviar o método PUT com informações no corpo da
mensagem (body), iremos procurar por um recurso com essas informações,
caso ele não exista será criado e se existir será atualizado.
A principal diferença entre POST e PUT é que o PUT lida diretamente com os
recursos, não é utilizado para fazer processamento de informações.
DELETE
Remove um recurso (por exemplo um usuário).
H T T P E A P I
PRINCIPAIS CÓDIGOS DE RETORNO
H T T P E A P I
CÓDIGO MENSAGEM
200 REQUISIÇÃO FOI RECEBIDA COM
SUCESSO
201 RECURSO CRIADO COM SUCESSO
301 REDIRECIONAMENTO, POR EXEMPLO
ACESSAMOS HTTP E É MOVIDO PARA
HTTPS
304 ESTA RESPOSTA É USADA QUANDO
RECEBEMOS UM RECURSO QUE ESTÁ
UTILIZANDO CACHE, INFORMA AO CLIENTE
QUE A MENSAGEM HTTP NÃO FOI
MODIFICADA
400 O SERVIDOR NÃO ENTENDEU A
REQUISIÇÃO.
404 O SERVIDOR NÃO ENCONTROU NENHUM
RECURSO SOLICITADO
500 O SERVIDOR ENCONTROU UMA SITUAÇÃO
INESPERADA E NÃO PODE RESPONDER A
REQUISIÇÃO
O QUE É API?
API é o acrônimo de Application Programming Interface;
Em português: Interface de Programação de Aplicativos.
H T T P E A P I
PARA QUE SERVE?
Permite a comunicação e troca de dados entre aplicações;
Fornece um caminho com regras bem definidas;
Faz o meio de campo entre aplicações.
ENDPOINTS MARATONA ZABBIX
Recuperar lista de aeroportos
http://desafiozabbix.com.br/api/airports
Recuperar lista de kiosks de um aeroporto
http://desafiozabbix.com.br/api/airports/ID/kiosks
Recuperar quantidade de checkins de um aeroporto
http://desafiozabbix.com.br/api/airports/ID/checkins/
Recuperar quantidade de embarques de um aeroporto
http://desafiozabbix.com.br/api/airports/1/boardings/
Recuperar quantidade de despachos de bagagem de um aeroporto
http://desafiozabbix.com.br/api/airports/1/baggagechecks
URLS PARA MONITORAR STATUS E TEMPO DE
RESPOSTA
Check-In - http://desafiozabbix.com.br/api/checkins
Embarque - http://desafiozabbix.com.br/api/boardings/
Despacho de bagagem - http://desafiozabbix.com.br/api/baggagechecks/
http://desafiozabbix.com.br/api/airports
http://desafiozabbix.com.br/api/airports/ID/kiosks
http://desafiozabbix.com.br/api/airports/ID/checkins/
http://desafiozabbix.com.br/api/airports/1/boardings/
http://desafiozabbix.com.br/api/airports/1/baggagechecks
http://desafiozabbix.com.br/api/checkins
http://desafiozabbix.com.br/api/boardings/
http://desafiozabbix.com.br/api/baggagechecks/