O que é uma API?
Interface que define regras para que sistemas distintos consigam trocar informações através de um protocolo comum
Qual a diferença entre a interface e o protocolo comum no contexto da API?
- Interface define o que pode ser acessado e como utilizar os recursos da API
- Protocolo define como as informações serão transportadas na rede
O que significa a sigla API?
Application Programming Interface
- Application: qualquer software com funções distintas
- Interface: contrato que define como dois sistemas devem se comunicar
Qual a importância de uma API?
Permite a integração de sistemas de forma facilitada e a troca de recursos sem expor a implementação
Quais as vantagens de uma API?
Ajudam a integrar sistemas, economizar tempo de desenvolvimento, proteger informações e criar soluções rápidas
Tipos de APIS?
SOAP, REST, GraphQL, Webhooks e Websockets
O que é REST?
Estilo de arquitetura para construção de APIS, especialmente APIS webs
O que é um recurso no contexto REST?
Qualquer entidade importante que pode ser identificada e manipulada dentro do sistema, como: usuários, pedidos, transferêcias, etc
O que é uma representação no contexto REST?
É o estado que o recurso se encontra no servidor no momento da solicitação
Quais as vantagens do REST?
- Fácil de usar por ter métodos já conhecidos
- Pode enviar dados de vários jeitos
- Funciona bem em qualquer lugar (pc, celular)
- Funciona bem para muitos usuários e é rápida
Quais os princípios do REST?
- Client/Server
- Interface Uniforme
- Stateless
- Cacheabilidade
- Arquitetura de sistema em camadas
O que é a regra Client/Server?
- Separa as responsabilidades
- Client: solicita o recursos
- Server: processa a solicitação e devolve uma resposta
O que é a regra Interface Uniforme?
- Seguir padrões bem definidos de recursos
- Utilização correta dos métodos HTTP para realizar as ações
- Definição dos contratos que devem ser seguidos
O que é a regra Stateless?
- Servidor não deve guardar nenhuma informação das requisições
- Cada requisição deve conter todas as informações necessárias para serem processadas
O que é a regra Cacheabilidade?
- Quando possível, fazer o cache dos recursos
- Otimiza a solicitações e respostas
O que é a regra de Arquitetura de Sistema em Camadas?
- Cada camada é responsável por uam etapa diferente
- São separadas mas interagem entre si
O que é uma API RESTFul?
API construída aplicando todos os princípios REST
Qual a diferença entre REST e RESTFul?
- REST: regras para construir serviços webs
- RESTFul: aplicação das regras
Quais as boas práticas para construir uma API Rest?
- JSON para comunicação
- Substantivos e nomes no plural para recursos: usuarios, categorias
- Tratamento de erros e utilização correta dos status
- Hierarquia e versionamento de rotas
O que é idempotência?
Realizar diversas requisições repetidamente e produzir o mesmo resultado
O que é JSON?
Formato de dados leve usado para representar e trocar informações
Porque utilizar JSON?
É fácil de ler e fácil de ser trafegado em qualquer protocolo
Qual a diferença de JS e JSON?
- JS: linguagem
- JSON: formato de dados em texto
Quais os benefícios do JSON?
Simples e fácil de enteder, tanto por máquina, quanto por humanos. Tem suporte para diversas linguagens, facilitando o compartilhamento de dados
