Blob Object Info

GET

objects

info

curl --request GET \
  --url 'https://blob.squarecloud.app/v1/objects/info?object=pub/3155597145698959364/images/logo_mugws5c0-9f86d081884c7d659a2feaa0c55ad015.png' \
  --header 'Authorization: YOUR_API_KEY'

{
  "status": "success",
  "response": {
    "id": "pub/3155597145698959364/images/logo_mugws5c0-9f86d081884c7d659a2feaa0c55ad015.png",
    "size": 416230,
    "content_type": "image/png",
    "etag": "\"9bb58f26192e4ba00f01e2e7b136bbd8\"",
    "created_at": "2026-09-25T12:00:00.000Z",
    "expires_at": null,
    "private": false,
    "url": "https://blob.squarecloud.dev/pub/3155597145698959364/images/logo_mugws5c0-9f86d081884c7d659a2feaa0c55ad015.png",
    "cache_control": "public, max-age=31536000, immutable",
    "content_disposition": null,
    "original_name": "logo.png",
    "metadata": { "campaign": "spring" },
    "legacy": false
  }
}

string

erforderlich

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

Object Info gibt alles zurück, was Blob Storage über eine Datei weiß, ohne sie herunterzuladen: Größe, Content-Type, Ablauf, Sichtbarkeit, die Header, mit denen sie ausgeliefert wird, den ursprünglichen Dateinamen und deine Metadaten. Erfordert den Scope blob:read.

string

erforderlich

Die id der Datei.

Rate Limits

60 Requests pro Minute (RATE_LIMITED, 429).

Antwort

string

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

object

Anzeigen Objekt umschalten

string

Die id der Datei.

number

Die Größe in Bytes.

string

Der Content-Type, mit dem die Datei ausgeliefert wird, bestimmt aus ihrer Endung.

string

Das ETag. Es ändert sich, wenn sich der Inhalt ändert.

ISO 8601

Wann die Datei geschrieben wurde. Das Ändern von Sichtbarkeit, Ablauf oder Headern schreibt die Datei neu und setzt dieses Datum zurück.

ISO 8601 | null

Wann die Datei gelöscht wird, oder null.

boolean

Ob die Datei privat ist.

string | null

Die öffentliche URL oder null bei privaten Dateien.

string | null

Der Header Cache-Control oder null, wenn der CDN-Standard gilt.

string | null

Der Header Content-Disposition oder null.

string | null

Der Name der Datei, wie sie hochgeladen wurde.

object

Deine Metadaten, als Schlüssel-Wert-Strings.

boolean

true für Legacy-Dateien, gespeichert vor dem Update im September 2026.

curl --request GET \
  --url 'https://blob.squarecloud.app/v1/objects/info?object=pub/3155597145698959364/images/logo_mugws5c0-9f86d081884c7d659a2feaa0c55ad015.png' \
  --header 'Authorization: YOUR_API_KEY'

{
  "status": "success",
  "response": {
    "id": "pub/3155597145698959364/images/logo_mugws5c0-9f86d081884c7d659a2feaa0c55ad015.png",
    "size": 416230,
    "content_type": "image/png",
    "etag": "\"9bb58f26192e4ba00f01e2e7b136bbd8\"",
    "created_at": "2026-09-25T12:00:00.000Z",
    "expires_at": null,
    "private": false,
    "url": "https://blob.squarecloud.dev/pub/3155597145698959364/images/logo_mugws5c0-9f86d081884c7d659a2feaa0c55ad015.png",
    "cache_control": "public, max-age=31536000, immutable",
    "content_disposition": null,
    "original_name": "logo.png",
    "metadata": { "campaign": "spring" },
    "legacy": false
  }
}

Fehler

Code	HTTP	Wann
`INVALID_OBJECT`	400	`object` fehlt, ist fehlerhaft oder gehört nicht dir.
`OBJECT_NOT_FOUND`	404	Die Datei existiert nicht.
`RATE_LIMITED`	429	Mehr als 60 Requests in einer Minute.

curl --request GET \
  --url 'https://blob.squarecloud.app/v1/objects/info?object=pub/3155597145698959364/images/logo_mugws5c0-9f86d081884c7d659a2feaa0c55ad015.png' \
  --header 'Authorization: YOUR_API_KEY'

{
  "status": "success",
  "response": {
    "id": "pub/3155597145698959364/images/logo_mugws5c0-9f86d081884c7d659a2feaa0c55ad015.png",
    "size": 416230,
    "content_type": "image/png",
    "etag": "\"9bb58f26192e4ba00f01e2e7b136bbd8\"",
    "created_at": "2026-09-25T12:00:00.000Z",
    "expires_at": null,
    "private": false,
    "url": "https://blob.squarecloud.dev/pub/3155597145698959364/images/logo_mugws5c0-9f86d081884c7d659a2feaa0c55ad015.png",
    "cache_control": "public, max-age=31536000, immutable",
    "content_disposition": null,
    "original_name": "logo.png",
    "metadata": { "campaign": "spring" },
    "legacy": false
  }
}

Erste Schritte

Objekte

Chunked-Uploads

Konto

Freigabelinks

S3

Rate Limits

Antwort

Fehler

​Rate Limits

​Antwort

​Fehler

Rate Limits

Antwort

Fehler