Operaciones API en nubyhub

Las operaciones son las instrucciones que permiten a nubyhub interactuar con un sistema externo.
Cada operación corresponde a un endpoint de la API del sistema y define:

• El método (GET, POST, PUT, DELETE…)
• La ruta de la petición
• Los parámetros y filtros
• El cuerpo de envío (payload)
• La estructura de la respuesta

Al importar una API, nubyhub lee toda esta información y crea una biblioteca de operaciones lista para usar.

Las operaciones son la capa que ejecuta realmente la integración. Permiten:

• Consultar datos de un sistema
• Crear nuevos registros (clientes, pedidos, productos…)
• Actualizar información existente
• Eliminar registros cuando la API lo permita
• Aplicar acciones específicas del software (ej.: confirmar pedido, generar factura, enviar notificación)
• En los flujos, cada paso utiliza una operación para comunicarse con el sistema correspondiente.

Una vez importada la API, cada operación se muestra con toda su definición:
– Campos de entrada
– Parámetros opcionales
– Estructura del cuerpo
– Ejemplo de request y response
– Entidades asociadas

Cuando construyes un flujo, solo tienes que arrastrar la operación que quieres ejecutar y rellenar los campos necesarios.
nubyhub se encarga del resto: autenticación, validación de datos, envío de la petición y captura de la respuesta.

Puedes además combinar operaciones en un mismo flujo, encadenándolas según tus reglas de negocio.

• No necesitas escribir peticiones HTTP manuales
• Evitas errores de tipado y estructura en cada request
• Trabajas directamente con modelos de datos reconocibles
• Reduces el tiempo de desarrollo y configuración
• Permite replicar flujos enteros en otros clientes sin rehacer nada
• Aporta mayor estabilidad y fiabilidad en las integraciones

Supongamos que quieres sincronizar pedidos desde un ecommerce hacia tu ERP.

1. Importas la API del ecommerce y nubyhub detecta operaciones como:
   • GET /orders
   • GET /orders/{id}
   • POST /orders
   • POST /customers

2. En el flujo arrastras la operación “GET /orders” para obtener los pedidos nuevos.

3. Transformas los datos y después arrastras la operación “POST /orders” del ERP para crearlos automáticamente.

Cada operación se ejecuta en orden y nubyhub gestiona credenciales, rutas, validaciones y respuestas.