Informações do Objeto Blob

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

obrigatório

A chave da API para sua conta. Você pode encontrá-la nas configurações da conta.

O Informações do Objeto retorna tudo o que o Blob Storage sabe sobre um arquivo sem baixá-lo: tamanho, content type, expiração, visibilidade, os cabeçalhos com que ele é servido, o nome original do arquivo e os seus metadados. Exige o escopo blob:read.

string

obrigatório

O id do arquivo.

Limites de taxa

60 requisições por minuto (RATE_LIMITED, 429).

Resposta

string

“success” se bem-sucedida, “error” caso contrário.

object

Mostrar Alternar objeto

string

O id do arquivo.

number

O tamanho, em bytes.

string

O Content-Type com que o arquivo é servido, derivado da extensão.

string

O ETag. Ele muda quando o conteúdo muda.

ISO 8601

Quando o arquivo foi gravado. Alterar a visibilidade, a expiração ou os cabeçalhos regrava o arquivo e redefine esta data.

ISO 8601 | null

Quando o arquivo será excluído, ou null.

boolean

Se o arquivo é privado.

string | null

A URL pública, ou null para arquivos privados.

string | null

O cabeçalho Cache-Control, ou null quando vale o padrão da CDN.

string | null

O cabeçalho Content-Disposition, ou null.

string | null

O nome do arquivo como foi enviado.

object

Os seus metadados, como strings de chave e valor.

boolean

true para arquivos legados, armazenados antes da atualização de setembro 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
  }
}

Erros

Código	HTTP	Quando
`INVALID_OBJECT`	400	`object` está ausente, malformado ou não é seu.
`OBJECT_NOT_FOUND`	404	O arquivo não existe.
`RATE_LIMITED`	429	Mais de 60 requisições em um 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
  }
}

Primeiros Passos

Objetos

Uploads em Partes

Conta

Links de Compartilhamento

S3

Informações do Objeto Blob

Limites de taxa

Resposta

Erros

​Limites de taxa

​Resposta

​Erros

Limites de taxa

Resposta

Erros