GraphQL e REST: comparar necessidades, custos e permissões

Compreender o pedido e o custo

O exemplo usa um esquema fictício: customer, orders e total têm de existir na API real. Um pedido pode gerar várias leituras no servidor. REST também pode fornecer respostas adaptadas. Um único endpoint HTTP é habitual em GraphQL, mas não obrigatório em toda a arquitetura.

query RecentOrders($id: ID!) {
  customer(id: $id) {
    name
    orders(first: 5) {
      nodes { id total }
    }
  }
}

Comparar uma tarefa representativa

• Meça bytes, latência, erros e trabalho do servidor para o mesmo ecrã, permissões e volumes realistas.
• Verifique paginação, leituras agrupadas contra N+1, cache e isolamento entre contas.
• Avalie evolução do esquema, compatibilidade com clientes antigos e operação. Manter REST pode ser mais simples.

Aplicar permissões e limites

Autentique os pedidos e autorize objetos e campos na lógica de negócio. Limite listas, profundidade, aliases, operações agrupadas e custo estimado. A frequência dos pedidos não descreve toda a carga. Ocultar introspeção não substitui estes controlos; teste recusas e respostas parciais.

Fontes primárias

• GraphQL — Learn [EN]
• GraphQL — Performance [EN]
• GraphQL — Security [EN]