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

requerido

La clave de API de tu cuenta. Puedes encontrarla en la configuración de tu cuenta.

Object Info devuelve todo lo que Blob Storage sabe sobre un archivo sin descargarlo: tamaño, tipo de contenido, expiración, visibilidad, las cabeceras con las que se sirve, el nombre de archivo original y tus metadatos. Requiere el scope blob:read.

string

requerido

El id del archivo.

Límites de tasa

60 solicitudes por minuto (RATE_LIMITED, 429).

Respuesta

string

“success” si tuvo éxito, “error” si no.

object

Mostrar Alternar objeto

string

El id del archivo.

number

El tamaño, en bytes.

string

El Content-Type con el que se sirve el archivo, derivado de su extensión.

string

El ETag. Cambia cuando cambia el contenido.

ISO 8601

Cuándo se escribió el archivo. Cambiar la visibilidad, la expiración o las cabeceras reescribe el archivo y reinicia esta fecha.

ISO 8601 | null

Cuándo se eliminará el archivo, o null.

boolean

Si el archivo es privado.

string | null

La URL pública, o null para los archivos privados.

string | null

La cabecera Cache-Control, o null cuando se aplica el valor por defecto de la CDN.

string | null

La cabecera Content-Disposition, o null.

string | null

El nombre del archivo tal como se subió.

object

Tus metadatos, como pares de strings clave y valor.

boolean

true para los archivos heredados, almacenados antes de la actualización de septiembre de 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
  }
}

Errores

Código	HTTP	Cuándo
`INVALID_OBJECT`	400	`object` falta, está mal formado o no es tuyo.
`OBJECT_NOT_FOUND`	404	El archivo no existe.
`RATE_LIMITED`	429	Más de 60 solicitudes en 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
  }
}

Primeros Pasos

Objetos

Subida en Partes

Cuenta

Enlaces Compartidos

S3

Límites de tasa

Respuesta

Errores

​Límites de tasa

​Respuesta

​Errores

Límites de tasa

Respuesta

Errores