Cómo crear una operación

En nubyhub, no escribes tú las operaciones.
Se generan de forma automática cuando:

✔ Importas una API
✔ Esta API tiene endpoints definidos
✔ La documentación incluye métodos y esquemas

Esto evita errores humanos y estandariza completamente el proceso.

Sin embargo, sí configuras las operaciones cuando las usas dentro de un flujo, y aquí es donde tiene sentido esta guía.

Una vez generadas automáticamente, puedes:

✔ Revisar la definición técnica

Ver parámetros, body, ejemplos y esquemas.

✔ Seleccionarla dentro de un flujo

Para ejecutarla en un paso concreto.

✔ Rellenar parámetros dinámicos

Por ejemplo, usar el ID de un cliente obtenido en un paso anterior.

✔ Personalizar el payload

Con valores fijos, variables o transformaciones.

✔ Encadenarla con otras operaciones

Ejemplo clásico:

• GET Orders
• Para cada pedido → POST Customer en ERP
• Luego → POST Order en ERP

Aunque la interfaz puede cambiar, cualquier operación siempre incluye:

1. Método HTTP

• GET
• POST
• PUT
• DELETE

Esto determina el tipo de acción:

• GET: leer información
• POST: crear un registro
• PUT/PATCH: actualizar
• DELETE: eliminar

2. Endpoint o ruta

Ejemplo:
/customers/{id}
/orders
/products/update-stock

3. Parámetros

Pueden ser:

• Path params (ej.: {id})
• Query params (ej.: ?limit=200)
• Headers adicionales (si la API los exige)

En nubyhub podrás rellenarlos manualmente o desde datos previos del flujo.

4. Body o payload (si aplica)

Esto define qué envías al sistema:

Ejemplo de payload:

   {
   «customer_id»: «123»,
   «name»: «John Doe»,
   «email»: «john@example.com»
   }

En nubyhub podrás:

• Mapearlo desde entidades generadas por una API
• Transformarlo mediante funciones
• Crear nuevos valores
• Combinar datos de varias APIs

5. Estructura de respuesta

La operación muestra el modelo esperado de respuesta, lo que sirve para:

• Validar resultados
• Extraer campos para siguientes pasos
• Depurar errores
• Encadenar lógica condicional

Cuando construyes un flujo:

1. Arrastras una operación al editor
2. Seleccionas la conexión que usará esa operación
3. Rellenas parámetros y cuerpo
4. Mapeas datos si vienen de pasos anteriores
5. Añades transformaciones opcionales
6. Decides qué hacer con la respuesta

Esto convierte las operaciones en piezas reutilizables para cualquier proceso.

❌ Parámetros obligatorios sin rellenar

Solución: revisar la definición de la API importada.

❌ Payload mal estructurado

Solución: validar el JSON o utilizar entidades generadas automáticamente.

❌ Campos nulos o vacíos

Solución: añadir validaciones o valores por defecto en el flujo.

❌ Endpoint sin permisos

La API debe permitir esa acción para el token usado.

❌ Falta de sincronía entre sistemas

Ej.: crear un pedido sin haber creado antes el cliente.
Solución: ordenar correctamente las operaciones en el flujo.

✔ Usar nombres claros para cada operación dentro del flujo
✔ Mapear solo los campos necesarios (no enviar payloads gigantes)
✔ Validar la respuesta antes de enviar datos a otro sistema
✔ Implementar manejos de error cuando una API no responde
✔ Encadenar operaciones de forma lógica (ej.: creación de cliente → creación de pedido)

Las operaciones son la base funcional de nubyhub.
Tú no las programas: la plataforma las genera por ti al importar la API.

Tu papel consiste en configurarlas, combinarlas y utilizarlas dentro de flujos para que los sistemas se comuniquen entre sí de forma automática, estable y segura.