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

obbligatorio

La chiave API del tuo account. Puoi trovarla nelle impostazioni del tuo account.

Chunked Part invia un chunk di un caricamento aperto con Chunked Init. Il body è costituito dai byte grezzi del chunk, non da multipart/form-data. I numeri di parte vanno da 1 a max_parts (205) e possono essere inviati in qualsiasi ordine; una parte fallita può semplicemente essere reinviata con lo stesso numero, e il reinvio è sicuro perché le parti sono idempotenti. Ogni chunk tranne l’ultimo deve essere compreso tra 5 MB e 32 MB; l’ultimo può essere più piccolo. Invia al massimo 6 parti in parallelo: una settima parte in volo restituisce TOO_MANY_CONCURRENT_CHUNKS; in tal caso attendi che una finisca e ritenta quella parte. Con 6 parti in volo, chunk da 16 MB sono un buon default per un browser. Questa route è esente dal budget API dell’intero account (plan.rate), quindi un caricamento lungo non può esaurire la tua quota API per il resto della piattaforma. Il suo limitatore dedicato consente 60 parti ogni 10 secondi, con blocco di 10 secondi oltre quel limite.

string

obbligatorio

Il token upload opaco restituito da Chunked Init.

number

obbligatorio

Il numero della parte, da 1 a 205. Le parti possono essere inviate in qualsiasi ordine.

binary

obbligatorio

I byte grezzi del chunk (Content-Type: application/octet-stream). Non multipart/form-data.

Risposta

string

Indica se la chiamata è andata a buon fine. “success” se riuscita, “error” in caso contrario.

object

Mostra Toggle object

number

Il numero della parte memorizzata.

number

La dimensione del chunk memorizzato, in byte.

string

L’ETag di storage della parte. Solo informativo: il completamento rilegge l’elenco delle parti dallo storage, quindi non lo rinvii mai.

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\""
  }
}

Risoluzione dei problemi

Relativi al chunk

// 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"
}

Non autorizzato

// 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"
}

Non trovato

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

Payload troppo grande

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

Frequenza limitata

// 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"
}

Caricamento fallito

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

Chunked CompleteQuesta documentazione fornisce una panoramica completa dell'endpoint PATCH /v1/objects/chunked dell'API Blob di SquareCloud.

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\""
  }
}

Endpoint Blob

Upload a Blocchi

Blob Chunked Upload Part

Risposta

Risoluzione dei problemi

Relativi al chunk

Non autorizzato

Non trovato

Payload troppo grande

Frequenza limitata

Caricamento fallito

​Risposta

​Risoluzione dei problemi

​Relativi al chunk

​Non autorizzato

​Non trovato

​Payload troppo grande

​Frequenza limitata

​Caricamento fallito

Risposta

Risoluzione dei problemi

Relativi al chunk

Non autorizzato

Non trovato

Payload troppo grande

Frequenza limitata

Caricamento fallito