Pular para o conteúdo
Criação de Apps

REST ou GraphQL: como escolher o estilo de API para o seu app

Resposta rápida

REST organiza a API em endereços, um para cada recurso, e usa os verbos do HTTP. GraphQL expõe um único endereço em que o cliente descreve exatamente os campos que quer receber. Para projetos pequenos e previsíveis, REST costuma bastar; GraphQL ajuda quando várias telas pedem dados muito diferentes.

Neste artigo
  1. Como o REST funciona
  2. Como o GraphQL funciona
  3. Perguntas que ajudam a decidir
  4. Os dois podem conviver

Toda API precisa responder a uma pergunta: como o app pede dados ao servidor? REST e GraphQL são duas respostas populares. Entender a diferença evita complicar um projeto simples ou travar um projeto que cresceu.

Como o REST funciona

No REST, cada tipo de coisa tem um endereço. Por exemplo, uma loja pode ter um endereço para a lista de produtos e outro para um produto específico. O app usa os verbos do HTTP para dizer o que quer fazer:

  • GET para consultar
  • POST para criar
  • PUT ou PATCH para alterar
  • DELETE para remover

A resposta traz os campos que o servidor decidiu enviar. É simples de entender, fácil de testar e funciona bem com o cache do navegador. Se você ainda não domina a base, vale ler antes o que é API e para que serve.

Onde o REST incomoda

Dois problemas aparecem quando o app cresce. O primeiro é receber dados demais: a tela precisa só do nome e do preço, mas o servidor devolve o produto inteiro. O segundo é precisar de várias chamadas: para montar uma tela, o app consulta o pedido, depois o cliente, depois os itens, um endereço de cada vez.

Como o GraphQL funciona

No GraphQL, há em geral um único endereço. O app envia uma consulta que descreve os campos desejados, inclusive de recursos relacionados, e o servidor responde com aquele formato. Uma tela pode pedir pedido, cliente e itens em uma só chamada, recebendo só o que precisa.

O servidor define um esquema, que lista os tipos e os campos disponíveis. Isso gera documentação e ajuda ferramentas a validar consultas antes de enviar.

O que ele cobra em troca

  • O servidor fica mais complexo de montar e de manter.
  • O cache simples por endereço deixa de funcionar do mesmo jeito e exige outras estratégias.
  • Consultas muito aninhadas podem pesar no servidor se não houver limites.
  • Proteção contra abuso precisa de mais cuidado, como limitar a profundidade das consultas.

Perguntas que ajudam a decidir

  • Quantos tipos de cliente consomem a API? Site, app de celular e painel interno com necessidades diferentes favorecem GraphQL.
  • Os dados são bem previstos e as telas parecidas? REST resolve com menos esforço.
  • Quem vai manter a API? Uma equipe pequena ou iniciante ganha tempo com o que é mais simples.
  • Você usa serviços de terceiros? Muitos oferecem só REST, então você já vai lidar com ele de qualquer forma.

Os dois podem conviver

Não é preciso escolher para sempre. Alguns sistemas mantêm uma API REST para integrações simples e adicionam uma camada GraphQL para o app principal. O importante é documentar, validar a entrada e controlar quem pode acessar cada dado, seja qual for o estilo.

  • API
  • GraphQL
  • REST
  • Desenvolvimento

Perguntas frequentes

GraphQL substitui o REST?

Não. São dois estilos que convivem, e muitos sistemas usam os dois. Um não é versão nova do outro.

Iniciante deve começar por qual?

Normalmente por REST, porque há mais material, ferramentas simples e o comportamento é fácil de testar no navegador ou em um cliente de API.

Leia também

Criação de Apps

O que é API e para que serve, explicado sem complicação

A ideia por trás das APIs com exemplos do dia a dia, termos explicados e um primeiro teste prático.

· 5 min de leitura
Criação de Apps

Code review: como revisar código com pull request sem atrasar o time

Revisar código em pull request é menos sobre achar culpados e mais sobre evitar erros antes de publicar.

· 3 min de leitura
Criação de Apps

Validação de formulários: como checar dados em apps e sites

Validar dados no front melhora a experiência; validar no servidor protege o sistema.

· 2 min de leitura
Criação de Apps

Paginação em APIs: como devolver listas grandes sem travar o app

Devolver mil registros de uma vez deixa o app lento. A paginação entrega só o necessário a cada pedido.

· 2 min de leitura

Deixe seu comentário