> ## 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. # Ver as partes que chegaram > No envio em partes, as partes que já chegaram: para continuar, mande só as que faltam. Use para continuar um envio em partes que caiu no meio (a conexão, o script que parou): compare `parts` com `partCount` e mande só as que faltam, pelas [URLs das partes](/api-reference/blob/parts-create). Uma parte que chegou com o tamanho errado não aparece aqui. O envio vale 24 horas desde o pedido (`expiresAt`). ## Erros comuns | Código | HTTP | O que fazer | | - | - | - | | [`not_multipart`](/errors#param-not-multipart) | 409 | Peça o envio com `isMultipart: true` em [Pedir o envio](/api-reference/blob/create). | | [`upload_expired`](/errors#param-upload-expired) | 409 | O envio passou das 24 horas: peça de novo. | | [`not_found`](/errors#param-not-found) | 404 | Confira o `id` da resposta de [Pedir o envio](/api-reference/blob/create). | | [`insufficient_permission`](/errors#param-insufficient-permission) | 403 | Use uma chave de leitura e escrita ou Só Blob. | Todos os códigos, com o formato do erro, em [Códigos de erro](/errors). ## OpenAPI ````yaml GET /blob/objects/{id}/parts 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, veja a análise das visitas dos sites, 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, use um domínio seu nos sites 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: Análise - name: Variáveis de ambiente - name: Backups - name: Versões dos envios - name: Bancos de dados - name: Blob - name: Domínios - name: Templates - name: Avisos - name: Conta paths: /blob/objects/{id}/parts: get: tags: - Blob summary: Ver as partes que chegaram description: >- No envio em partes (`isMultipart: true` em [Pedir o envio](/api-reference/blob/create)), as partes que já chegaram ao armazenamento com o tamanho certo. Para continuar um envio que caiu (a conexão, ou o script que parou), mande só as que não estão aqui e confirme. O envio vale 24 horas desde o pedido (`expiresAt`). operationId: listBlobUploadParts parameters: - $ref: '#/components/parameters/BlobObjectId' responses: '200': description: As partes que chegaram. content: application/json: schema: $ref: '#/components/schemas/BlobParts' example: parts: - partNumber: 1 sizeBytes: 16777216 - partNumber: 3 sizeBytes: 8388608 partSizeBytes: 16777216 partCount: 3 expiresAt: '2026-10-01T13:10:02.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, fazer, baixar e restaurar backups, baixar e voltar versões dos envios, criar, ligar, desligar, fazer backup 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 arquivo não existe ou não é da sua conta (a mesma resposta para os dois). content: application/json: schema: $ref: '#/components/schemas/Error' examples: not_found: summary: not_found value: status: error code: not_found message: Arquivo não encontrado no Blob. '409': description: >- O arquivo não está sendo enviado em partes, ou o envio passou das 24 horas. content: application/json: schema: $ref: '#/components/schemas/Error' examples: not_multipart: summary: not_multipart value: status: error code: not_multipart message: >- Este arquivo não está sendo enviado em partes. Confira o id ou peça o envio com isMultipart: true. upload_expired: summary: upload_expired value: status: error code: upload_expired message: >- Este envio em partes passou das 24 horas e foi cancelado. Envie o arquivo de novo. '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 do Blob não respondeu. Nada mudou. content: application/json: schema: $ref: '#/components/schemas/Error' examples: blob_unavailable: summary: blob_unavailable value: status: error code: blob_unavailable message: >- O Blob não está disponível agora. Tente de novo em instantes. x-codeSamples: - lang: bash label: curl source: >- curl https://app.cubehosting.com.br/api/blob/objects/$BLOB_ID/parts \ -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}/blob/objects/${process.env.BLOB_ID}/parts`, { headers }); const { parts, partCount } = await res.json(); const done = new Set(parts.map((p) => p.partNumber)); const missing = Array.from({ length: partCount }, (_, i) => i + 1).filter((n) => !done.has(n)); console.log(missing); - 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.get(f"{API}/blob/objects/{os.environ['BLOB_ID']}/parts", headers=headers, timeout=30) r.raise_for_status() body = r.json() done = {p["partNumber"] for p in body["parts"]} print([n for n in range(1, body["partCount"] + 1) if n not in done]) components: parameters: BlobObjectId: name: id in: path required: true description: >- O ID do arquivo do Blob (26 caracteres), de [Listar arquivos do Blob](/api-reference/blob/list). schema: type: string pattern: ^[0-9A-HJKMNP-TV-Z]{26}$ example: 01JA3F7K2M9P4R6T8V0X1Z3B5D schemas: BlobParts: type: object required: - parts - partSizeBytes - partCount - expiresAt properties: parts: type: array description: As partes que chegaram com o tamanho certo. items: type: object required: - partNumber - sizeBytes properties: partNumber: type: integer sizeBytes: type: integer partSizeBytes: type: integer partCount: type: integer expiresAt: type: string format: date-time description: Até quando o envio vale (24 horas desde o pedido). 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_…`. ````