> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Blob Chunked Upload Status

> Sieh mit GET /v1/objects/chunked, welche Teile eines Chunked Uploads bereits angekommen sind, um einen unterbrochenen Upload fortzusetzen.

<ParamField header="Authorization" type="string" placeholder="API Key" required>
  Der API-Schlüssel für Ihr Konto. Sie finden ihn in Ihren [Kontoeinstellungen](https://squarecloud.app/de/account/security).
</ParamField>

Chunked Status listet die Teile eines offenen Uploads auf, die bereits gespeichert sind. Nutze den Endpoint, um nach einem Absturz, einer verlorenen Verbindung oder einem Neuladen der Seite **fortzufahren**: Sende nur die fehlenden Teile mit [Chunked Part](/de/blob-reference/endpoint/chunked-part) und rufe dann [Chunked Complete](/de/blob-reference/endpoint/chunked-complete) auf. Erfordert den Scope `blob:write`.

Wenn du auch das `upload`-Token verloren hast, listet [Open Uploads](/de/blob-reference/endpoint/chunked-open) jeden offenen Upload des Kontos mit seinem Token auf.

<ParamField query="upload" type="string" required>
  Das von Chunked Init zurückgegebene `upload`-Token.
</ParamField>

### Rate Limits

<Note>10 Requests pro 10 Sekunden (`RATE_LIMITED`, 429). Nutze sie, um einen Upload fortzusetzen, nicht um den Fortschritt abzufragen: Dein Client weiß bereits, welche Teile er gesendet hat.</Note>

### Antwort

<ResponseField name="status" type="string">
  "success" bei Erfolg, "error" bei Misserfolg.
</ResponseField>

<ResponseField name="response" type="object">
  <Expandable title="Objekt umschalten">
    <ResponseField name="id" type="string">
      Die id, die die Datei nach dem Abschluss haben wird.
    </ResponseField>

    <ResponseField name="parts" type="array">
      Die gespeicherten Teile, jeweils als `{ "part", "size", "etag" }`.
    </ResponseField>

    <ResponseField name="next_part" type="number">
      Die niedrigste Teilnummer, die noch nicht gespeichert ist.
    </ResponseField>

    <ResponseField name="size_so_far" type="number">
      Die bisher insgesamt gespeicherten Bytes.
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
    --url 'https://blob.squarecloud.app/v1/objects/chunked?upload=UPLOAD_TOKEN' \
    --header 'Authorization: YOUR_API_KEY'
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "status": "success",
    "response": {
      "id": "prv/3155597145698959364/genomics/dataset_mugws5c0-3c59dc048e8850243be8079a5c74d079.fastq.gz",
      "parts": [
        { "part": 1, "size": 16777216, "etag": "\"9bb58f26192e4ba00f01e2e7b136bbd8\"" },
        { "part": 2, "size": 16777216, "etag": "\"4a2f0b1c9d8e7f6a5b4c3d2e1f0a9b8c\"" },
        { "part": 4, "size": 16777216, "etag": "\"e1f0a9b8c4a2f0b1c9d8e7f6a5b4c3d2\"" }
      ],
      "next_part": 3,
      "size_so_far": 50331648
    }
  }
  ```
</ResponseExample>

### Fehler

| Code                   | HTTP | Wann                                                             |
| ---------------------- | ---- | ---------------------------------------------------------------- |
| `INVALID_UPLOAD_TOKEN` | 400  | Das `upload`-Token fehlt, ist fehlerhaft oder gehört nicht dir.  |
| `UPLOAD_NOT_FOUND`     | 404  | Der Upload wurde abgeschlossen, abgebrochen oder ist abgelaufen. |
| `RATE_LIMITED`         | 429  | Mehr als 10 Requests in 10 Sekunden.                             |