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

requis

La clé d’API de votre compte. Vous pouvez la trouver dans les paramètres de votre compte.

Object Info renvoie tout ce que Blob Storage sait d’un fichier sans le télécharger : taille, type de contenu, expiration, visibilité, les en-têtes avec lesquels il est servi, le nom de fichier d’origine et vos métadonnées. Nécessite le scope blob:read.

string

requis

L’id du fichier.

Limites de débit

60 requêtes par minute (RATE_LIMITED, 429).

Réponse

string

“success” en cas de succès, “error” sinon.

object

Afficher Afficher l'objet

string

L’id du fichier.

number

La taille, en octets.

string

Le Content-Type avec lequel le fichier est servi, dérivé de son extension.

string

L’ETag. Il change lorsque le contenu change.

ISO 8601

Date à laquelle le fichier a été écrit. Changer la visibilité, l’expiration ou les en-têtes réécrit le fichier et réinitialise cette date.

ISO 8601 | null

Date à laquelle le fichier sera supprimé, ou null.

boolean

Indique si le fichier est privé.

string | null

L’URL publique, ou null pour les fichiers privés.

string | null

L’en-tête Cache-Control, ou null lorsque la valeur par défaut du CDN s’applique.

string | null

L’en-tête Content-Disposition, ou null.

string | null

Le nom du fichier tel qu’il a été envoyé.

object

Vos métadonnées, sous forme de chaînes clé et valeur.

boolean

true pour les fichiers hérités, stockés avant la mise à jour de septembre 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
  }
}

Erreurs

Code	HTTP	Quand
`INVALID_OBJECT`	400	`object` est absent, mal formé ou ne vous appartient pas.
`OBJECT_NOT_FOUND`	404	Le fichier n’existe pas.
`RATE_LIMITED`	429	Plus de 60 requêtes en une 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
  }
}

Premiers Pas

Objets

Upload par Morceaux

Compte

Liens de Partage

S3

Limites de débit

Réponse

Erreurs

​Limites de débit

​Réponse

​Erreurs

Limites de débit

Réponse

Erreurs