> ## 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. # Pedir o link de download > Um link de 5 minutos para baixar o backup em .zip. O link vale 5 minutos e só com a mesma chave, que precisa ser de **leitura e escrita**: o `.zip` traz todos os arquivos do projeto, inclusive o `.env`. Use em seguida com [Baixar o backup](/api-reference/backups/download). ## OpenAPI ````yaml POST /projects/{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 e faça e baixe backups. 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 paths: /projects/{id}/backups/{backupId}/download: post: tags: - Backups summary: Pedir o link de download description: >- Devolve o endereço para baixar o backup em `.zip`. O link vale **5 minutos** e só com a mesma chave (ou a mesma sessão do painel): com outra conta, responde `404`. Só backups `ready`. Pede a chave de **leitura e escrita**: o `.zip` traz todos os arquivos do projeto, inclusive o `.env`. operationId: createBackupDownloadLink parameters: - $ref: '#/components/parameters/ProjectId' - $ref: '#/components/parameters/BackupId' responses: '200': description: O link, relativo ao endereço da API. content: application/json: schema: type: object required: - url - expiresAt properties: url: type: string description: >- Caminho para o `GET` do download, com `expires` e `signature`. Junte ao endereço da API. expiresAt: type: string format: date-time description: Até quando o link vale (5 minutos). example: url: >- /projects/01J8Z3W6N0Q4Y7V2K5T9D1H3XA/backups/5b0c7a4e-2f1d-4c8e-9a36-7d2b1e0f4c11/download?expires=1790530000000&signature=… expiresAt: '2026-09-27T18:05:00.000Z' '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: A chave é só de leitura. content: application/json: schema: $ref: '#/components/schemas/Error' examples: 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 ou fazer e baixar backups, crie uma chave de leitura e escrita no painel. '404': description: O projeto 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). Espere terminar ou use outro. '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: >- curl -X POST https://app.cubehosting.com.br/api/projects/$PROJECT_ID/backups/$BACKUP_ID/download \ -H "Authorization: Bearer $CUBE_API_KEY" - lang: javascript label: Node.js source: >- const API = 'https://app.cubehosting.com.br/api'; const headers = { Authorization: `Bearer ${process.env.CUBE_API_KEY}` }; const res = await fetch( `${API}/projects/${process.env.PROJECT_ID}/backups/${process.env.BACKUP_ID}/download`, { method: 'POST', headers }, ); const { url, expiresAt } = await res.json(); console.log(url, expiresAt); - 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']}"} r = requests.post( f"{API}/projects/{os.environ['PROJECT_ID']}/backups/{os.environ['BACKUP_ID']}/download", headers=headers, timeout=30, ) r.raise_for_status() print(r.json()["url"]) components: parameters: ProjectId: name: id in: path required: true description: >- O ID do projeto (26 caracteres). Aparece no painel, no topo do projeto, e em `GET /projects`. schema: type: string pattern: ^[0-9A-HJKMNP-TV-Z]{26}$ example: 01J8Z3W6N0Q4Y7V2K5T9D1H3XA 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_…`. ````