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

requis

La clé d’API de votre compte. Vous pouvez la trouver dans les paramètres de votre compte.

Chunked Part envoie un chunk d’un upload ouvert avec Chunked Init. Le corps est constitué des octets bruts du chunk, pas de multipart/form-data. Les numéros de part vont de 1 à max_parts (205) et peuvent être envoyés dans n’importe quel ordre ; une part en échec peut simplement être renvoyée avec le même numéro, et ce renvoi est sans risque car les parts sont idempotentes. Chaque chunk sauf le dernier doit être compris entre 5 Mo et 32 Mo ; le dernier peut être plus petit. Envoyez au plus 6 parts en parallèle : une septième part en vol renvoie TOO_MANY_CONCURRENT_CHUNKS, auquel cas attendez qu’une part se termine et réessayez celle-ci. Avec 6 parts en vol, des chunks de 16 Mo sont une bonne valeur par défaut pour un navigateur. Cette route est exemptée du budget d’API global du compte (plan.rate), donc un upload long ne peut pas épuiser votre quota d’API pour le reste de la plateforme. Son propre limiteur autorise 60 parts par 10 secondes, avec un blocage de 10 secondes au-delà.

string

requis

Le jeton upload opaque renvoyé par Chunked Init.

number

requis

Le numéro de part, de 1 à 205. Les parts peuvent être envoyées dans n’importe quel ordre.

binary

requis

Les octets bruts du chunk (Content-Type: application/octet-stream). Pas de multipart/form-data.

Réponse

string

Indique si l’appel a réussi. “success” en cas de succès, “error” sinon.

object

Afficher Afficher l'objet

number

Le numéro de la part qui a été stockée.

number

La taille du chunk stocké, en octets.

string

L’ETag de stockage de la part. Purement informatif : la finalisation relit la liste des parts depuis le stockage, vous ne le renvoyez donc jamais.

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

Dépannage

Lié au 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 autorisé

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

Introuvable

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

Charge utile trop volumineuse

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

Limite de débit atteinte

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

Échec de l’upload

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

Chunked CompleteCette documentation fournit une vue d'ensemble complète de l'endpoint PATCH /v1/objects/chunked de l'API Blob de 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\""
  }
}

Endpoints Blob

Upload par Morceaux

Blob Chunked Upload Part

Réponse

Dépannage

Lié au chunk

Non autorisé

Introuvable

Charge utile trop volumineuse

Limite de débit atteinte

Échec de l’upload

​Réponse

​Dépannage

​Lié au chunk

​Non autorisé

​Introuvable

​Charge utile trop volumineuse

​Limite de débit atteinte

​Échec de l’upload

Réponse

Dépannage

Lié au chunk

Non autorisé

Introuvable

Charge utile trop volumineuse

Limite de débit atteinte

Échec de l’upload