Blob Chunked Upload Part

curl --request PUT \
  --url 'https://blob.squarecloud.app/v1/objects/chunked?upload=UPLOAD_TOKEN&part=1' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/octet-stream' \
  --data-binary '@./chunk-1.bin'

const chunk = file.slice(0, 16 * 1024 * 1024); // first 16 MB

const params = new URLSearchParams({ upload: uploadToken, part: '1' });

const response = await fetch(`https://blob.squarecloud.app/v1/objects/chunked?${params}`, {
  method: 'PUT',
  headers: {
    Authorization: 'YOUR_API_KEY',
    'Content-Type': 'application/octet-stream',
  },
  body: chunk,
});

import requests

with open('./bigfile.bin', 'rb') as f:
    chunk = f.read(16 * 1024 * 1024)

response = requests.put(
    'https://blob.squarecloud.app/v1/objects/chunked',
    headers={'Authorization': 'YOUR_API_KEY', 'Content-Type': 'application/octet-stream'},
    params={'upload': upload_token, 'part': 1},
    data=chunk,
)

{
  "status": "success",
  "response": {
    "part": 1,
    "size": 16777216,
    "etag": "\"9bb58f26192e4ba00f01e2e7b136bbd8\""
  }
}

string

requerido

La clave de API de tu cuenta. Puedes encontrarla en la configuración de tu cuenta.

Chunked Part envía un fragmento de una subida abierta con Chunked Init. El cuerpo son los bytes crudos del fragmento, no multipart/form-data. Los números de parte van de 1 a max_parts (205) y pueden enviarse en cualquier orden; una parte fallida puede simplemente reenviarse con el mismo número, y reenviarla es seguro porque las partes son idempotentes. Cada fragmento excepto el último debe estar entre 5 MB y 32 MB; el último puede ser más pequeño. Envía como máximo 6 partes en paralelo: una séptima parte en vuelo devuelve TOO_MANY_CONCURRENT_CHUNKS, en cuyo caso espera a que una termine y reintenta esa parte. Con 6 partes en vuelo, fragmentos de 16 MB son un buen valor por defecto para un navegador. Esta ruta está exenta del presupuesto de API de la cuenta (plan.rate), así que una subida larga no puede agotar tu cuota de API para el resto de la plataforma. Su propio limitador permite 60 partes cada 10 segundos, con bloqueo de 10 segundos al superarlo.

string

requerido

El token upload opaco devuelto por Chunked Init.

number

requerido

El número de parte, de 1 a 205. Las partes pueden enviarse en cualquier orden.

binary

requerido

Los bytes crudos del fragmento (Content-Type: application/octet-stream). No multipart/form-data.

Respuesta

string

Indica si la llamada fue exitosa. “success” si tuvo éxito, “error” si no.

object

Mostrar Alternar objeto

number

El número de la parte que se almacenó.

number

El tamaño del fragmento almacenado, en bytes.

string

El ETag de almacenamiento de la parte. Solo informativo: la finalización vuelve a leer la lista de partes desde el almacenamiento, así que nunca lo envías de vuelta.

curl --request PUT \
  --url 'https://blob.squarecloud.app/v1/objects/chunked?upload=UPLOAD_TOKEN&part=1' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/octet-stream' \
  --data-binary '@./chunk-1.bin'

const chunk = file.slice(0, 16 * 1024 * 1024); // first 16 MB

const params = new URLSearchParams({ upload: uploadToken, part: '1' });

const response = await fetch(`https://blob.squarecloud.app/v1/objects/chunked?${params}`, {
  method: 'PUT',
  headers: {
    Authorization: 'YOUR_API_KEY',
    'Content-Type': 'application/octet-stream',
  },
  body: chunk,
});

import requests

with open('./bigfile.bin', 'rb') as f:
    chunk = f.read(16 * 1024 * 1024)

response = requests.put(
    'https://blob.squarecloud.app/v1/objects/chunked',
    headers={'Authorization': 'YOUR_API_KEY', 'Content-Type': 'application/octet-stream'},
    params={'upload': upload_token, 'part': 1},
    data=chunk,
)

{
  "status": "success",
  "response": {
    "part": 1,
    "size": 16777216,
    "etag": "\"9bb58f26192e4ba00f01e2e7b136bbd8\""
  }
}

Solución de problemas

Relacionado con el fragmento

// The upload token is missing, malformed, or does not belong to your account.
{
    "status": "error",
    "code": "INVALID_UPLOAD_TOKEN"
}

// The part number must be an integer between 1 and 205.
{
    "status": "error",
    "code": "INVALID_CHUNK_PART"
}

// The chunk body was empty.
{
    "status": "error",
    "code": "EMPTY_CHUNK"
}

No autorizado

// The API key is missing or invalid. Set a valid key in the Authorization header.
{
    "status": "error",
    "code": "ACCESS_DENIED"
}

// The account has no active paid plan. Uploading to Blob Storage requires a paid plan.
{
    "status": "error",
    "code": "PERMISSION_DENIED"
}

No encontrado

// The upload was already completed, aborted, or expired.
{
    "status": "error",
    "code": "UPLOAD_NOT_FOUND"
}

Carga útil demasiado grande

// Each chunk accepts up to 32 MB.
{
    "status": "error",
    "code": "CHUNK_TOO_LARGE"
}

Límite de tasa alcanzado

// Part rate limit reached (60 parts per 10s window, blocked for 10s).
{
    "status": "error",
    "code": "RATE_LIMITED"
}

// At most 6 chunks may be in flight at a time. Wait for one to finish, then retry this part.
{
    "status": "error",
    "code": "TOO_MANY_CONCURRENT_CHUNKS"
}

Fallo en la subida

// Failed to upload the chunk. Retry this part.
{
    "status": "error",
    "code": "UPLOAD_FAILED"
}

Chunked CompleteEsta documentación ofrece una descripción completa del endpoint PATCH /v1/objects/chunked de la API de SquareCloud Blob.

curl --request PUT \
  --url 'https://blob.squarecloud.app/v1/objects/chunked?upload=UPLOAD_TOKEN&part=1' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/octet-stream' \
  --data-binary '@./chunk-1.bin'

const chunk = file.slice(0, 16 * 1024 * 1024); // first 16 MB

const params = new URLSearchParams({ upload: uploadToken, part: '1' });

const response = await fetch(`https://blob.squarecloud.app/v1/objects/chunked?${params}`, {
  method: 'PUT',
  headers: {
    Authorization: 'YOUR_API_KEY',
    'Content-Type': 'application/octet-stream',
  },
  body: chunk,
});

import requests

with open('./bigfile.bin', 'rb') as f:
    chunk = f.read(16 * 1024 * 1024)

response = requests.put(
    'https://blob.squarecloud.app/v1/objects/chunked',
    headers={'Authorization': 'YOUR_API_KEY', 'Content-Type': 'application/octet-stream'},
    params={'upload': upload_token, 'part': 1},
    data=chunk,
)

{
  "status": "success",
  "response": {
    "part": 1,
    "size": 16777216,
    "etag": "\"9bb58f26192e4ba00f01e2e7b136bbd8\""
  }
}

Endpoints de Blob

Subida en Partes

Blob Chunked Upload Part

Respuesta

Solución de problemas

Relacionado con el fragmento

No autorizado

No encontrado

Carga útil demasiado grande

Límite de tasa alcanzado

Fallo en la subida

​Respuesta

​Solución de problemas

​Relacionado con el fragmento

​No autorizado

​No encontrado

​Carga útil demasiado grande

​Límite de tasa alcanzado

​Fallo en la subida

Respuesta

Solución de problemas

Relacionado con el fragmento

No autorizado

No encontrado

Carga útil demasiado grande

Límite de tasa alcanzado

Fallo en la subida