> ## 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.

# Link e condivisione

> URL pubblici, link temporanei e link di condivisione in Blob Storage: quando usare ciascuno, quanto durano e cosa succede quando un file cambia visibilità.

Blob Storage offre tre modi per consegnare un file a qualcuno. Scegli in base a quanto a lungo deve durare il link e se ti serve poterlo ritirare.

|                    | URL pubblico                                                    | Link temporaneo                                         | Link di condivisione                                      |
| ------------------ | --------------------------------------------------------------- | ------------------------------------------------------- | --------------------------------------------------------- |
| Creato da          | [Object Post](/it/blob-reference/endpoint/post) (file pubblici) | [Object Download](/it/blob-reference/endpoint/download) | [Create Share](/it/blob-reference/endpoint/shares-create) |
| Indirizzo          | `blob.squarecloud.dev/pub/...`                                  | `files.squarecloud.dev/d/...`                           | `files.squarecloud.dev/s/...`                             |
| Funziona su        | File pubblici                                                   | File pubblici e privati                                 | File pubblici e privati                                   |
| Durata             | Finché il file è pubblico                                       | Da 60 secondi a 24 ore                                  | Da 60 secondi a 30 giorni                                 |
| Revocabile         | Rendendo il file privato                                        | No                                                      | Sì                                                        |
| Limite di download | No                                                              | No                                                      | Opzionale, da 1 a 10000                                   |
| Password           | No                                                              | No                                                      | Opzionale (Pro ed Enterprise)                             |
| Distribuito da     | CDN globale                                                     | Blob Storage                                            | Blob Storage                                              |

## URL pubblici

Un file pubblico ha un URL permanente sulla CDN:

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

Usalo per gli asset che incorpori: immagini di un sito, allegati di un bot, file recuperati da altri servizi. I file legacy, archiviati prima dell'aggiornamento di settembre 2026, mantengono il loro URL su `https://public-blob.squarecloud.dev/<user_id>/<path>` per 30 giorni, fino al 25 ottobre 2026. Spostali con [Object Copy](/it/blob-reference/endpoint/copy) (`move: true`) per ottenere un URL su `blob.squarecloud.dev`.

<Tip>Con `security_hash=true` (il valore predefinito per i file privati e per gli upload token senza nome), il percorso riceve un suffisso casuale, così l'URL non può essere indovinato a partire dal nome.</Tip>

## Link temporanei

[Object Download](/it/blob-reference/endpoint/download) firma un link a un file, valido da 60 secondi fino a 24 ore (predefinito 1 ora). Usalo per consegnare subito un file privato: un pulsante di download, un allegato email, un file che il tuo backend passa a un altro servizio.

* Il link non richiede credenziali e **non può essere revocato**: smette di funzionare solo quando scade o quando il file viene eliminato, spostato o cambia visibilità. Mantieni breve la durata.
* Supporta `Range` (download riprendibili e ricerca nei video) e le richieste condizionali (`If-None-Match`, `If-Modified-Since`).
* Puoi forzare un download e scegliere il nome con cui il browser salva il file (`disposition` e `filename`).
* Per un file pubblico senza queste personalizzazioni, Object Download restituisce direttamente l'URL pubblico.
* Un link accetta 60 richieste al minuto per IP, oltre a un limite complessivo per tutti i link del tuo account. Oltre questa soglia risponde `429` in testo semplice. Per consegnare un file a molte persone, rendilo pubblico: i file pubblici sono serviti dalla CDN, senza questo limite. Un link scaduto o non valido risponde `404`.

## Link di condivisione

[Create Share](/it/blob-reference/endpoint/shares-create) crea un link con una pagina propria, pensato per le persone più che per i programmi: inviare un file a un cliente, un report a un team, una build a un tester.

* Dura da 60 secondi a 30 giorni (predefinito 24 ore).
* Può essere **revocato** in qualsiasi momento con [Delete Share](/it/blob-reference/endpoint/shares-delete) ed è elencato da [List Shares](/it/blob-reference/endpoint/shares-list).
* `max_downloads` limita quante volte il file può essere scaricato. Il conteggio è esatto, anche con download simultanei. Una volta esaurito, il link risponde `410`.
* Su **Pro ed Enterprise**, una `password` fa sì che la pagina la richieda prima del download. I tentativi errati sono limitati per IP e per link. Un link con password creato prima di un downgrade mantiene la sua password.
* La pagina segue la lingua del browser del visitatore (inglese, portoghese, spagnolo, francese, tedesco, italiano, giapponese e cinese).
* L'account può avere fino a 1000 link di condivisione attivi.
* Il download di un file privato passa per un link temporaneo, con gli stessi limiti: 60 richieste al minuto per IP, più il limite complessivo del tuo account.

Un link di condivisione è legato al file così com'era quando il link è stato creato. Eliminare il file, spostarlo o rinominarlo, oppure cambiarne la visibilità fa sì che il link risponda subito `404`, prima di qualsiasi pagina della password e senza consumare un download. La visita successiva lo rimuove da [List Shares](/it/blob-reference/endpoint/shares-list).

<Warning>
  Un link di condivisione a un file **pubblico** termina con un redirect all'URL pubblico permanente del file. Chi lo apre ottiene quell'URL e può scaricare di nuovo il file senza passare dal link, quindi la password, il limite di download e la scadenza proteggono davvero solo i file **privati**. Quando la protezione conta, condividi un file privato.
</Warning>

## Rendere un file privato o pubblico

Cambia la visibilità con [Object Update](/it/blob-reference/endpoint/update) (`private: true` o `false`), oppure durante la copia con [Object Copy](/it/blob-reference/endpoint/copy).

* L'**id dell'oggetto cambia**: `pub/...` diventa `prv/...` e viceversa. Salva il nuovo `id` restituito nella risposta.
* **Rendere un file privato** rimuove la copia pubblica prima che la richiesta risponda. Il suo URL pubblico smette di funzionare e le cache della CDN lo eliminano in circa 60 secondi. Se la copia pubblica non può essere rimossa, l'oggetto risponde `VISIBILITY_CHANGE_FAILED` e **resta pubblico**, così puoi riprovare.
* **Rendere un file pubblico** richiede un piano a pagamento. Renderlo privato è sempre consentito, anche senza piano.
* I link di condivisione e i link temporanei al file smettono di funzionare, perché puntano al vecchio id. Creane di nuovi per il nuovo id.

<Warning>Un file che era pubblico potrebbe essere stato scaricato o messo in cache da altri prima che tu lo rendessi privato. Carica i file sensibili come privati fin dall'inizio (`private=true`).</Warning>
