Cómo crear una conexión

Toda conexión —en cualquier API del mundo— requiere tres elementos:

1. La URL base (Base URL) del sistema o API

Ejemplos:

• https://api.shopify.com/…
• https://api.hubspot.com/…
• https://mi-servidor.com/api/v1/

Esto define el “punto de entrada” a la API.

2. El método de autenticación

Todas las APIs modernas usan uno de estos formatos:

• API Key (clave única)
• Token Bearer
• OAuth2 (para sistemas más complejos)
• Cabeceras personalizadas
• Tokens temporales renovables

Cada API lo define en su documentación.

3. Las credenciales

Pueden ser:

• Una API Key
• Un par client_id / client_secret
• Un token de acceso
• Credenciales obtenidas de un flujo OAuth

nubyhub no genera credenciales: las obtiene del sistema externo.

Cuando configuras una conexión, nubyhub:

1. Valida las credenciales. Comprueba que todo está correcto mediante una llamada de prueba.
2. Registra la conexión en el tenant. El tenant almacena la conexión para que puedas usarla en cualquier flujo.
3. Enlaza esta conexión con la API importada. Todas las operaciones de la API utilizarán esta conexión para autenticarse.
4. La deja disponible para todos los flujos. No hace falta crear una conexión por flujo: se reutiliza tantas veces como quieras.

✔ Seleccionar el entorno

Muchas APIs tienen entornos separados:

• Sandbox
• Test
• Preproducción
• Producción

En nubyhub puedes tener todas las que necesites dentro del mismo tenant.

Esto es clave para evitar errores en producción al hacer pruebas.

✔ Determinar el tiempo de expiración del token

Si la API usa tokens temporales:

• Debes saber cuándo caducan
• Debes saber cómo renovarlos
• Debes saber si requieren un endpoint específico

nubyhub podrá renovar automáticamente el token si la API lo permite.

✔ Definir encabezados adicionales

Algunas APIs requieren:

• Identificadores de empresa
• Versiones
• Idiomas
• Claves secundarias

Todo eso se define en la conexión.

❌ Credenciales incorrectas

Solución: comprobar el token en la propia API (ej.: Postman).

❌ URL base mal copiada

Solución: eliminar barras dobles, endpoints adicionales o parámetros.

❌ Token caducado

Solución: regenerar credenciales antes de crear la conexión.

❌ CORS o IPs restringidas

Si la API limita peticiones por IP, deberás permitir las IPs de nubyhub.

Cuando creas un flujo:

1. Seleccionas una operación (por ejemplo, “GET Orders”).

2. nubyhub pregunta automáticamente:
“¿Qué conexión quieres usar para esta operación?”

3. La conexión se encarga de:

• Autenticar
• Enviar la petición
• Recibir la respuesta
• Registrar errores

Tú no tienes que escribir ninguna llamada HTTP manual.

• Usa nombres descriptivos:
  Sage200_Producción, Shopify_Tests, HubSpot_Ruben
• Crea conexiones separadas por entorno
• Comprueba la documentación de autenticación antes de empezar
• Evita compartir conexiones entre clientes distintos
• Actualiza credenciales caducadas antes de que fallen flujos

Crear una conexión en nubyhub es sencillo desde el punto de vista operativo, pero crítico a nivel técnico.

Con los elementos adecuados (URL, autenticación y credenciales), una conexión puede mantenerse estable durante meses y ser reutilizada en decenas de flujos.