TL; versión DR

En una de las publicaciones anteriores, discutimos, brevemente, cómo es usar la API de GitHub v3. Esta versión está diseñada para interconectarse como cualquier otra API REST. Hay puntos finales para cada recurso a los que necesita acceder y / o modificar. Hay puntos finales para cada usuario, cada organización, cada repositorio, etc. Por ejemplo, cada usuario tiene su punto final de API en https: // api.github.com / users / puede intentar sustituir su nombre de usuario en lugar de e ingrese la URL en un navegador para ver con qué responde la API.

GitHub API v4, por otro lado, usa GraphQL donde QL significa Query Language. GraphQL es una nueva forma de diseñar sus API. Al igual que hay muchos servicios web que se ofrecen como API REST, no solo los que ofrece GitHub, existen muchos servicios web que le permiten interactuar con ellos a través de GraphQL.

La diferencia más marcada que notará entre GraphQL y la API REST es que GraphQL puede funcionar desde un único punto final de la API. En el caso de GitHub API v4, este punto final es https: // api.github.com / graphql y eso es todo. No tiene que preocuparse por agregar cadenas largas al final de un URI raíz o proporcionar un parámetro de cadena de consulta para obtener información adicional. Simplemente envíe un argumento similar a JSON a esta API, solicitando solo las cosas que necesita, y obtendrá una carga útil JSON con la misma información exacta que solicitó. No tiene que lidiar con el filtrado de información no deseada o sufrir una sobrecarga de rendimiento debido a las grandes respuestas.

¿Qué es la API REST??

Bueno, REST significa Transferencia de estado representacional y API significa Interfaz de programación de aplicaciones. Una API REST, o una API 'RESTful', se ha convertido en la filosofía de diseño central detrás de la mayoría de las aplicaciones cliente-servidor modernas. La idea surge de la necesidad de segregar varios componentes de una aplicación, como la IU del lado del cliente y la lógica del lado del servidor.

Entonces, la sesión entre un cliente y un servidor generalmente no tiene estado. Una vez que se cargan la página web y los scripts relacionados, puede continuar interactuando con ellos y cuando realiza una acción (como presionar un botón de enviar), se envía una solicitud de envío junto con toda la información contextual que el servidor web necesita para procesar esa solicitud ( como nombre de usuario, tokens, etc.). La aplicación pasa de un estado a otro pero sin una necesidad constante de conexión entre el cliente y el servidor.

REST define un conjunto de restricciones entre el cliente y el servidor, y la comunicación solo puede ocurrir bajo esas restricciones. Por ejemplo, REST sobre HTTP generalmente usa el modelo CRUD, que significa Crear, Leer, Actualizar y Eliminar y los métodos HTTP como POST, GET, PUT y DELETE lo ayudan a realizar esas operaciones y solo esas operaciones. Las viejas técnicas de intrusión como las inyecciones de SQL no son una posibilidad con algo como una API REST estrictamente escrita (aunque REST no es una panacea de seguridad).

También ayuda bastante a los desarrolladores de UI! Dado que todo lo que recibe de una solicitud HTTP es un flujo de texto típico (formateado como JSON, a veces), puede implementar fácilmente una página web para navegadores o una aplicación (en su idioma preferido) sin preocuparse por la arquitectura del lado del servidor. Usted lee la documentación de la API para servicios como Reddit, Twitter o Facebook y puede escribir extensiones para ellos o clientes de terceros en el idioma que elija, ya que tiene la garantía de que el comportamiento de la API seguirá siendo el mismo.

Por el contrario, al servidor no le importa si el front-end está escrito en Go, Ruby o Python. Ya sea un navegador, una aplicación o una CLI. Simplemente 've' la solicitud y responde apropiadamente.

Que es GraphQL?

Al igual que con cualquier cosa en el mundo de las computadoras, las API REST se hicieron más grandes y complejas y, al mismo tiempo, la gente quería implementarlas y consumirlas de una manera más rápida y sencilla. Es por eso que a Facebook se le ocurrió la idea de GraphQL, y luego lo abrió. QL en GraphQL son las siglas de Query Language.

GraphQL permite a los clientes realizar solicitudes API muy específicas, en lugar de realizar llamadas API rígidas con parámetros y respuestas predefinidos. Es mucho más sencillo porque entonces el servidor responde exactamente con los datos que le pediste, sin ningún exceso.

Eche un vistazo a esta solicitud REST y su respuesta correspondiente. Esta solicitud está destinada a ver solo la biografía pública de un usuario.