blog
Fundamentos

O que é uma API? Explicação simples para vibecoders

APIs são a ponte entre frontend e backend. Entenda como funcionam sem precisar de diploma em computação.

hidden: true

O que é uma API?

API (Application Programming Interface) é uma forma de dois programas conversarem entre si. Quando seu frontend precisa de dados do banco, ele faz uma chamada à API.

Analogia simples

Pense em um restaurante:

  • Frontend = o cliente (faz o pedido)
  • API = o garçom (leva o pedido e traz a comida)
  • Backend/Banco = a cozinha (prepara o pedido)

O cliente nunca entra na cozinha. Ele fala com o garçom.

Na prática

// Frontend pede dados
const response = await fetch("https://api.meuapp.com/users");
const users = await response.json();
// Backend responde
app.get("/users", async (req, res) => {
  const users = await db.user.findMany();
  res.json(users);
});

Tipos de API

REST (mais comum)

  • GET = buscar dados
  • POST = criar dados
  • PUT = atualizar dados
  • DELETE = deletar dados
GET    /api/users       → Lista todos os usuários
GET    /api/users/123   → Busca usuário 123
POST   /api/users       → Cria um novo usuário
DELETE /api/users/123   → Deleta usuário 123

GraphQL

Uma query flexível onde o frontend pede exatamente o que precisa.

Frameworks para criar APIs

Framework Linguagem Dificuldade
Next.js API Routes JavaScript Fácil
Hono JavaScript Fácil
Express JavaScript Médio
Fastify JavaScript Médio

Todos funcionam na Veloz sem configuração extra.