Sem vencedor absoluto. O formato da API deve seguir o padrão de acesso aos dados e as restrições de cache e operação.
Resumo em uma frase
REST expõe recursos via HTTP com semântica de métodos e URLs; GraphQL expõe um grafo tipado em que o cliente pede exatamente os campos necessários.
Diferença principal
REST tende a múltiplos endpoints e versões de recurso; GraphQL concentra a query em um endpoint e desloca parte da forma da resposta para o cliente. Cache HTTP é natural em REST; em GraphQL exige estratégia explícita.
REST
- Modelo familiar, documentação por recurso, bom encaixe com CDN e proxies
- Over/under-fetching mitigados com design de recursos e BFF
- Padronização de códigos HTTP e verbos ajuda operação e segurança
GraphQL
- Schema tipado; clientes pedem só o necessário
- Útil quando há muitas telas com formatos de dados distintos
- Exige disciplina em complexidade de query, N+1 e autorização por campo
Comparação por critérios
- Cache: REST com HTTP cache/CDN; GraphQL com cache de cliente ou políticas no servidor
- Evolução: versionamento de API vs evolução de schema
- Ops: REST costuma ser mais simples de observar por URL; GraphQL por operação nomeada
Quando escolher cada um
- REST: APIs públicas, cache na borda, times acostumados a recursos HTTP
- GraphQL: clientes diversos com necessidades de campos muito diferentes, schema como contrato
Veja também gRPC vs REST e REST vs GraphQL vs gRPC.
DICA Mais em comparativos.