Quando você escolheria GraphQL em vez de REST, e quando não?

Question

IT Interview Practice · Accepted Answer

Escolha com base em **quem consome a API e quão variadas são suas necessidades de dados** — não no hype. O GraphQL ganha quando muitos clientes diversos precisam moldar seus próprios dados; o REST ganha quando as requisições são uniformes, cacheáveis e simples.

## Escolha GraphQL quando

- **Muitos clientes com necessidades diferentes** — web, iOS e Android querem campos diferentes das mesmas entidades. O GraphQL elimina o over/under-fetching, então você não precisa lançar um novo endpoint por tela.
- **Dados profundamente relacionados/em forma de grafo** — uma consulta atravessa relacionamentos (`user -> posts -> comments`) em vez de N idas e voltas REST.
- **Iteração rápida de produto** — a evolução aditiva do schema permite que os times de frontend adicionem campos sem esperar por novos endpoints ou versões do backend.
- **Agregação de microsserviços** — um gateway federado apresenta um único grafo sobre muitos serviços (um padrão BFF).

## Escolha REST quando

- **Recursos simples e uniformes** com acesso previsível — CRUD onde todo cliente quer o mesmo formato.
- **Cache HTTP / CDN importam mais** — o modelo URL + `GET` do REST faz cache trivialmente em todas as camadas; o GraphQL precisa de persisted queries para chegar perto.
- **Uploads/downloads de arquivos, binário ou APIs públicas** onde amplo ferramental, status codes e simplicidade vencem.
- **Time pequeno / baixa complexidade** — o custo do GraphQL no lado do servidor (resolvers, controle de N+1, limites de custo de consulta, ferramental de schema) não vale a pena para um punhado de endpoints.

## A tabela honesta de trade-offs

| Preocupação | GraphQL | REST |
|---|---|---|
| Over/under-fetching | Resolvido por design | Problema comum |
| Cache HTTP/CDN | Difícil (exige trabalho) | Nativo e fácil |
| Controle de custo de consulta/DoS | Você precisa adicionar | Naturalmente limitado |
| Flexibilidade do cliente | Alta | Baixa |
| Complexidade do servidor | Maior | Menor |

Eles também não são excludentes — muitos sistemas expõem REST para endpoints públicos/cacheáveis e GraphQL para clientes internos ricos.

## Por que isso importa

Entrevistadores sênior estão testando **julgamento, não lealdade**. A resposta forte nomeia os eixos — diversidade de clientes, necessidades de cache, maturidade do time, superfície de DoS — e admite os custos reais do GraphQL (cache e controle de custo de consulta) em vez de vendê-lo como universalmente melhor.

Preocupação	GraphQL	REST
Over/under-fetching	Resolvido por design	Problema comum
Cache HTTP/CDN	Difícil (exige trabalho)	Nativo e fácil
Controle de custo de consulta/DoS	Você precisa adicionar	Naturalmente limitado
Flexibilidade do cliente	Alta	Baixa
Complexidade do servidor	Maior	Menor

Escolha GraphQL quando

Escolha REST quando

A tabela honesta de trade-offs

Por que isso importa

Perguntas relacionadas