Geração de Url de Upload - DataSnap Documentation

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}'

const response = await fetch(
  'https://api.datasnap.cloud/api/v1/schemas/seu-schema/generate-upload-token',
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer SEU_TOKEN_AQUI',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ minutes: 15 })
  }
);

const tokenData = await response.json();
console.log('Token gerado:', tokenData);

import requests

response = requests.post(
    "https://api.datasnap.cloud/api/v1/schemas/seu-schema/generate-upload-token",
    headers={
        "Authorization": "Bearer SEU_TOKEN_AQUI",
        "Content-Type": "application/json"
    },
    json={"minutes": 15}
)

token_data = response.json()
print(f"Token gerado: {token_data}")

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

POST

api

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}'

const response = await fetch(
  'https://api.datasnap.cloud/api/v1/schemas/seu-schema/generate-upload-token',
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer SEU_TOKEN_AQUI',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ minutes: 15 })
  }
);

const tokenData = await response.json();
console.log('Token gerado:', tokenData);

import requests

response = requests.post(
    "https://api.datasnap.cloud/api/v1/schemas/seu-schema/generate-upload-token",
    headers={
        "Authorization": "Bearer SEU_TOKEN_AQUI",
        "Content-Type": "application/json"
    },
    json={"minutes": 15}
)

token_data = response.json()
print(f"Token gerado: {token_data}")

{
  "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

string

required

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

Corpo da Requisição

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}'

const response = await fetch(
  'https://api.datasnap.cloud/api/v1/schemas/seu-schema/generate-upload-token',
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer SEU_TOKEN_AQUI',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ minutes: 15 })
  }
);

const tokenData = await response.json();
console.log('Token gerado:', tokenData);

import requests

response = requests.post(
    "https://api.datasnap.cloud/api/v1/schemas/seu-schema/generate-upload-token",
    headers={
        "Authorization": "Bearer SEU_TOKEN_AQUI",
        "Content-Type": "application/json"
    },
    json={"minutes": 15}
)

token_data = response.json()
print(f"Token gerado: {token_data}")

Resposta de Sucesso

integer

Identificador único do token de upload gerado

string

URL pré-assinada para upload direto de arquivos para o Oracle Cloud Storage

string

Data e hora de expiração da URL de upload no formato ISO 8601

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

integer

O valor deve estar entre 1 e 60 minutos

Códigos de Erro

Success

Token gerado com sucesso

Error

Não autorizado - Token de autenticação inválido ou ausente

Error

Erro de validação - Valor de minutes inválido (deve estar entre 1 e 60)

Próximos Passos

Após gerar o token:

Use a upload_url retornada para fazer upload direto via HTTP PUT
Monitore a expiração - URLs expiram automaticamente
Consulte seus dados usando o endpoint de consultas após processamento

Endpoints Relacionados

Executar Consultas - Consultar dados enviados
Listar Arquivos - Gerenciar arquivos enviados

​Visão Geral

Método

Segurança

Performance

Escalabilidade

​Autenticação

​Parâmetros de Caminho

​Corpo da Requisição

​Exemplo de Requisição

​Resposta de Sucesso

​Como Usar o Token Gerado

​Validação

​Códigos de Erro

​Próximos Passos

​Endpoints Relacionados

Visão Geral

Autenticação

Parâmetros de Caminho

Corpo da Requisição

Exemplo de Requisição

Resposta de Sucesso

Como Usar o Token Gerado

Validação

Códigos de Erro

Próximos Passos

Endpoints Relacionados