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

obbligatorio

La chiave API del tuo account. Puoi trovarla nelle impostazioni del tuo account.

Object Info restituisce tutto ciò che Blob Storage sa di un file senza scaricarlo: dimensione, content type, scadenza, visibilità, gli header con cui viene servito, il nome file originale e i tuoi metadati. Richiede lo scope blob:read.

string

obbligatorio

L’id del file.

Limiti di frequenza

60 richieste al minuto (RATE_LIMITED, 429).

Risposta

string

“success” in caso di successo, “error” in caso contrario.

object

Mostra Mostra oggetto

string

L’id del file.

number

La dimensione, in byte.

string

Il Content-Type con cui il file viene servito, derivato dalla sua estensione.

string

L’ETag. Cambia quando cambia il contenuto.

ISO 8601

Quando il file è stato scritto. Modificare visibilità, scadenza o header riscrive il file e reimposta questa data.

ISO 8601 | null

Quando il file verrà eliminato, oppure null.

boolean

Se il file è privato.

string | null

L’URL pubblico, oppure null per i file privati.

string | null

L’header Cache-Control, oppure null quando si applica il valore predefinito della CDN.

string | null

L’header Content-Disposition, oppure null.

string | null

Il nome del file così come è stato caricato.

object

I tuoi metadati, come stringhe chiave e valore.

boolean

true per i file legacy, archiviati prima dell’aggiornamento di settembre 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
  }
}

Errori

Codice	HTTP	Quando
`INVALID_OBJECT`	400	`object` manca, è malformato o non ti appartiene.
`OBJECT_NOT_FOUND`	404	Il file non esiste.
`RATE_LIMITED`	429	Più di 60 richieste in un minuto.

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

Primi Passi

Oggetti

Upload a Blocchi

Account

Link di Condivisione

S3

Limiti di frequenza

Risposta

Errori

​Limiti di frequenza

​Risposta

​Errori

Limiti di frequenza

Risposta

Errori