Snapshot
Retorna todos os backups versionados do usuário autenticado. Filtre por appID ou pagine os resultados.
Número da página (deve ser >= 1)
1Itens por página (1–200)
50Se true, retorna uma visão resumida de cada backup
falseFiltrar backups de um app específico (letras, números, hífen; máx 40 chars)
^[a-zA-Z0-9\-]+$Backups obtidos com sucesso
okParâmetro inválido
Erro de autenticação
Nenhum backup encontrado para o appID informado
Erro interno do servidor
GET /v2/snapshot HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Accept: */*
{
"status": "ok",
"message": "Backups obtidos com sucesso",
"page": 1,
"limit": 50,
"total": 3,
"backups": []
}Gera uma URL temporária de download para uma versão específica de backup versionado.
ID do app (letras, números, hífen; máx 40 chars)
^[a-zA-Z0-9\-]+$Versão do backup no formato YYYYMMDD-HHMMSS
20260420-153000Pattern: ^\d{8}-\d{6}$Link de download gerado com sucesso
Parâmetro inválido
Erro de autenticação
Versão de backup não encontrada
Erro interno do servidor
GET /v2/snapshot/{appID}/versions/{version} HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Accept: */*
{
"status": "ok",
"message": "Link de download gerado com sucesso",
"app": {
"id": "meu-app-id"
},
"download": {
"url": "https://storage.example.com/backup.zip?token=abc123",
"expiresAt": "2026-04-21T15:30:00Z",
"version": "20260420-153000",
"size": 204800
}
}Remove permanentemente uma versão específica de backup versionado de uma aplicação.
ID do app (letras, números, hífen; máx 40 chars)
^[a-zA-Z0-9\-]+$Versão do backup no formato YYYYMMDD-HHMMSS
20260420-153000Pattern: ^\d{8}-\d{6}$Versão de backup deletada com sucesso
Parâmetro inválido
Erro de autenticação
Não é o dono desta aplicação
Aplicação ou versão não encontrada
Erro interno do servidor
DELETE /v2/snapshot/{appID}/versions/{version} HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Accept: */*
{
"status": "ok",
"message": "Versão de backup deletada com sucesso",
"app": {
"id": "meu-app-id"
},
"deleted": "backups/123456/meu-app-id/backup-meu-app-id-20260420-153000.zip"
}Retorna todos os backups versionados de um app específico.
ID do app (letras, números, hífen; máx 40 chars)
^[a-zA-Z0-9\-]+$Backups carregados com sucesso
Formato inválido do App ID
Erro de autenticação
Nenhum backup encontrado para este app
Erro interno do servidor
GET /v2/snapshot/{appID} HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Accept: */*
{
"status": "ok",
"message": "Backups deste app carregados com sucesso",
"app": {
"id": "my-app-id"
},
"versions": [
{
"version": "20260420-153000",
"size": 204800,
"date": 1745100000000
}
]
}Cria um novo backup versionado (snapshot) para uma aplicação específica.
ID do app (letras, números, hífen; máx 40 chars)
^[a-zA-Z0-9\-]+$Backup versionado criado com sucesso
Formato de appID inválido
Erro de autenticação
Acesso negado — não é o dono da aplicação ou o plano não permite backups versionados
Aplicação não encontrada
Aplicação ocupada processando outra tarefa
Erro interno do servidor
POST /v2/snapshot/{appID} HTTP/1.1
Host: api.discloud.app
api-token: YOUR_API_KEY
Accept: */*
{
"status": "ok",
"message": "Backup versionado criado com sucesso",
"app": {
"id": "meu-app-id"
},
"snapshot": {
"version": "20260420-153000",
"size": "2.5 MB",
"url": "https://s3.discloud.com/...",
"allVersions": [
{
"version": "20260420-153000",
"size": "2.5 MB",
"date": "2026-04-20T15:30:00Z"
}
]
}
}Última atualização