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

erforderlich

Der API-Schlüssel für Ihr Konto. Sie finden ihn in Ihren Kontoeinstellungen.

Chunked Part sendet einen Chunk eines mit Chunked Init geöffneten Uploads. Der Body sind die rohen Bytes des Chunks, nicht multipart/form-data. Teilnummern laufen von 1 bis max_parts (205) und dürfen in beliebiger Reihenfolge gesendet werden; ein fehlgeschlagener Teil kann einfach mit derselben Nummer erneut gesendet werden, und erneutes Senden ist sicher, weil Teile idempotent sind. Jeder Chunk außer dem letzten muss zwischen 5 MB und 32 MB groß sein; der letzte darf kleiner sein. Sende höchstens 6 Teile parallel: Ein siebter gleichzeitig laufender Teil liefert TOO_MANY_CONCURRENT_CHUNKS zurück; warte in dem Fall, bis einer fertig ist, und wiederhole diesen Teil. Mit 6 parallelen Teilen sind 16-MB-Chunks ein guter Standardwert für einen Browser. Diese Route ist vom kontoweiten API-Budget (plan.rate) ausgenommen, sodass ein langer Upload dein API-Kontingent für den Rest der Plattform nicht erschöpfen kann. Ihr eigener Limiter erlaubt 60 Teile pro 10 Sekunden, darüber hinaus für 10 Sekunden blockiert.

string

erforderlich

Das opake upload-Token, das Chunked Init zurückgegeben hat.

number

erforderlich

Die Teilnummer, von 1 bis 205. Teile dürfen in beliebiger Reihenfolge gesendet werden.

binary

erforderlich

Die rohen Chunk-Bytes (Content-Type: application/octet-stream). Nicht multipart/form-data.

Response

string

Gibt an, ob der Aufruf erfolgreich war. “success” bei Erfolg, “error” andernfalls.

object

Anzeigen Objekt ein-/ausblenden

number

Die Teilnummer, die gespeichert wurde.

number

Die Größe des gespeicherten Chunks, in Bytes.

string

Das Storage-ETag des Teils. Nur informativ: Der Abschluss liest die Teileliste aus dem Storage zurück, du sendest es also nie zurück.

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

Fehlerbehebung

Chunkbezogen

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

Nicht autorisiert

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

Nicht gefunden

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

Payload zu groß

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

Rate-limitiert

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

Upload fehlgeschlagen

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

Zurück

Chunked CompleteDiese Dokumentation bietet einen umfassenden Überblick über den Endpoint PATCH /v1/objects/chunked der SquareCloud Blob API.

Weiter

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

Blob-Endpunkte

Chunked-Uploads

Blob Chunked Upload Part

Response

Fehlerbehebung

Chunkbezogen

Nicht autorisiert

Nicht gefunden

Payload zu groß

Rate-limitiert

Upload fehlgeschlagen

​Response

​Fehlerbehebung

​Chunkbezogen

​Nicht autorisiert

​Nicht gefunden

​Payload zu groß

​Rate-limitiert

​Upload fehlgeschlagen

Response

Fehlerbehebung

Chunkbezogen

Nicht autorisiert

Nicht gefunden

Payload zu groß

Rate-limitiert

Upload fehlgeschlagen