Listar enlaces compartidos

GET

curl --request GET \
  --url 'https://blob.squarecloud.app/v1/shares' \
  --header 'Authorization: YOUR_API_KEY'

{
  "status": "success",
  "response": {
    "shares": [
      {
        "id": "q8Zr2LwX7nT0vKc4Hs1YbA",
        "url": "https://files.squarecloud.dev/s/q8Zr2LwX7nT0vKc4Hs1YbA",
        "object": "prv/3155597145698959364/reports/q3_mugws5c0-9f86d081884c7d659a2feaa0c55ad015.pdf",
        "expires_at": "2026-10-02T12:00:00.000Z",
        "remaining_downloads": 3,
        "password": false,
        "created_at": "2026-09-25T12:00:00.000Z"
      }
    ]
  }
}

string

requerido

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

List Shares devuelve todos los enlaces compartidos de la cuenta que no han expirado ni se han revocado, con cuántas descargas le quedan a cada uno. Requiere el scope blob:read. Un enlace cuyo archivo se eliminó, se movió o cambió de visibilidad sale de la lista la primera vez que alguien lo abre.

Límites de tasa

20 solicitudes por minuto (RATE_LIMITED, 429).

Respuesta

string

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

object

Mostrar Alternar objeto

array

Mostrar Alternar objeto

string

El id del enlace compartido.

string

El enlace.

string

El id del archivo compartido.

ISO 8601

Cuándo expira el enlace.

number | null

Descargas restantes, o null cuando no hay límite.

boolean

Si el enlace pide una contraseña.

ISO 8601

Cuándo se creó el enlace.

curl --request GET \
  --url 'https://blob.squarecloud.app/v1/shares' \
  --header 'Authorization: YOUR_API_KEY'

{
  "status": "success",
  "response": {
    "shares": [
      {
        "id": "q8Zr2LwX7nT0vKc4Hs1YbA",
        "url": "https://files.squarecloud.dev/s/q8Zr2LwX7nT0vKc4Hs1YbA",
        "object": "prv/3155597145698959364/reports/q3_mugws5c0-9f86d081884c7d659a2feaa0c55ad015.pdf",
        "expires_at": "2026-10-02T12:00:00.000Z",
        "remaining_downloads": 3,
        "password": false,
        "created_at": "2026-09-25T12:00:00.000Z"
      }
    ]
  }
}

Errores

Código	HTTP	Cuándo
`RATE_LIMITED`	429	Más de 20 solicitudes en un minuto.

Relacionado

SDK de Blob: blob.shares.list()

curl --request GET \
  --url 'https://blob.squarecloud.app/v1/shares' \
  --header 'Authorization: YOUR_API_KEY'

{
  "status": "success",
  "response": {
    "shares": [
      {
        "id": "q8Zr2LwX7nT0vKc4Hs1YbA",
        "url": "https://files.squarecloud.dev/s/q8Zr2LwX7nT0vKc4Hs1YbA",
        "object": "prv/3155597145698959364/reports/q3_mugws5c0-9f86d081884c7d659a2feaa0c55ad015.pdf",
        "expires_at": "2026-10-02T12:00:00.000Z",
        "remaining_downloads": 3,
        "password": false,
        "created_at": "2026-09-25T12:00:00.000Z"
      }
    ]
  }
}

Primeros pasos

Objetos

Subidas por partes

Cuenta

Enlaces compartidos

S3

Listar enlaces compartidos

Límites de tasa

Respuesta

Errores

Relacionado

​Límites de tasa

​Respuesta

​Errores

​Relacionado

Límites de tasa

Respuesta

Errores

Relacionado