Snapshot

Listar backups versionados

get

Retorna todos os backups versionados do usuário autenticado. Filtre por appID ou pagine os resultados.

Authorizations

ApiKeyAuth

api-tokenstringRequired

Query parameters

pageinteger · min: 1Optional

Número da página (deve ser >= 1)

Default: 1

limitinteger · min: 1 · max: 200Optional

Itens por página (1–200)

Default: 50

summarybooleanOptional

Se true, retorna uma visão resumida de cada backup

Default: false

appIDstring · max: 40Optional

Filtrar backups de um app específico (letras, números, hífen; máx 40 chars)

Pattern: ^[a-zA-Z0-9\-]+$

Responses

200

Backups obtidos com sucesso

application/json

statusstringOptionalExample: ok

messagestringOptional

400

Parâmetro inválido

application/json

401

Erro de autenticação

application/json

404

Nenhum backup encontrado para o appID informado

application/json

500

Erro interno do servidor

application/json

get

/snapshot

HTTPcURLJavaScriptPython

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": []
}

Gerar link de download do backup

get

Gera uma URL temporária de download para uma versão específica de backup versionado.

Authorizations

ApiKeyAuth

api-tokenstringRequired

Path parameters

appIDstring · max: 40Required

ID do app (letras, números, hífen; máx 40 chars)

Pattern: ^[a-zA-Z0-9\-]+$

versionstringRequired

Versão do backup no formato YYYYMMDD-HHMMSS

Example: 20260420-153000Pattern: ^\d{8}-\d{6}$

Responses

200

Link de download gerado com sucesso

application/json

statusstringOptional

messagestringOptional

400

Parâmetro inválido

application/json

401

Erro de autenticação

application/json

404

Versão de backup não encontrada

application/json

500

Erro interno do servidor

application/json

get

/snapshot/{appID}/versions/{version}

HTTPcURLJavaScriptPython

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

Listar backups de um app

get

Retorna todos os backups versionados de um app específico.

Authorizations

ApiKeyAuth

api-tokenstringRequired

Path parameters

appIDstring · max: 40Required

ID do app (letras, números, hífen; máx 40 chars)

Pattern: ^[a-zA-Z0-9\-]+$

Responses

200

Backups carregados com sucesso

application/json

statusstringOptional

messagestringOptional

versionsobject[]Optional

400

Formato inválido do App ID

application/json

401

Erro de autenticação

application/json

404

Nenhum backup encontrado para este app

application/json

500

Erro interno do servidor

application/json

get

/snapshot/{appID}

HTTPcURLJavaScriptPython

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

Criar backup versionado

post

Cria um novo backup versionado (snapshot) para uma aplicação específica.

Authorizations

ApiKeyAuth

api-tokenstringRequired

Path parameters

appIDstring · max: 40Required

ID do app (letras, números, hífen; máx 40 chars)

Pattern: ^[a-zA-Z0-9\-]+$

Responses

200

Backup versionado criado com sucesso

application/json

statusstringOptional

messagestringOptional

400

Formato de appID inválido

application/json

401

Erro de autenticação

application/json

403

Não é o dono desta aplicação

application/json

404

Aplicação não encontrada

application/json

409

Aplicação ocupada processando outra tarefa

application/json

500

Erro interno do servidor

application/json

post

/snapshot/{appID}

HTTPcURLJavaScriptPython

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"
      }
    ]
  }
}