> ## 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 as URLs das partes
> As URLs para mandar cada parte do envio direto ao armazenamento.
Em [Pedir o envio](/api-reference/blob/create), mande `isMultipart: true`. A resposta traz `upload.partSizeBytes` (16 MB) e `upload.partCount`.
Até 100 números de parte por pedido. Cada URL vale 1 hora e só aceita o tamanho da parte (`sizeBytes`): a parte `n` começa no byte `(n - 1) × partSizeBytes`. Faça o `PUT` sem a chave de API.
Com todas enviadas, chame [Confirmar o envio](/api-reference/blob/complete).
A parte que falhou no meio vai de novo: peça a URL dela outra vez e mande, que a nova troca a anterior. Para saber o que já chegou, use [Ver as partes que chegaram](/api-reference/blob/parts-list).
## Erros comuns
| Código | HTTP | O que fazer |
| - | - | - |
| [`invalid_request`](/errors#param-invalid-request) | 400 | Mande de 1 a 100 números de parte, cada um de 1 a `partCount`. |
| [`not_multipart`](/errors#param-not-multipart) | 409 | Peça o envio com `isMultipart: true`. |
| [`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` do envio. |
Todos os códigos, com o formato do erro, em [Códigos de erro](/errors).
## OpenAPI
````yaml POST /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:
post:
tags:
- Blob
summary: Pedir as URLs das partes
description: >-
As URLs para mandar cada parte direto ao armazenamento com `PUT` (sem a
chave de API), de 1 a 100 por pedido. Cada URL vale 1 hora e só aceita o
tamanho da parte (`sizeBytes`): todas têm `partSizeBytes`, menos a
última, com o resto. Mandar a mesma parte de novo troca a anterior: é
assim que a parte que caiu no meio vai outra vez. Com todas enviadas,
chame [Confirmar o envio](/api-reference/blob/complete).
operationId: createBlobUploadPartUrls
parameters:
- $ref: '#/components/parameters/BlobObjectId'
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- partNumbers
properties:
partNumbers:
type: array
minItems: 1
maxItems: 100
items:
type: integer
minimum: 1
description: Os números das partes, de 1 a `partCount`.
example:
partNumbers:
- 1
- 2
- 3
responses:
'200':
description: As URLs das partes pedidas.
content:
application/json:
schema:
$ref: '#/components/schemas/BlobPartUrls'
example:
parts:
- partNumber: 1
sizeBytes: 16777216
url: >-
https://…/accounts/…/blob/01JA3F7K2M9P4R6T8V0X1Z3B5D?partNumber=1&uploadId=…&X-Amz-Expires=3600&X-Amz-SignedHeaders=content-length%3Bhost&X-Amz-Signature=…
expiresAt: '2026-09-30T14:10:02.000Z'
'400':
description: '`partNumbers` fora do formato ou com uma parte que o envio não tem.'
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
examples:
invalid_request:
summary: invalid_request
value:
status: error
code: invalid_request
message: >-
Mande partNumbers: de 1 a 100 números de parte, cada um de
1 a 3.
'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: >-
URLS=$(curl -s -X POST
https://app.cubehosting.com.br/api/blob/objects/$BLOB_ID/parts \
-H "Authorization: Bearer $CUBE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"partNumbers": [1]}')
# A parte 1 são os primeiros 16 MB do arquivo, sem a chave de API.
head -c 16777216 aula.mp4 | curl -X PUT "$(echo "$URLS" | jq -r
'.parts[0].url')" --data-binary @-
- lang: javascript
label: Node.js
source: >-
import { readFile } from 'node:fs/promises';
const API = 'https://app.cubehosting.com.br/api';
const headers = { Authorization: `Bearer
${process.env.CUBE_API_KEY}` };
const PART = 16 * 1024 * 1024;
const file = await readFile('aula.mp4');
const res = await
fetch(`${API}/blob/objects/${process.env.BLOB_ID}/parts`, {
method: 'POST',
headers: { ...headers, 'Content-Type': 'application/json' },
body: JSON.stringify({ partNumbers: [1, 2, 3] }),
});
const { parts } = await res.json();
for (const p of parts) {
const start = (p.partNumber - 1) * PART;
await fetch(p.url, { method: 'PUT', body: file.subarray(start, start + p.sizeBytes) });
}
await fetch(`${API}/blob/objects/${process.env.BLOB_ID}/complete`, {
method: 'POST', headers });
- 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']}"}
PART = 16 * 1024 * 1024
r =
requests.post(f"{API}/blob/objects/{os.environ['BLOB_ID']}/parts",
headers=headers, json={"partNumbers": [1, 2, 3]}, timeout=30)
r.raise_for_status()
with open("aula.mp4", "rb") as f:
for p in r.json()["parts"]:
f.seek((p["partNumber"] - 1) * PART)
requests.put(p["url"], data=f.read(p["sizeBytes"]), timeout=3600).raise_for_status()
requests.post(f"{API}/blob/objects/{os.environ['BLOB_ID']}/complete",
headers=headers, timeout=30).raise_for_status()
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:
BlobPartUrls:
type: object
required:
- parts
- expiresAt
properties:
parts:
type: array
items:
type: object
required:
- partNumber
- sizeBytes
- url
properties:
partNumber:
type: integer
sizeBytes:
type: integer
description: 'O tamanho exato da parte: a URL só aceita esse.'
url:
type: string
format: uri
description: >-
A URL do `PUT` da parte, direto no armazenamento (sem a chave
de API).
expiresAt:
type: string
format: date-time
description: Até quando as URLs valem (1 hora, ou o que falta das 24 horas).
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_…`.
````