Sem vencedor absoluto. A melhor opção depende do seu contexto. Versões e recursos mudam; confirme detalhes na documentação oficial antes de decidir.
Resumo em uma frase
REST organiza a API em recursos e URLs simples, fáceis de cachear e entender; GraphQL deixa o cliente pedir exatamente os campos de que precisa, em um único endpoint, ao custo de mais complexidade no servidor.
Comparando
- Modelo: REST usa vários endpoints (
/usuarios/1,/usuarios/1/pedidos) e os verbos HTTP. GraphQL usa normalmente um endpoint e uma linguagem de consulta com um esquema tipado. Veja o que é API REST. - Excesso e falta de dados: em REST, uma rota pode devolver campos que o cliente não usa, ou exigir várias chamadas. Em GraphQL, o cliente descreve o que quer em uma só requisição.
- Cache: REST aproveita o cache HTTP de forma natural (navegador, CDN). Em GraphQL, requisições costumam ser
POSTe o cache exige estratégias próprias. - Versionamento: REST costuma versionar rotas (
/v2/). GraphQL evolui o esquema marcando campos como obsoletos. - Complexidade e segurança: consultas muito aninhadas podem sobrecarregar o servidor; é preciso limitar profundidade e custo e cuidar da autorização campo a campo. Em REST, o controle por rota é mais direto. Veja segurança em APIs.
- Ferramentas: GraphQL tem introspecção e tipos que ajudam na documentação e geração de código. REST tem OpenAPI e imenso suporte em qualquer linguagem.
Quando escolher cada um
- REST: APIs públicas simples, CRUD, quando cache HTTP e simplicidade importam, equipes pequenas
- GraphQL: vários clientes diferentes (web, mobile) com necessidades distintas, dados muito relacionados, interfaces que mudam rápido
Como decidir
- Liste os clientes da API e os dados que cada tela precisa
- Se uma API REST bem desenhada atende, mantenha-a: é mais simples
- Se o problema é excesso de chamadas e de dados, avalie GraphQL num escopo pequeno
Leitura relacionada
Todos os comparativos · Hub de conteúdo · Roadmap de design de APIs · curl · O que é API