Aula 43 — Consumindo APIs REST

Na aula anterior, aprendemos a usar a Fetch API para fazer requisições HTTP e buscar dados reais de uma API.

Agora vamos dar um passo além: entender como APIs REST funcionam e como consumi-las corretamente no dia a dia.

🎯 Objetivo da aula

Ao final desta aula, você será capaz de:

• Entender o que é uma API REST
• Conhecer os principais métodos HTTP
• Consumir dados usando GET
• Enviar dados usando POST
• Ler e interpretar respostas da API

O que significa REST?

REST significa Representational State Transfer.

Na prática, uma API REST segue um conjunto de boas práticas para organizar a comunicação entre sistemas.

Ela define:

• Como os dados são acessados
• Quais URLs representam recursos
• Como cada ação deve ser feita

Recursos e URLs

Em uma API REST, tudo gira em torno de recursos.

Exemplo:

• /usuarios → coleção de usuários
• /usuarios/1 → usuário específico
• /posts → coleção de posts

A URL representa o que você quer acessar.

Métodos HTTP (os verbos da API)

Os métodos HTTP indicam qual ação você quer realizar.

• GET → buscar dados
• POST → enviar dados
• PUT → atualizar dados
• DELETE → remover dados

Nesta aula, vamos focar nos dois mais comuns: GET e POST.

Consumindo uma API REST com GET

Vamos buscar uma lista de usuários usando uma API pública:

 
        async 
        function buscarUsuarios() 
        { 
          const response = await fetch("https://jsonplaceholder.typicode.com/users"); 
          const usuarios = await response.json();
          console.log(usuarios);
        }
        buscarUsuarios();

 console.log(usuarios); // Saída será um array com vários usuários 

Aqui estamos apenas consumindo dados, sem alterar nada no servidor.

Consumindo um recurso específico

Agora vamos buscar apenas um usuário:

 
  async 
  function buscarUsuario(id) 
  { 
    const response = await fetch( "https://jsonplaceholder.typicode.com/users/" + id ); 
    const usuario = await response.json();
    console.log(usuario.name);
  }
  buscarUsuario(1);

 console.log(usuario.name); // Saída será algo como "Leanne Graham" 

Enviando dados com POST

Agora vamos simular o envio de dados para a API usando POST.

Mesmo que a API de exemplo não salve de verdade, o processo é o mesmo.

 
  async function criarPost() 
  { 
    const response = await fetch( "https://jsonplaceholder.typicode.com/posts", 
    { 
      method: "POST", headers: 
      { 
        "Content-Type": "application/json" 
      }, 
      body: JSON.stringify({ title: "Meu primeiro post", body: "Conteúdo do post", userId: 1 }) 
    } );
      const resultado = await response.json();
      console.log(resultado);
  }
  criarPost();

 console.log(resultado); // Saída será o objeto criado com um id gerado 

O papel do JSON nas APIs REST

Perceba que:

• Enviamos dados em JSON
• Recebemos dados em JSON
• Usamos JSON.stringify para enviar
• Usamos response.json() para ler

Na próxima aula, vamos entender o JSON a fundo.

Na próxima aula, vamos aprender a trabalhar com JSON e entender exatamente como ele funciona.