Comparación entre REST y GraphQL - AWS AppSync GraphQL

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Comparación entre REST y GraphQL

Las API (interfaces de programación de aplicaciones) desempeñan un papel crucial a la hora de facilitar el intercambio de datos entre aplicaciones. Como se indicó anteriormente, han surgido dos enfoques destacados para diseñar las API: GraphQL y REST. Si bien ambos cumplen el propósito fundamental de permitir la comunicación entre el cliente y el servidor, difieren significativamente en su implementación y casos de uso.

GraphQL y REST comparten varias características clave:

  1. Modelo cliente-servidor: ambos utilizan una arquitectura cliente-servidor para el intercambio de datos.

  2. Ausencia de estado: ninguno de los dos mantiene la información de la sesión del cliente entre las solicitudes.

  3. Basado en HTTP: ambos suelen utilizar HTTP como protocolo de comunicación subyacente.

  4. Diseño orientado a los recursos: ambos diseñan su intercambio de datos en torno a los recursos, es decir, cualquier dato u objeto al que el cliente puede acceder y manipular a través de la API.

  5. Flexibilidad de formato de datos: JSON es el formato de intercambio de datos más utilizado en ambos, aunque también se admiten otros formatos, como XML y HTML.

  6. Independencia de lenguajes y bases de datos: ambos pueden funcionar con cualquier lenguaje de programación o estructura de base de datos, lo que los hace altamente interoperables.

  7. Compatibilidad con almacenamiento en caché: ambos admiten el almacenamiento en caché, lo que permite a los clientes y servidores almacenar los datos a los que se accede con frecuencia para mejorar el rendimiento.

Si bien comparten algunos principios fundamentales, GraphQL y REST difieren significativamente en su enfoque del diseño de API y la obtención de datos:

  1. Estructura de solicitudes y obtención de datos

    REST utiliza diferentes métodos de HTTP (GET, POST, PUT, DELETE) para realizar operaciones en los recursos. Esto suele requerir varios puntos de conexión para diferentes recursos, lo que puede provocar ineficiencias en la recuperación de datos. Por ejemplo, ejecutar una operación GET para recuperar los datos de un usuario puede provocar una obtención excesiva o insuficiente de datos. Para obtener los datos correctos, se puede llamar a una operación de truncamiento o a otras varias operaciones.

    GraphQL utiliza un único punto de conexión para todas las operaciones. Se basa en consultas para obtener datos y mutaciones para modificarlos. Los clientes pueden utilizar las consultas para obtener exactamente los datos que necesitan en una sola solicitud, lo que reduce la sobrecarga de la red al minimizar la transferencia de datos.

  2. Esquema del lado del servidor

    REST no requiere un esquema del lado del servidor, aunque se puede definir uno opcionalmente para un diseño y una documentación de API eficientes.

    GraphQL utiliza un esquema del lado del servidor con establecimiento inflexible de tipos para definir los datos y los servicios de datos. El esquema, escrito en el lenguaje de definición de esquema (SDL) de GraphQL, incluye tipos de objetos y campos para cada objeto, así como funciones de solucionador del lado del servidor que definen las operaciones para cada campo.

  3. Control de versiones

    REST suele incluir el control de versiones en la URL, lo que puede llevar a mantener varias versiones de la API simultáneamente. El control de versiones no es obligatorio, pero puede ayudar a evitar cambios importantes.

    GraphQL promueve una evolución continua de la API sin un control de versiones explícito al requerir la compatibilidad con versiones anteriores. Los campos eliminados devuelven mensajes de error, mientras que las etiquetas de obsolescencia eliminan gradualmente los campos antiguos y devuelven mensajes de advertencia.

  4. Gestión de errores

    REST tiene un establecimiento flexible de tipos, por lo que es necesario integrar la gestión de errores en el código correspondiente. Es posible que esto no identifique automáticamente los errores relacionados con los tipos (por ejemplo, analizar un número como texto).

    Por el contrario, GraphQL tiene un establecimiento inflexible de tipos y requiere una definición de esquema completa. Esto permite que su servicio identifique automáticamente muchos errores de solicitud con un alto nivel de detalle.

  5. Casos de uso

    REST es más adecuado para:

    • Aplicaciones más pequeñas con requisitos de datos menos complejos.

    • Escenarios en los que todos los clientes utilicen los datos y las operaciones de forma similar.

    • Aplicaciones sin necesidades complejas de consulta de datos.

    GraphQL es más adecuado para:

    • Escenarios con un ancho de banda limitado, en los que sea crucial minimizar las solicitudes y las respuestas.

    • Aplicaciones con múltiples orígenes de datos que deban combinarse en un único punto de conexión.

    • Casos en los que las solicitudes de los clientes varían significativamente y esperan estructuras de respuesta diferentes.

    Tenga en cuenta que es posible utilizar tanto las API de GraphQL como las de REST en una sola aplicación para diferentes áreas de funcionalidad. Además, puede actualizar una API RESTful para incluir las capacidades de GraphQL sin tener que realizar una reescritura completa. Consulte How to build GraphQL resolvers for AWS data sources para ver un ejemplo.