Skip to main content
POST
https://api.datasnap.cloud
/
api
/
v1
/
schemas
/
{slug}
/
generate-upload-token
curl -X POST \
  "https://api.datasnap.cloud/api/v1/schemas/seu-schema/generate-upload-token" \
  -H "Authorization: Bearer SEU_TOKEN_AQUI" \
  -H "Content-Type: application/json" \
  -d '{"minutes": 15}'

{
  "id": 8,
  "upload_url": "{pre_signed_url}",
  "expires_at": "2025-10-03T03:29:08.000000Z",
  "success": true
}

​
Visão Geral

Este endpoint permite gerar URLs pré-assinadas para upload direto de arquivos no formato JSONL. É o primeiro passo do processo de upload de arquivos na API DataSnap.

Método

Gera URLs temporárias e seguras

Segurança

URLs expiram automaticamente (1-60 min)

Performance

Upload direto para Oracle Cloud Storage

Escalabilidade

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

​
Autenticação

Este endpoint requer autenticação. Inclua seu token Bearer no cabeçalho Authorization.
Authorization: Bearer SEU_TOKEN_AQUI

​
Parâmetros de Caminho

​
slug
string
required
O slug do schema para o qual você quer gerar o token de upload

​
Corpo da Requisição

​
minutes
integer
required
Número de minutos que a URL de upload deve ser válida (1-60 minutos)

​
Exemplo de Requisição

curl -X POST \
  "https://api.datasnap.cloud/api/v1/schemas/seu-schema/generate-upload-token" \
  -H "Authorization: Bearer SEU_TOKEN_AQUI" \
  -H "Content-Type: application/json" \
  -d '{"minutes": 15}'

​
Resposta de Sucesso

​
id
integer
Identificador único do token de upload gerado
​
upload_url
string
URL pré-assinada para upload direto de arquivos para o Oracle Cloud Storage
​
expires_at
string
Data e hora de expiração da URL de upload no formato ISO 8601
​
success
boolean
Indica se o token foi gerado com sucesso
{
  "id": 8,
  "upload_url": "{pre_signed_url}",
  "expires_at": "2025-10-03T03:29:08.000000Z",
  "success": true
}

​
Como Usar o Token Gerado

Após receber a resposta, use a upload_url para fazer upload direto do arquivo: 
# Usar a URL retornada para upload
curl -X PUT \
  "{pre_signed_url}/dados.jsonl" \
  -H "Content-Type: application/octet-stream" \
  --data-binary "@dados.jsonl"

​
Validação

​
minutes
integer
O valor deve estar entre 1 e 60 minutos

​
Códigos de Erro

​
200
Success
Token gerado com sucesso
​
401
Error
Não autorizado - Token de autenticação inválido ou ausente
​
422
Error
Erro de validação - Valor de minutes inválido (deve estar entre 1 e 60)

​
Próximos Passos

Após gerar o token:
  1. Use a upload_url retornada para fazer upload direto via HTTP PUT
  2. Monitore a expiração - URLs expiram automaticamente
  3. Consulte seus dados usando o endpoint de consultas após processamento

​
Endpoints Relacionados