Skip to main content
PUT

Visão Geral

Este processo permite fazer upload de arquivos JSONL utilizando URLs pré-assinadas obtidas através do endpoint de geração de token. O upload é feito diretamente para o Oracle Cloud Storage via método HTTP PUT.

Método

Upload via HTTP PUT para URL pré-assinada

Performance

Upload direto para Oracle Cloud Storage

Segurança

URLs temporárias com expiração automática

Escalabilidade

Suporte a arquivos de qualquer tamanho

Processo de Upload

1

Gerar Token de Upload

Use o endpoint POST /api/v1/schemas/{slug}/generate-upload-token para obter uma URL pré-assinada
2

Fazer Upload Direto

Use a URL retornada com método PUT para fazer upload direto do arquivo
3

Processamento Assíncrono

O arquivo é processado em segundo plano e fica disponível para consulta

Método HTTP

Parâmetros da URL

string
required
URL pré-assinada obtida do endpoint de geração de token
string
required
Nome do arquivo JSONL a ser enviado (deve incluir extensão .jsonl)

Exemplo de URL

Corpo da Requisição

binary
required
Conteúdo binário do arquivo JSONL a ser enviado

Como Funciona

O upload de arquivos utiliza um sistema de URLs pré-assinadas que oferece:

Performance

Upload direto para Oracle Cloud Storage

Segurança

URLs temporárias com expiração automática

Escalabilidade

Suporte a arquivos de qualquer tamanho (recomendamos arquivos de até 10MB para máxima performance)

Eficiência

Processamento assíncrono em segundo plano

Fluxo de Upload

1

1. Gerar Token

Primeiro, gere um token de upload:
2

2. Extrair URL

Da resposta, extraia a upload_url:
3

3. Fazer Upload

Use a URL para upload via PUT:

Requisitos de Formato de Arquivo

Os arquivos devem estar no formato JSONL (JSON Lines) onde cada linha contém um objeto JSON válido.

Exemplo JSONL Válido

Exemplos Inválidos

Exemplos de Implementação

Resposta do Upload

O upload via PUT retorna diretamente o status HTTP:
Success
Upload realizado com sucesso - arquivo enviado para Oracle Cloud Storage
Error
Não autorizado - URL de upload expirada ou inválida
Error
Arquivo muito grande - tamanho excede limite do storage

Códigos de Resposta

Boas Práticas

Valide arquivos localmente - Teste o formato JSONL antes do upload para evitar erros.
Use nomes únicos - Evite conflitos dando nomes descritivos e únicos aos arquivos.
Monitore expiração - URLs pré-assinadas expiram em 1-60 minutos. Complete o upload dentro do prazo.
URLs são temporárias - Certifique-se de que o upload seja concluído antes da expiração da URL.

Limites Técnicos

Para máxima performance, recomendamos dividir arquivos muito grandes (>10MB) em múltiplos uploads menores.

Próximos Passos

Após o upload bem-sucedido:
  1. ✅ Upload concluído - Arquivo enviado para Oracle Cloud Storage
  2. 🔄 Processamento em background - Dados sendo preparados para consulta
  3. 📊 Consulta disponível - Use endpoint de consultas para analisar dados
  4. 📁 Monitoramento - Liste arquivos para verificar status de processamento

Endpoints Relacionados