Introdução ao GraphQL

Esta é a parte 1 da série para GraphQL e Adobe Commerce. O GraphQL tornou-se rapidamente o padrão do setor para a forma como aplicativos avançados do lado do cliente se comunicam com um back-end. É um tópico cada vez mais relevante para desenvolvedores do Adobe Commerce, já que a plataforma continua a expandir seus recursos no domínio de implementações headless.

Se você é novo no GraphQL, esta seção o orienta para os conceitos e o uso básicos.

Vídeos e tutoriais relacionados ao GraphQL nesta série

• Parte 2 GraphQL - Consultas
• Parte 3 GraphQL - Mutações
• Parte 4 GraphQL - Esquema

O que é o GraphQL?

O GraphQL é uma especificação para uma linguagem de consulta de API exclusiva e o tempo de execução que fornece dados em resposta a essa linguagem de consulta.

As APIs da Web tradicionais, como REST, têm funcionado bem para sistemas diferentes que transmitem dados de um lado para o outro, mas fornecem menos do que o desempenho máximo para experiências modernas de link de aplicativo, como o Progressive Web Application. Em aplicativos como esse, as camadas de front-end e back-end do igual aplicativo se comuniquem por meio da API da web. A abordagem regimentada de esquemas como REST muitas vezes não fornece a flexibilidade apropriada neste contexto, onde muitos tipos de dados precisam ser buscados rapidamente.

O GraphQL permite que um cliente descreva exatamente os dados de que necessita. Em vez de exigir várias solicitações de rede para buscar vários tipos de dados, uma única solicitação pode consultar muitos tipos. E as respostas são mantidas em ordem, incluindo (em um formato que espelha intuitivamente o query) somente os tipos e campos que são solicitados.

O tempo de execução que implementa a especificação do GraphQL pode ser construído em qualquer idioma. ADOBE COMMERCE e Magento Open Source use o
graphql-php Implementação do PHP e constrói suas próprias camadas sobre ele.

Exibir a documentação completa do GraphQL

Uso de um cliente do GraphQL

Você precisa de um cliente GraphQL GUI para testar amostras de código e tutoriais. Há várias opções:

• Altair O é um cliente excelente e com todos os recursos, criado especificamente para o GraphQL. A Adobe usa Altair em vídeos de apresentação.
• Se você não quiser instalar o aplicativo de desktop, também há extensões Altair executadas diretamente em seu
  Cromo, Firefox, or Edge navegador.
• GraphiQL é uma implementação do GraphQL IDE da GraphQL Foundation. Essa não é uma ferramenta instalável, mas um pacote que você mesmo pode usar para criar a interface.
• Se você já estiver familiarizado com PostmanAlém disso, oferece suporte adequado para consultas do GraphQL, embora não seja tão completo quanto um cliente dedicado do GraphQL.

No cliente do GraphQL, você deve enviar suas solicitações para o caminho do URL /graphql no Adobe Commerce ou Magento Open Source instância. Se preferir usar uma instância existente para seus testes, use a demonstração do tema Venia (exemplo de implementação do PWA Studio): https://venia.magento.com/graphql

Recursos úteis do GraphQL

• Noções básicas do GraphQL
• Consultas
• Mutações
• Esquema