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.