Da instalação ao primeiro upload

Este guia reúne os passos essenciais para colocar uma integração básica em funcionamento no navegador: carregar o bundle, garantir que o usuário está autenticado e realizar o envio de um arquivo diretamente para o Ingest.

1. Carregar o bundle do SDK

Inclua o script clássico do SDK no seu HTML antes do código da sua aplicação:

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

Isso expõe o construtor window.I6Sdk globalmente na página.

2. Garantir sessão ativa

Crie a instância e utilize requireUser() para verificar a autenticação por cookie. Se não houver sessão ativa, o usuário será redirecionado automaticamente à tela de login:

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

O SDK informa automaticamente a página atual em backurl ao redirecionar para o login — não é algo que você precisa configurar. Veja Fluxo de login para mais detalhes.

3. Capturar o arquivo e enviar com Ingest

Obtenha a referência de um arquivo vindo de um <input type="file"> e chame upload() fornecendo os parâmetros de destino:

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

await sdk.ingest().upload({
  dataset: "vendas",
  table: "pedidos",
  partitions: { regiao: "sudeste", ano: "2026" },
  file,
});

O método requisita uma URL assinada à plataforma e faz o upload direto do arquivo, mantendo o tráfego fora de servidores intermediários.

4. O que verificar se ocorrer erro

Se a requisição falhar:

• Verifique se a origem da sua página está autorizada para CORS com credenciais na plataforma.
• Certifique-se de que o parâmetro file é uma instância de File do navegador.
• Para a lista completa de sintomas e mensagens de erro do bundle e do navegador, consulte a página Solução de problemas.