Skip to main content
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 pubblici

Un file pubblico ha un URL permanente sulla CDN:
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 (move: true) per ottenere un URL su blob.squarecloud.dev.
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.
Object 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.
Create Share 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 ed è elencato da List Shares.
  • 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.
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.

​
Rendere un file privato o pubblico

Cambia la visibilità con Object Update (private: true o false), oppure durante la copia con Object 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 attivo. 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.
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).