O que é uma API REST? Entenda em 5 minutos com exemplos do dia a dia

#braziliandevs #tutorial #webdev #api

Um guia visual e sem complicação para quem está começando agora na programação

Se você está começando a programar, já deve ter ouvido a palavra "API" umas mil vezes — em vídeos, vagas de emprego, documentações. E provavelmente pensou: "ok, mas o que isso significa, na prática?"

Neste artigo vou te explicar o que é uma API REST usando exemplos do mundo real, sem termos técnicos desnecessários. No final, você vai entender o conceito que está por trás de praticamente todo aplicativo que você usa todo dia.

A analogia do garçom

Imagine que você está em um restaurante. Você não vai até a cozinha pegar sua comida, certo? Você fala com o garçom, que leva seu pedido pra cozinha e traz a comida de volta pra mesa.

Uma API funciona exatamente assim. Ela é o garçom entre dois sistemas:

Você (ou um aplicativo) faz um pedido
A API leva esse pedido pra um servidor (a "cozinha")
O servidor processa o pedido e devolve uma resposta
A API entrega a resposta de volta pra você

Toda vez que o app do iFood mostra restaurantes perto de você, ele está fazendo isso através de uma API. Toda vez que o Instagram carrega o feed, é uma API que entrega os posts. Quando você paga com Pix, três ou quatro APIs conversam entre si nos bastidores.

O que significa "REST"?

REST é um conjunto de regras sobre como essa "conversa" entre sistemas deve acontecer. Pense nisso como o protocolo de etiqueta do garçom: ele sempre vai te perguntar de uma certa forma, anotar de um certo jeito, e trazer a resposta seguindo um padrão.

As principais regras do REST são:

Tudo é um recurso. Um usuário, um produto, uma foto — cada coisa tem um endereço próprio
A conversa é sem memória. Cada pedido é independente, o servidor não "lembra" do pedido anterior
Usa os métodos do HTTP. Aqueles verbos: GET, POST, PUT, DELETE

Os 4 verbos que você precisa conhecer

Esses são os "tipos de pedido" que você pode fazer pra uma API REST:

Verbo	O que faz	Exemplo
`GET`	Buscar informação	"Me mostra os meus posts"
`POST`	Criar algo novo	"Cria um post novo"
`PUT`	Atualizar algo existente	"Muda o título desse post"
`DELETE`	Apagar algo	"Apaga esse post"

Um exemplo prático

Vamos supor que existe uma API de uma rede social fictícia. Pra buscar todos os posts de um usuário, você faria uma requisição assim:

GET https://api.redesocial.com/usuarios/123/posts

Lendo da esquerda pra direita:

GET — quero buscar informação
https://api.redesocial.com — endereço da API
/usuarios/123/posts — quero os posts do usuário de ID 123

A API responderia algo parecido com isso (em formato JSON, que é o jeito mais comum de organizar dados na web):


json
[
  {
    "id": 1,
    "titulo": "Meu primeiro post",
    "data": "2026-05-15"
  },
  {
    "id": 2,
    "titulo": "Aprendendo APIs",
    "data": "2026-05-20"
  }
]
Pronto. Isso é uma resposta de API REST. Seu aplicativo recebe esses dados e mostra na tela como uma lista de posts.

Como testar uma API de verdade (sem programar)
Você pode testar APIs públicas direto do navegador. Tente abrir esse link agora:


https://api.github.com/users/torvalds
Você vai ver os dados do perfil do Linus Torvalds (criador do Linux) no GitHub. Isso é uma resposta de API REST em formato JSON.

Outras APIs públicas que valem a pena explorar:

PokeAPI — dados de Pokémon (https://pokeapi.github.io/)
ViaCEP — consulta de CEP brasileiro (https://viacep.com.br/)
JSONPlaceholder — API fake pra testes (https://jsonplaceholder.typicode.com/)
Próximos passos
Agora que você entendeu o conceito, sugiro:

Testar a ViaCEP abrindo https://viacep.com.br/ws/01310100/json/ no navegador
Estudar JSON — é o formato em que as APIs respondem
Aprender sobre fetch (JavaScript) ou a biblioteca requests (Python) — são as ferramentas pra fazer chamadas de API em código
Conclusão
API REST não é um bicho de sete cabeças. É só uma forma padronizada de dois sistemas conversarem pela internet. Toda vez que você usa qualquer aplicativo moderno, dezenas de APIs estão trabalhando nos bastidores pra que ele funcione.

Se esse conteúdo te ajudou, deixa um ❤️ aí embaixo. E se quiser que eu escreva sobre algum outro conceito de programação explicado de forma simples, comenta o tema!