De la instalación al primer upload

Esta guía reúne los pasos esenciales para poner en marcha una integración funcional en el navegador: cargar el bundle, asegurar la sesión del usuario y enviar un archivo directamente a Ingest.

1. Cargar el bundle del SDK

Incluya la etiqueta de script clásica del SDK en su HTML antes del código de su aplicación:

<script src="https://cdn.infinity6.ai/releases/sdkweb/latest/bundle/i6sdk-web.js"></script>

Esto expone el constructor window.I6Sdk de forma global en la página.

2. Garantizar sesión activa

Cree la instancia y ejecute requireUser() para verificar la autenticación por cookie. Si no hay sesión activa, el navegador redirigirá automáticamente a la pantalla de login:

const sdk = new window.I6Sdk();
const user = await sdk.auth().requireUser();
if (!user) return;

El SDK informa automáticamente la página actual en backurl al redirigir al login — no es algo que deba configurar. Consulte Flujo de login para más detalles.

3. Capturar el archivo y enviar con Ingest

Obtenga la referencia de un archivo desde un <input type="file"> y llame a upload() indicando los metadatos de destino:

const input = document.querySelector("#mi-archivo");
const file = input.files[0];
if (!file) return;

await sdk.ingest().upload({
  dataset: "ventas",
  table: "pedidos",
  partitions: { region: "sur", anio: "2026" },
  file,
});

El método solicita una URL firmada a la plataforma y sube el archivo directamente al almacenamiento sin servidores intermedios.

4. Qué verificar si ocurre un error

Si la petición falla:

• Compruebe que el origen de su página esté habilitado para CORS con credenciales en la plataforma.
• Confirme que el parámetro file sea una instancia válida de File del navegador.
• Para consultar la relación completa de síntomas y causas, visite Solución de problemas.