O que é uma REST API? A comunicação entre o cliente e o servidor.

📽️

Se API ainda parece complicado, calma que eu te explico! Nesse vídeo aqui, eu descomplico o conceito de API com um exemplo bem simples, pra você nunca mais ficar com essa dúvida. É como eu sempre falo: entender a base é fundamental pra dominar o resto!

Como funciona a arquitetura REST?

1. Interface uniforme: cada recurso tem seu próprio URL, ou seja, uma identidade única (URI). Isso facilita o acesso e manipulação de dados, como acessar /clientes para listar clientes ou /produtos para mostrar produtos.

2. Desacoplamento entre cliente e servidor: o cliente e o servidor trabalham separados. O cliente só precisa saber o endereço da API, enquanto o servidor fica com a parte pesada – armazenando e protegendo os dados.

3. Sem estado (stateless): cada requisição feita ao servidor é independente, ou seja, o servidor não guarda informações das requisições anteriores. Toda a informação necessária é enviada em cada nova solicitação.

4. Cacheabilidade: para melhorar a eficiência, o cliente pode armazenar alguns dados temporariamente (cache), poupando o servidor de processar repetidamente as mesmas informações.

5. Sistema em camadas (layered system): entre o cliente e o servidor podem existir camadas intermediárias (como servidores de segurança ou cache), que ajudam na escalabilidade e segurança.

6. Código sob demanda (opcional): em alguns casos, o servidor pode enviar códigos executáveis (JavaScript, por exemplo) ao cliente, quando isso for necessário.

📽️

Bora entender o que é REST e como ser RESTful de verdade? Nesse vídeo, eu te mostro as "regras do jogo" da arquitetura REST, pra você entender o que faz uma API ser RESTful e como usar isso nos seus projetos. Vamos juntos, porque dominar REST é essencial pra quem quer ser Full Stack de verdade!

Explorando os verbos HTTP.

Formatando dados com JSON e XML.

{
  "id": "1",
  "nome": "Mayk Brito",
  "email": "mayk.brito@example.com"
}

Mão na massa: criando uma REST API com Express

Pré-requisitos

1. Node.js instalado: o Node.js é uma plataforma que permite rodar JavaScript fora do navegador. Você pode fazer o download e instalação no site oficial do Node.js.

2. NPM (Node Package Manager): o NPM é instalado automaticamente com o Node.js e é essencial para gerenciar pacotes e dependências do projeto.

3. Editor de código: recomendamos o Visual Studio Code, mas você pode usar qualquer editor com o qual se sinta confortável.

Passo a Passo para construir sua API REST

1. Configurando o projeto: Primeiro, abra seu terminal, crie uma pasta para o projeto e acesse-a. Em seguida, inicie o projeto com o comando:

npm init -y

Esse comando cria um arquivo package.json com as configurações básicas do projeto.

2. Instalando o Express: Com o projeto configurado, vamos instalar o Express, que será usado para gerenciar as requisições HTTP.

npm install express

3. Criando o Servidor: Agora, vamos configurar o servidor. Crie um arquivo chamado server.js e insira o seguinte código:

const express = require('express');
const app = express();
app.use(express.json());

const clientes = [
  { id: 1, nome: 'Mayk Brito', email: 'mayk.brito@example.com' },
  { id: 2, nome: 'Isabela Castilho', email: 'isabela.castilho@example.com' }
];

// Rota para obter a lista de clientes
app.get('/clientes', (req, res) => res.json(clientes));

// Rota para adicionar um novo cliente
app.post('/clientes', (req, res) => {
  const novoCliente = { id: clientes.length + 1, ...req.body };
  clientes.push(novoCliente);
  res.status(201).json(novoCliente);
});

// Inicializa o servidor na porta 3000
app.listen(3000, () => console.log('Servidor rodando na porta 3000'));

• Rota GET: a rota /clientes retorna a lista de clientes no formato JSON.
• Rota POST: a rota /clientes permite adicionar um novo cliente, enviando os dados no corpo da requisição.

4. Testando a API: Com tudo configurado, inicie o servidor com o comando:

node server.js

Agora, abra seu navegador e acesse http://localhost:3000/clientes para ver a lista de clientes. Para testar a rota POST e adicionar um novo cliente, você pode usar uma ferramenta como Insomnia ou Postman.
• No Insomnia ou Postman, crie uma nova requisição do tipo POST para http://localhost:3000/clientes, e envie um JSON com os dados do novo cliente, como:

{
  "nome": "Diego Fernandes",
  "email": "diego.fernandes@example.com"
}

• Ao enviar, o servidor responderá com o novo cliente adicionado!
📽️

Tá afim de ver na prática como integrar uma API com um front-end React? Então dá uma olhada nesse vídeo aqui, onde eu mostro como conectar uma API criada com Express a um front-end usando o React e o Vite. Bora ver como juntar o back-end com o front-end e deixar o projeto redondo!

Vantagens das REST APIs: escalabilidade e flexibilidade.

• Escalabilidade: graças ao desacoplamento entre cliente e servidor, cada parte pode evoluir separadamente, tornando fácil adicionar novas funcionalidades sem quebrar o sistema.

• Flexibilidade e independência: a REST API é independente de linguagem, então um servidor em Python pode comunicar-se facilmente com um cliente em JavaScript, PHP, ou qualquer outra linguagem.

• Eficiência e performance: ao usar cache e outras práticas, REST APIs reduzem a carga no servidor e melhoram o desempenho das aplicações.

• Fácil integração: REST APIs permitem integração de dados e serviços de terceiros com rapidez, como quando um e-commerce se conecta ao sistema de pagamento do PayPal.

Casos de uso: REST APIs em ação.

1. Aplicativos de redes sociais: aplicativos como Instagram e Twitter usam REST APIs para que desenvolvedores integrem seus sistemas e compartilhem dados com segurança.

2. Integrações com sistemas bancários: empresas utilizam APIs para conectar sistemas de folha de pagamento com bancos, gerando automação e simplificando o fluxo financeiro.

3. Aplicativos de streaming: serviços como Netflix e Spotify se conectam por REST APIs, garantindo uma experiência contínua para os usuários.

4. Rocketseat: Aqui, REST APIs desempenham um papel fundamental na plataforma de estudos, integrando diversas ferramentas para oferecer uma experiência de aprendizado completa e conectada. Graças às APIs, a Rocketseat consegue conectar o progresso dos alunos com outros serviços, facilitando o acompanhamento e a personalização dos cursos. Além disso, as APIs permitem que funcionalidades como sistema de autenticação, comentários e progressão de aulas funcionem de forma fluida e segura, proporcionando uma jornada de aprendizado sem interrupções.

Próximos passos: que tal criar sua própria REST API e mergulhar fundo no mundo da programação?

• Projetos reais e desafiadores: desenvolva portfólio e conquiste a experiência prática que o mercado valoriza.

• Aulas gravadas: aprenda no seu tempo, no seu ritmo, sem pressa.

• Tutoria personalizada: suporte para dúvidas e acompanhamento de perto, pra ninguém ficar perdido.

• Certificado reconhecido: conclusão com um certificado validado pelo mercado, que é um diferencial no currículo.

• Aprender a programar do zero: na prática e sem complicação.

• Criar seu primeiro site: mesmo sem nenhum conhecimento prévio.

• Ganhar seu certificado: 5 horas de conteúdo direto ao ponto, perfeito para quem está começando e quer validar o aprendizado.

Resumo dos principais conceitos

E como sempre, aquele abraço do Maykão!