Cómo importar una API

nubyhub está preparada para trabajar con los cuatro formatos estándar del mercado:

✔ OpenAPI 3.x (JSON o YAML)

Es el estándar moderno más utilizado.

✔ Swagger 2.0

Todavía muy común en ERPs y software corporativo.

✔ Postman Collection

Perfecto cuando una API no tiene documentación formal.

✔ Definición vía URL pública

Puedes pegar directamente el enlace a la documentación.

No necesitas modificar nada: nubyhub lee, interpreta y genera todo automáticamente.

1. La definición técnica del sistema (archivo o URL)
2. Conocer si la documentación está actualizada
3. Saber si la API requiere autenticación para leer la definición
4. Verificar que no está incompleta o corrupta

Nubyhub importará lo que encuentre:
Si falta un modelo, endpoint o parámetro, no aparecerá.

Cuando subes una definición o pegas una URL, nubyhub hace lo siguiente:

1. Analiza la estructura del documento

Identifica:

• Endpoints
• Métodos HTTP
• Parámetros
• Esquemas
• Entidades
• Relaciones
• Ejemplos
• Descripciones

2. Genera automáticamente todas las entidades

Ejemplo:

   Customer {
   id: string
   name: string
   email: string
   }

3. Construye todas las operaciones

Ejemplo:

• GET /customers
• POST /customers
• PUT /customers/{id}
• DELETE /customers/{id}

Cada una queda disponible para flujos y transformaciones.

4. Valida la coherencia interna

Si detecta:

• Tipos inconsistentes
• Parámetros sin definir
• Esquemas circulares
• Endpoints duplicados
• Campos repetidos

Muestra advertencias o errores.

5. Guarda la API dentro del tenant

Una API importada queda disponible:

• Para crear flujos
• Para analizar entidades
• Para mapear datos
• Para vincular conexiones
• Para desarrollar reglas de negocio

Se convierte en una biblioteca interna del tenant.

❌ Documentación incompleta

Muy común en software antiguo o APIs privadas.

❌ Formato incorrecto (JSON mal cerrado, indentación, etc.)

Basta con corregir el archivo.

❌ Falta de esquemas

Si un endpoint no describe el body, nubyhub no puede crear una entidad.

❌ Postman exportado sin ejemplos ni body

Se puede importar, pero genera menos información.

✔ Usa siempre la versión más actualizada de la documentación

Evitarás inconsistencias entre entorno de test y producción.

✔ Comprueba si hay endpoints duplicados o en desuso

Se importarán igual, pero conviene saberlo.

✔ Organiza las APIs por cliente o proyecto

Ej.:

• Shopify_Base
• ERP_ClienteX
• HubSpot_Marketing

✔ Asegúrate de que todas las entidades tienen identificación clara

Ej.: id, uuid, customer_id.

Esto es clave para flujos fiables

Una vez importada, podrás:

Seleccionar cualquier operación dentro de un flujo

Ej.: “GET Orders”, “POST Customer”, “PATCH Stock”.

Consultar las entidades para mapear datos

Perfecto para entender la estructura.

Transformar campos con seguridad

nubyhub conoce los tipos, así que sabe validar.

Combinar esa API con otras

Ejemplo real:

• Traer pedidos de Shopify
• Crear clientes en Business Central
• Actualizar stock en Sage 200

Todo desde una única API importada por cada sistema.

Importar una API en nubyhub es un proceso automático, potente y completamente estandarizado.
Con solo subir un archivo o pegar una URL, obtienes:

• Todas las operaciones
• Todas las entidades
• Todos los modelos
• Toda la documentación
• Listo para construir flujos complejos sin programar

Es uno de los pilares que hacen que nubyhub pueda integrarse con prácticamente cualquier software moderno.