> ## 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 um arquivo do Blob > O nome, o tamanho, o tipo e a data de um arquivo do Blob. `status` é `pending` enquanto o envio não foi confirmado e `ready` depois. Arquivo de outra conta responde `404`, igual a um que não existe. ## Erros comuns | Código | HTTP | O que fazer | | -------------------------------------------------- | ---- | ----------------------------------------------------------------------- | | [`not_found`](/errors#param-not-found) | 404 | Confira o `id` em [Listar arquivos do Blob](/api-reference/blob/list). | | [`invalid_api_key`](/errors#param-invalid-api-key) | 401 | Confira o cabeçalho `Authorization: Bearer cube_…` ou crie outra chave. | Todos os códigos, com o formato do erro, em [Códigos de erro](/errors). ## OpenAPI ````yaml GET /blob/objects/{id} 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, 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: Variáveis de ambiente - name: Backups - name: Versões dos envios - name: Bancos de dados - name: Blob - name: Domínios - name: Avisos - name: Conta paths: /blob/objects/{id}: get: tags: - Blob summary: Ver um arquivo do Blob description: >- O nome, o tamanho, o tipo e a data de um arquivo. `status` é `pending` enquanto o envio não foi confirmado. operationId: getBlobObject parameters: - $ref: '#/components/parameters/BlobObjectId' responses: '200': description: O arquivo. content: application/json: schema: type: object required: - object properties: object: $ref: '#/components/schemas/BlobObject' example: object: id: 01JA3F7K2M9P4R6T8V0X1Z3B5D path: img/logo.png sizeBytes: 23456 contentType: image/png status: ready createdAt: '2026-09-28T13: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. '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. '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. x-codeSamples: - lang: bash label: curl source: |- curl https://app.cubehosting.com.br/api/blob/objects/$BLOB_ID \ -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}`, { headers }); const { object } = await res.json(); console.log(object.path, object.sizeBytes, object.status); - 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']}", headers=headers, timeout=30) r.raise_for_status() print(r.json()["object"]) 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: BlobObject: type: object required: - id - path - sizeBytes - contentType - status - createdAt properties: id: type: string description: ID do arquivo (26 caracteres). path: type: string description: O nome, com pastas por `/` (`img/logo.png`). sizeBytes: type: integer contentType: type: string description: O tipo mandado no envio (`application/octet-stream` sem ele). status: type: string enum: - pending - ready description: '`pending` até a confirmação do envio.' createdAt: type: string format: date-time description: Quando o envio foi confirmado. 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_…`. ````