OpenAPI-to-GraphQL

Introducción al proyecto

En los últimos años muchas organizaciones crearon APIs Rest para proporcionar acceso a sus recursos empresariales. Las aplicaciones del cliente normalmente eligen entre esos recursos y se preocupan por las relaciones que existen entre ellos. GraphQL es una tecnología emergente para crear la siguiente generación de APIs.

GraphQL permite que los clientes escriban consultas que controlen con precisión cuales son los recursos que quieren recuperar o cambiar, independientemente de si quieren seleccionar únicamente partes pequeñas de un único recurso o conjuntos grandes de recursos relacionados. Por lo tanto, GraphQL otorga a los clientes una flexibilidad sin precedentes para interactuar con una API, sin que el proveedor de la API tenga que permitir esta flexibilidad por cada cliente.

OpenAPI-to-GraphQL es una biblioteca que ayuda a que los proveedores aprovechen las APIs Rest existentes para que utilicen esta tecnología nueva y emocionante. OpenAPI-to-GraphQL utiliza Swagger o OpenAPI Specifications de las APIs Rest existentes para generar automáticamente una interfaz de GraphQL que resuelve las consultas del cliente transformándolas en solicitudes de API Rest. Es la forma más fácil de empezar a utilizar GraphQL sin dedicar ningún esfuerzo para implementar manualmente una API de GraphQL. OpenAPI-to-GraphQL se encarga de muchos desafíos, como la purga de datos para trabajar con GraphQL o la habilitación de la autenticación, mientras proporciona funciones avanzadas, como permitir el uso de consultas muy anidadas dentro de una o varias APIs Rest, en base a las definiciones de enlaces de una OpenAPI Specification.

¿Por qué un desarrollador debería contribuir?

Hasta la fecha hemos añadido muchas mejoras, como la seguridad, mejoras en la limpieza de datos, reporte de errores, la impresionante habilidad de sobrescribir los resolutores autogenerados, y en su lugar los personalizados, y el soporte para varios OAS para crear interfaces de GraphQL para las APIs. También tenemos una lista de tareas que se basa en la comunidad, como solicitudes para suscripciones a GraphQL, modelos de autenticación más granulares y mejoras en la CLI.

Sabemos que OAS 3.0.0 puede hacer muchas cosas y todavía no hemos visto todos los casos de uso. Agradecemos que la comunidad contribuya para hacer que OpenAPI-to-GraphQL sea más usable y sólido, según vayan probándolo y encontrando brechas. Abra tickets y, si es posible, envíe solicitudes con correcciones o soluciones nuevas para ellos.

¿Qué problemas empresariales soluciona el proyecto?

OpenAPI-to-GraphQL le ayuda a aprovechar las APIs Rest que están disponibles para la empresa y a crear aplicaciones cliente y móviles más rápidamente. Es posible crear una interfaz de GraphQL con una OAS válida y probar esta nova tecnología en cuestión de minutos.

Aviso

El contenido aquí presentado fue traducido de la página IBM Developer US. Puede revisar el contenido original en este link.