TL; versão DR

Em um dos posts anteriores, discutimos, resumidamente, como é usar a API GitHub v3. Esta versão foi projetada para ter interface como qualquer outra API REST. Existem pontos de extremidade para cada recurso que você precisa acessar e / ou modificar. Existem terminais para cada usuário, cada organização, cada repositório e assim por diante. Por exemplo, cada usuário tem seu endpoint de API em https: // api.github.com / users / você pode tentar substituir o seu nome de usuário em vez de e insira o URL em um navegador para ver o que a API responde com.

A API GitHub v4, por outro lado, usa GraphQL, onde QL significa Query Language. GraphQL é uma nova maneira de projetar suas APIs. Assim como há muitos serviços da web oferecidos como APIs REST, não apenas os oferecidos pelo GitHub, existem muitos serviços da web que permitem a interface com eles via GraphQL.

A diferença mais gritante que você notará entre GraphQL e REST API é que GraphQL pode funcionar a partir de um único endpoint de API. No caso da API GitHub v4, este ponto final é https: // api.github.com / graphql e é isso. Você não precisa se preocupar em anexar strings longas no final de um URI raiz ou fornecer um parâmetro de string de consulta para informações extras. Você simplesmente envia um argumento JSON like para esta API, pedindo apenas o que você precisa, e você receberá uma carga JSON de volta com as mesmas informações que você solicitou. Você não tem que lidar com a filtragem de informações indesejadas ou sofrer sobrecarga de desempenho devido a grandes respostas.

O que é REST API?

Bem, REST significa Representational State Transfer e API significa Application Programming Interface. Uma API REST, ou API 'RESTful', tornou-se a principal filosofia de design por trás da maioria dos aplicativos cliente-servidor modernos. A ideia surge da necessidade de segregar vários componentes de um aplicativo, como a IU do lado do cliente e a lógica do lado do servidor.

Portanto, a sessão entre um cliente e um servidor é normalmente sem estado. Depois que a página da web e os scripts relacionados forem carregados, você pode continuar a interagir com eles e quando realizar uma ação (como pressionar um botão de envio), uma solicitação de envio é enviada junto com todas as informações contextuais de que o servidor da web precisa para processar essa solicitação ( como nome de usuário, tokens, etc). O aplicativo faz a transição de um estado para outro, mas sem uma necessidade constante de conexão entre o cliente e o servidor.

REST define um conjunto de restrições entre o cliente e o servidor, e a comunicação só pode acontecer sob essas restrições. Por exemplo, REST sobre HTTP geralmente usa o modelo CRUD, que significa Criar, Ler, Atualizar e Excluir e métodos HTTP como POST, GET, PUT e DELETE ajudam a realizar essas operações e essas operações sozinhas. Técnicas de intrusão antigas, como injeções de SQL, não são uma possibilidade com algo como uma API REST bem escrita (embora seja REST não é uma panacéia de segurança).

Também ajuda muito os desenvolvedores de IU! Como tudo o que você recebe de uma solicitação HTTP é um fluxo de texto típico (às vezes formatado como JSON), você pode implementar facilmente uma página da web para navegadores ou um aplicativo (no idioma de sua preferência) sem se preocupar com a arquitetura do servidor. Você lê a documentação da API para serviços como Reddit, Twitter ou Facebook e pode escrever extensões para eles ou clientes de terceiros no idioma de sua escolha, já que tem a garantia de que o comportamento da API ainda será o mesmo.

Por outro lado, o servidor não se importa se o front-end é escrito em Go, Ruby ou Python. Seja um navegador, aplicativo ou CLI. Ele apenas 'vê' a solicitação e responde apropriadamente.

O que é GraphQL?

Como tudo no mundo dos computadores, as APIs REST ficaram maiores e mais complexas e, ao mesmo tempo, as pessoas queriam implementá-las e consumi-las de maneira mais rápida e simples. É por isso que o Facebook teve a ideia do GraphQL, e mais tarde o abriu. O QL em GraphQL significa Query Language.

O GraphQL permite que os clientes façam solicitações de API muito específicas, em vez de fazer chamadas de API rígidas com parâmetros e respostas predefinidos. É muito mais simples porque o servidor então responde exatamente com os dados que você pediu, sem excesso.

Dê uma olhada nesta solicitação REST e sua resposta correspondente. Esta solicitação visa visualizar apenas a biografia pública de um usuário.