Freigabelinks auflisten

GET

curl --request GET \
  --url 'https://blob.squarecloud.app/v1/shares' \
  --header 'Authorization: YOUR_API_KEY'

{
  "status": "success",
  "response": {
    "shares": [
      {
        "id": "q8Zr2LwX7nT0vKc4Hs1YbA",
        "url": "https://files.squarecloud.dev/s/q8Zr2LwX7nT0vKc4Hs1YbA",
        "object": "prv/3155597145698959364/reports/q3_mugws5c0-9f86d081884c7d659a2feaa0c55ad015.pdf",
        "expires_at": "2026-10-02T12:00:00.000Z",
        "remaining_downloads": 3,
        "password": false,
        "created_at": "2026-09-25T12:00:00.000Z"
      }
    ]
  }
}

string

erforderlich

Der API-Schlüssel für dein Konto. Du findest ihn in deinen Kontoeinstellungen.

List Shares gibt jeden Freigabelink des Kontos zurück, der weder abgelaufen noch widerrufen ist, zusammen mit der Anzahl der verbleibenden Downloads. Erfordert den Scope blob:read. Ein Link, dessen Datei gelöscht, verschoben oder in ihrer Sichtbarkeit geändert wurde, verschwindet aus der Liste, sobald ihn jemand zum ersten Mal öffnet.

Rate Limits

20 Requests pro Minute (RATE_LIMITED, 429).

Antwort

string

“success” bei Erfolg, “error” bei Misserfolg.

object

Anzeigen Objekt umschalten

array

Anzeigen Objekt umschalten

string

Die Freigabe-id.

string

Der Link.

string

Die id der freigegebenen Datei.

ISO 8601

Wann der Link abläuft.

number | null

Verbleibende Downloads oder null, wenn es kein Limit gibt.

boolean

Ob der Link ein Passwort abfragt.

ISO 8601

Wann der Link erstellt wurde.

curl --request GET \
  --url 'https://blob.squarecloud.app/v1/shares' \
  --header 'Authorization: YOUR_API_KEY'

{
  "status": "success",
  "response": {
    "shares": [
      {
        "id": "q8Zr2LwX7nT0vKc4Hs1YbA",
        "url": "https://files.squarecloud.dev/s/q8Zr2LwX7nT0vKc4Hs1YbA",
        "object": "prv/3155597145698959364/reports/q3_mugws5c0-9f86d081884c7d659a2feaa0c55ad015.pdf",
        "expires_at": "2026-10-02T12:00:00.000Z",
        "remaining_downloads": 3,
        "password": false,
        "created_at": "2026-09-25T12:00:00.000Z"
      }
    ]
  }
}

Fehler

Code	HTTP	Wann
`RATE_LIMITED`	429	Mehr als 20 Requests in einer Minute.

Siehe auch

Blob SDK: blob.shares.list()

curl --request GET \
  --url 'https://blob.squarecloud.app/v1/shares' \
  --header 'Authorization: YOUR_API_KEY'

{
  "status": "success",
  "response": {
    "shares": [
      {
        "id": "q8Zr2LwX7nT0vKc4Hs1YbA",
        "url": "https://files.squarecloud.dev/s/q8Zr2LwX7nT0vKc4Hs1YbA",
        "object": "prv/3155597145698959364/reports/q3_mugws5c0-9f86d081884c7d659a2feaa0c55ad015.pdf",
        "expires_at": "2026-10-02T12:00:00.000Z",
        "remaining_downloads": 3,
        "password": false,
        "created_at": "2026-09-25T12:00:00.000Z"
      }
    ]
  }
}

Erste Schritte

Objekte

Chunked-Uploads

Konto

Freigabelinks

S3

Freigabelinks auflisten

Rate Limits

Antwort

Fehler

Siehe auch

​Rate Limits

​Antwort

​Fehler

​Siehe auch

Rate Limits

Antwort

Fehler

Siehe auch