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
}
Endpoints
Geração de Url de Upload
Gere um token com URL pré-assinada para fazer upload direto de arquivos JSONL para o Oracle Cloud Storage
POST
/
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}'
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 aupload_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