Skip to main content
Blob Storage tiene tres formas de entregar un archivo a alguien. Elige según cuánto tiempo debe vivir el enlace y si necesitas poder retirarlo.

​
URL públicas

Un archivo público tiene una URL permanente en la CDN:
Úsala para recursos que incrustas: imágenes en un sitio, adjuntos en un bot, archivos que otros servicios descargan. Los archivos heredados, almacenados antes de la actualización de septiembre de 2026, conservan su URL en https://public-blob.squarecloud.dev/<user_id>/<path> durante 30 días, hasta el 25 de octubre de 2026. Muévelos con Object Copy (move: true) para obtener una URL en blob.squarecloud.dev.
Con security_hash=true (el valor por defecto para archivos privados y para tokens de subida sin nombre), la ruta recibe un sufijo aleatorio, así que la URL no se puede adivinar a partir del nombre.

​
Enlaces temporales

Object Download firma un enlace a un archivo, válido de 60 segundos a 24 horas (1 hora por defecto). Úsalo para entregar un archivo privado en este momento: un botón de descarga, un adjunto de correo, un archivo que tu backend pasa a otro servicio.
  • El enlace no necesita credenciales y no se puede revocar: solo deja de funcionar cuando expira o cuando el archivo se elimina, se mueve o cambia de visibilidad. Mantén la duración corta.
  • Admite Range (descargas reanudables y avance en vídeos) y solicitudes condicionales (If-None-Match, If-Modified-Since).
  • Puedes forzar una descarga y elegir el nombre de archivo con el que el navegador lo guarda (disposition y filename).
  • Para un archivo público sin esas opciones, Object Download devuelve la propia URL pública.
  • Un enlace acepta 60 solicitudes por minuto por IP, además de un límite general para todos los enlaces de tu cuenta. Por encima de eso responde 429 en texto plano. Para entregar un archivo a muchas personas, hazlo público: los archivos públicos los sirve la CDN, sin este límite. Un enlace expirado o no válido responde 404.

​
Enlaces compartidos

Create Share crea un enlace con su propia página, pensado para personas y no para programas: enviar un archivo a un cliente, un informe a un equipo, una build a un tester.
  • Dura de 60 segundos a 30 días (24 horas por defecto).
  • Se puede revocar en cualquier momento con Delete Share, y aparece en List Shares.
  • max_downloads limita cuántas veces se puede descargar el archivo. El conteo es exacto, incluso con descargas simultáneas. Cuando se agota, el enlace responde 410.
  • En Pro y Enterprise, un password hace que la página lo pida antes de la descarga. Los intentos fallidos están limitados por IP y por enlace. Un enlace con contraseña creado antes de bajar de plan conserva su contraseña.
  • La página sigue el idioma del navegador del visitante (inglés, portugués, español, francés, alemán, italiano, japonés y chino).
  • La cuenta puede tener hasta 1000 enlaces compartidos activos.
  • La descarga de un archivo privado pasa por un enlace temporal, con los mismos límites: 60 solicitudes por minuto por IP, más el límite general de tu cuenta.
Un enlace compartido está ligado al archivo tal como era cuando se creó el enlace. Eliminar el archivo, moverlo o renombrarlo, o cambiar su visibilidad hace que el enlace responda 404 de inmediato, antes de cualquier página de contraseña y sin gastar una descarga. La siguiente visita lo quita de List Shares.
Un enlace compartido a un archivo público termina en una redirección a la URL pública permanente del archivo. Quien lo abre obtiene esa URL y puede volver a descargar el archivo sin pasar por el enlace, así que la contraseña, el límite de descargas y la expiración solo protegen de verdad los archivos privados. Cuando la protección importa, comparte un archivo privado.

​
Hacer un archivo privado o público

Cambia la visibilidad con Object Update (private: true o false), o al copiar con Object Copy.
  • El id del objeto cambia: pub/... pasa a ser prv/... y viceversa. Guarda el nuevo id de la respuesta.
  • Hacer privado un archivo elimina la copia pública antes de que la solicitud responda. Su URL pública deja de funcionar, y las cachés de la CDN la descartan en unos 60 segundos. Si la copia pública no se puede eliminar, el objeto responde VISIBILITY_CHANGE_FAILED y sigue siendo público, para que puedas reintentar.
  • Hacer público un archivo requiere un plan activo. Hacerlo privado siempre está permitido, incluso sin plan.
  • Los enlaces compartidos y los enlaces temporales al archivo dejan de funcionar, ya que apuntan al id antiguo. Crea otros nuevos para el nuevo id.
Un archivo que fue público puede haber sido descargado o almacenado en caché por otros antes de que lo hicieras privado. Sube los archivos sensibles como privados desde el principio (private=true).