API

Netuno tiene un framework propio para crear API REST de forma low-code, con soporte para JWT (JSON Web Token) y OpenAPI 3.0.

Todo el framework para el desarrollo de servicios web en Netuno es muy versátil y permite realizar cualquier tipo de desarrollo.

El framework ya incluye muchas funcionalidades para el desarrollo low-code, ahorrando muchas líneas de código para cubrir las necesidades más comunes, como enviar correos, consumir otras API REST, integrarse con otras bases de datos, generar archivos PDF y Excel, enviar SMS, manipular datos de la base de datos, entre muchas otras.

Y cuando no existen soluciones en el framework de Netuno, es posible integrar fácilmente bibliotecas Java, Kotlin o incluso JavaScript ya existentes para desarrollar recursos a medida e integrarlos con el framework de Netuno.

JWT - JSON Web Token

El JWT.io es la especificación del estándar para el paso de datos del contexto de sesión al cliente, mediante un objeto JSON.

Así, el servidor no necesita guardar los datos sensibles de los usuarios con sesión iniciada, sino que pasa a ser un token que se transmite al cliente y, posteriormente, en cada petición, este token debe ser devuelto.

Este token está sujeto a algunos controles de seguridad, como el tiempo límite de validez y un proceso que permite crear un nuevo token sin exigir una nueva autenticación.

Netuno tiene integrado el soporte para JWT; es simple y fácil de utilizar, y también funciona integrado con los usuarios y la autenticación nativa de Netuno.

OpenAPI 3.0

Tras el éxito de Swagger v1 y v2, que hace mucho se convirtieron en un estándar para el desarrollo de la definición de los servicios web y la generación del código de cliente.

Así, Swagger hizo su definición abierta y pasó a ser OpenAPI 3.

Donde sigue siendo la base para definir el estándar de cómo se documenta la API y cómo se generan los clientes para consumirla.

Netuno ya incluye toda la integración con OpenAPI 3.0 y utiliza la definición de OpenAPI junto con la validación del JSON Schema.

Esto significa que Netuno también permite validar la entrada y la salida de los servicios web, recurriendo a la validación del esquema del JSON obtenido y devuelto, de modo que:

• Entrada: Si hay una llamada al servicio web que no cumple la estructura y las validaciones, entonces se rechaza.
• Salida: Si devuelve datos que no cumplen la estructura y las validaciones definidas, entonces se genera una alerta de que el servicio web no es conforme.

Así, Netuno no solo evita la creación de muchos ifs en el código para la validación de los datos recibidos, sino que además garantiza una validación del resultado que está generando el servicio web, realizando una prueba unitaria.

Además, la estructura de OpenAPI generada por Netuno puede utilizarse con el Editor de Swagger para generar la interfaz de pruebas, la documentación y el código para clientes de la API en otras tecnologías.

Básico

Netuno también admite la creación de servicios web y autenticación sin complicaciones, es decir, no es obligatorio utilizar JWT u OpenAPI, aunque sea la recomendación estándar.

Muchas veces, para agilizar la creación de la API o en situaciones que implican la comunicación entre servidores, se opta por simplificar al máximo y ganar tiempo.

Netuno permite realizar la autenticación HTTP.