> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Enlaces y uso compartido

> URL públicas, enlaces temporales y enlaces compartidos en Blob Storage: cuándo usar cada uno, cuánto duran y qué ocurre cuando un archivo cambia de visibilidad.

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ública                                                         | Enlace temporal                                         | Enlace compartido                                         |
| ------------------- | ------------------------------------------------------------------- | ------------------------------------------------------- | --------------------------------------------------------- |
| Creado por          | [Object Post](/es/blob-reference/endpoint/post) (archivos públicos) | [Object Download](/es/blob-reference/endpoint/download) | [Create Share](/es/blob-reference/endpoint/shares-create) |
| Dirección           | `blob.squarecloud.dev/pub/...`                                      | `files.squarecloud.dev/d/...`                           | `files.squarecloud.dev/s/...`                             |
| Funciona con        | Archivos públicos                                                   | Archivos públicos y privados                            | Archivos públicos y privados                              |
| Duración            | Mientras el archivo sea público                                     | De 60 segundos a 24 horas                               | De 60 segundos a 30 días                                  |
| Se puede revocar    | Haciendo privado el archivo                                         | No                                                      | Sí                                                        |
| Límite de descargas | No                                                                  | No                                                      | Opcional, de 1 a 10000                                    |
| Contraseña          | No                                                                  | No                                                      | Opcional (Pro y Enterprise)                               |
| Servido desde       | CDN global                                                          | Blob Storage                                            | Blob Storage                                              |

## URL públicas

Un archivo público tiene una URL permanente en la CDN:

```
https://blob.squarecloud.dev/pub/<user_id>/<path>
```

Ú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](/es/blob-reference/endpoint/copy) (`move: true`) para obtener una URL en `blob.squarecloud.dev`.

<Tip>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.</Tip>

## Enlaces temporales

[Object Download](/es/blob-reference/endpoint/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](/es/blob-reference/endpoint/shares-create) 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](/es/blob-reference/endpoint/shares-delete), y aparece en [List Shares](/es/blob-reference/endpoint/shares-list).
* `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](/es/blob-reference/endpoint/shares-list).

<Warning>
  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.
</Warning>

## Hacer un archivo privado o público

Cambia la visibilidad con [Object Update](/es/blob-reference/endpoint/update) (`private: true` o `false`), o al copiar con [Object Copy](/es/blob-reference/endpoint/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 de pago. 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.

<Warning>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`).</Warning>
