> ## Documentation Index > Fetch the complete documentation index at: https://docs.cubehosting.com.br/llms.txt > Use this file to discover all available pages before exploring further. # Baixar o backup do banco > O arquivo do backup, no formato da ferramenta do próprio banco. O arquivo sai no formato da ferramenta do banco, para você abrir onde quiser: | Banco | Arquivo | Como abrir | | ---------- | ------------- | -------------------------------------------------- | | PostgreSQL | `.dump` | `pg_restore -d --no-owner arquivo.dump` | | MySQL | `.sql.gz` | `gunzip -c arquivo.sql.gz \| mysql ` | | MongoDB | `.archive.gz` | `mongorestore --archive=arquivo.archive.gz --gzip` | | Redis | `.rdb` | Copie como `dump.rdb` na pasta de dados do Redis | ## Erros comuns | Código | HTTP | O que fazer | | ---------------------------------------------------------- | ---- | ---------------------------------- | | [`download_expired`](/errors#param-download-expired) | 403 | O link vale 5 minutos: peça outro. | | [`backup_not_ready`](/errors#param-backup-not-ready) | 409 | Espere o `status` virar `ready`. | | [`backups_unavailable`](/errors#param-backups-unavailable) | 503 | Tente de novo em instantes. | Todos os códigos, com o formato do erro, em [Códigos de erro](/errors). ## OpenAPI ````yaml GET /databases/{id}/backups/{backupId}/download openapi: 3.1.0 info: title: API da Cube Hosting version: 1.0.0 description: >- Hospede bots de Discord, sites e APIs em Node.js e Python: envie o .zip, inicie, pare, reinicie, leia logs e métricas, cuide das variáveis de ambiente, faça e baixe backups, volte para uma versão anterior, crie bancos de dados (PostgreSQL, MySQL, MongoDB e Redis), guarde arquivos privados no Blob e veja o uso do plano. Para agentes de IA, o servidor MCP da conta (`POST https://app.cubehosting.com.br/api/mcp`, JSON-RPC, com a mesma chave) está em https://docs.cubehosting.com.br/account-mcp. contact: name: Cube Hosting url: https://discord.gg/pv6D9tUsDV servers: - url: https://app.cubehosting.com.br/api security: - bearerAuth: [] tags: - name: Projetos - name: Controle - name: Logs e métricas - name: Variáveis de ambiente - name: Backups - name: Versões dos envios - name: Bancos de dados - name: Blob - name: Avisos - name: Conta paths: /databases/{id}/backups/{backupId}/download: get: tags: - Bancos de dados summary: Baixar o backup do banco description: >- Baixa o backup pelo link do [Pedir o link do backup](/api-reference/databases/backup-download-link), com a mesma chave (de leitura e escrita). O formato é o da ferramenta do próprio banco, e o nome vem no `Content-Disposition` (`-backup-.`): PostgreSQL `.dump` (`pg_restore`), MySQL `.sql.gz` (gzip com o SQL do `mysqldump`), MongoDB `.archive.gz` (`mongorestore --archive --gzip`) e Redis `.rdb`. Download com menos bytes que o `Content-Length` não está inteiro: peça o link de novo. operationId: downloadDatabaseBackup parameters: - $ref: '#/components/parameters/DatabaseId' - $ref: '#/components/parameters/BackupId' - name: expires in: query required: true description: Vem no `url` do link. schema: type: integer - name: signature in: query required: true description: Vem no `url` do link. schema: type: string responses: '200': description: O arquivo do backup. content: application/octet-stream: schema: type: string format: binary '401': description: Chave ausente, inválida ou revogada. content: application/json: schema: $ref: '#/components/schemas/Error' examples: invalid_api_key: summary: invalid_api_key value: status: error code: invalid_api_key message: >- Chave de API inválida ou revogada. Confira o cabeçalho "Authorization: Bearer " ou crie outra em Chaves de API no painel. '403': description: O link venceu (5 minutos) ou foi mexido, ou a chave é só de leitura. content: application/json: schema: $ref: '#/components/schemas/Error' examples: download_expired: summary: download_expired value: status: error code: download_expired message: >- O link de download venceu ou não é desta Conta. Peça o download de novo pelo painel. insufficient_permission: summary: insufficient_permission value: status: error code: insufficient_permission message: >- Esta chave é só de leitura. Para enviar, iniciar, parar, reiniciar, mexer nas variáveis, fazer e baixar backups, baixar e voltar versões dos envios, criar, ligar, desligar e ver a senha dos bancos de dados ou enviar e apagar arquivos do Blob, crie uma chave de leitura e escrita no painel. '404': description: O banco ou o backup não existe ou não é da sua conta. content: application/json: schema: $ref: '#/components/schemas/Error' examples: not_found: summary: not_found value: status: error code: not_found message: Backup não encontrado. '409': description: O backup ainda não está pronto ou não deu certo. content: application/json: schema: $ref: '#/components/schemas/Error' examples: backup_not_ready: summary: backup_not_ready value: status: error code: backup_not_ready message: >- Este backup ainda não está pronto (ou não deu certo). Use outro da lista. '429': description: Limite de pedidos. Traz o cabeçalho `Retry-After`. content: application/json: schema: $ref: '#/components/schemas/Error' examples: rate_limit_exceeded: summary: rate_limit_exceeded value: status: error code: rate_limit_exceeded message: >- A sua conta passou do limite da API do plano Free: 10 pedidos por minuto. Espere 42 s e tente de novo. too_many_attempts: summary: too_many_attempts value: status: error code: too_many_attempts message: Muitas tentativas. Tente de novo em 15 minutos. '503': description: O armazenamento dos backups não respondeu. content: application/json: schema: $ref: '#/components/schemas/Error' examples: backups_unavailable: summary: backups_unavailable value: status: error code: backups_unavailable message: >- Os backups não estão disponíveis agora. Tente de novo em instantes. x-codeSamples: - lang: bash label: curl source: >- LINK=$(curl -s -X POST https://app.cubehosting.com.br/api/databases/$DATABASE_ID/backups/$BACKUP_ID/download \ -H "Authorization: Bearer $CUBE_API_KEY" | jq -r .url) curl -OJ "https://app.cubehosting.com.br/api$LINK" \ -H "Authorization: Bearer $CUBE_API_KEY" - lang: javascript label: Node.js source: >- import { writeFile } from 'node:fs/promises'; const API = 'https://app.cubehosting.com.br/api'; const headers = { Authorization: `Bearer ${process.env.CUBE_API_KEY}` }; const link = await fetch( `${API}/databases/${process.env.DATABASE_ID}/backups/${process.env.BACKUP_ID}/download`, { method: 'POST', headers }, ).then((r) => r.json()); const res = await fetch(API + link.url, { headers }); await writeFile('loja-db.dump', Buffer.from(await res.arrayBuffer())); - lang: python label: Python source: |- import os import requests API = "https://app.cubehosting.com.br/api" headers = {"Authorization": f"Bearer {os.environ['CUBE_API_KEY']}"} link = requests.post( f"{API}/databases/{os.environ['DATABASE_ID']}/backups/{os.environ['BACKUP_ID']}/download", headers=headers, timeout=30, ).json() r = requests.get(API + link["url"], headers=headers, timeout=300) r.raise_for_status() with open("loja-db.dump", "wb") as f: f.write(r.content) components: parameters: DatabaseId: name: id in: path required: true description: >- O ID do banco de dados (26 caracteres), de [Listar bancos de dados](/api-reference/databases/list). schema: type: string pattern: ^[0-9A-HJKMNP-TV-Z]{26}$ example: 01J9A2C4E6G8J0K2M4P6R8T0V2 BackupId: name: backupId in: path required: true description: O ID do backup (UUID), de [Listar backups](/api-reference/backups/list). schema: type: string format: uuid example: 5b0c7a4e-2f1d-4c8e-9a36-7d2b1e0f4c11 schemas: Error: type: object required: - status - code - message properties: status: type: string const: error code: type: string description: Código fixo em inglês. Veja [Códigos de erro](/errors). message: type: string description: Texto em português para mostrar a uma pessoa. additionalProperties: true securitySchemes: bearerAuth: type: http scheme: bearer description: >- Chave de API da Cube (`cube_…`), criada no painel em **Chaves de API**. Mande como `Authorization: Bearer cube_…`. ````