🌐
WebIntermediário 10 min

O que é uma API REST

REST explicado sem jargão: recursos, verbos HTTP e por que sua aplicação fala com o backend assim.

REST é um estilo de organizar a comunicação entre frontend e backend usando HTTP. A ideia central: tudo é um recurso identificado por uma URL.

Recursos e verbos

Um recurso é uma coisa — um usuário, um post, um produto. Os verbos HTTP dizem o que fazer com ele.

http
GET    /usuarios          → lista todos
GET    /usuarios/42       → busca um
POST   /usuarios          → cria um novo
PUT    /usuarios/42       → substitui
PATCH  /usuarios/42       → atualiza parcialmente
DELETE /usuarios/42       → remove

Buscando dados no frontend

No navegador, a forma mais comum de consumir uma API REST é com fetch.

fetch.js
async function carregarUsuario(id) {
  const resp = await fetch(`/usuarios/${id}`);
  if (!resp.ok) throw new Error("Falha na requisição");
  return resp.json();
}

carregarUsuario(42)
  .then(usuario => console.log(usuario))
  .catch(erro => console.error(erro));

REST não é um protocolo, é um conjunto de convenções. Nem toda API segue todas as regras — e tudo bem. O importante é ser consistente.