Blob Create Share

POST

curl --request POST \
  --url 'https://blob.squarecloud.app/v1/shares' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "object": "prv/3155597145698959364/reports/q3_mugws5c0-9f86d081884c7d659a2feaa0c55ad015.pdf",
    "expires_in": 604800,
    "max_downloads": 5
  }'

const response = await fetch('https://blob.squarecloud.app/v1/shares', {
  method: 'POST',
  headers: {
    Authorization: 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    object: 'prv/3155597145698959364/reports/q3_mugws5c0-9f86d081884c7d659a2feaa0c55ad015.pdf',
    expires_in: 7 * 24 * 60 * 60,
    max_downloads: 5,
  }),
});

{
  "status": "success",
  "response": {
    "id": "q8Zr2LwX7nT0vKc4Hs1YbA",
    "url": "https://files.squarecloud.dev/s/q8Zr2LwX7nT0vKc4Hs1YbA",
    "expires_at": "2026-10-02T12:00:00.000Z",
    "max_downloads": 5,
    "password": false,
    "object": "prv/3155597145698959364/reports/q3_mugws5c0-9f86d081884c7d659a2feaa0c55ad015.pdf",
    "object_is_public": false
  }
}

string

obbligatorio

La chiave API del tuo account. Puoi trovarla nelle impostazioni del tuo account.

Create Share crea un link (https://files.squarecloud.dev/s/...) per consegnare un file a delle persone: un cliente, un team, un tester. Funziona per file pubblici e privati, dura fino a 30 giorni, può essere revocato in qualsiasi momento e può limitare quante volte il file viene scaricato. Su Pro ed Enterprise può anche richiedere una password. Richiede lo scope blob:write. Aprire il link scarica il file. Un link protetto da password mostra prima una pagina che chiede la password, nella lingua del visitatore. Il link è legato all’id attuale del file: eliminare, spostare o cambiare la visibilità del file fa sì che risponda subito 404, senza consumare un download. Vedi Link e condivisione per il confronto con i link temporanei.

string

obbligatorio

L’id del file da condividere.

number

predefinito:"86400"

Quanto dura il link, da 60 a 2592000 secondi (30 giorni).

number

Quanti download consente il link, da 1 a 10000. Una volta esauriti, risponde 410. Senza di esso, non c’è limite.

string

Una password da 8 a 128 caratteri che il visitatore deve digitare prima di scaricare. Solo Pro ed Enterprise.

Per un file pubblico il link reindirizza al suo URL pubblico permanente, che chiunque lo apra può continuare a usare. La password, il limite di download e la scadenza proteggono davvero solo i file privati.

Limiti

30 link al minuto (RATE_LIMITED, 429), e fino a 1000 link attivi per account (TOO_MANY_SHARES, 409).
Ogni link accetta 120 visite al minuto per IP. Le password errate sono limitate per IP e per link.
Il download di un file privato passa per un link temporaneo: 60 richieste al minuto per IP, più il limite complessivo del tuo account. Per consegnare un file a molte persone, rendilo pubblico.

Risposta

Risponde 201 Created.

string

“success” in caso di successo, “error” in caso contrario.

object

Mostra Mostra oggetto

string

L’id della condivisione. Usalo con Delete Share.

string

Il link da distribuire.

ISO 8601

Quando scade il link.

number | null

Il limite di download, oppure null.

boolean

Se il link richiede una password.

string

L’id del file condiviso.

boolean

true quando il file è pubblico: chiunque abbia il suo URL pubblico può comunque scaricarlo, quindi revocare, limitare o proteggere la condivisione non restringe l’accesso al file stesso.

curl --request POST \
  --url 'https://blob.squarecloud.app/v1/shares' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "object": "prv/3155597145698959364/reports/q3_mugws5c0-9f86d081884c7d659a2feaa0c55ad015.pdf",
    "expires_in": 604800,
    "max_downloads": 5
  }'

const response = await fetch('https://blob.squarecloud.app/v1/shares', {
  method: 'POST',
  headers: {
    Authorization: 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    object: 'prv/3155597145698959364/reports/q3_mugws5c0-9f86d081884c7d659a2feaa0c55ad015.pdf',
    expires_in: 7 * 24 * 60 * 60,
    max_downloads: 5,
  }),
});

{
  "status": "success",
  "response": {
    "id": "q8Zr2LwX7nT0vKc4Hs1YbA",
    "url": "https://files.squarecloud.dev/s/q8Zr2LwX7nT0vKc4Hs1YbA",
    "expires_at": "2026-10-02T12:00:00.000Z",
    "max_downloads": 5,
    "password": false,
    "object": "prv/3155597145698959364/reports/q3_mugws5c0-9f86d081884c7d659a2feaa0c55ad015.pdf",
    "object_is_public": false
  }
}

Errori

Codice	HTTP	Quando
`INVALID_OBJECT`	400	`object` manca, è malformato o non ti appartiene.
`INVALID_EXPIRES_IN`	400	`expires_in` non è un intero da 60 a 2592000.
`INVALID_MAX_DOWNLOADS`	400	`max_downloads` non è un intero da 1 a 10000.
`INVALID_PASSWORD`	400	La password non ha da 8 a 128 caratteri.
`UPGRADE_REQUIRED`	403	Le password richiedono Pro o Enterprise.
`OBJECT_NOT_FOUND`	404	Il file non esiste.
`TOO_MANY_SHARES`	409	L’account ha 1000 link attivi. Revocane alcuni prima.
`RATE_LIMITED`	429	Più di 30 link in un minuto.

curl --request POST \
  --url 'https://blob.squarecloud.app/v1/shares' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "object": "prv/3155597145698959364/reports/q3_mugws5c0-9f86d081884c7d659a2feaa0c55ad015.pdf",
    "expires_in": 604800,
    "max_downloads": 5
  }'

const response = await fetch('https://blob.squarecloud.app/v1/shares', {
  method: 'POST',
  headers: {
    Authorization: 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    object: 'prv/3155597145698959364/reports/q3_mugws5c0-9f86d081884c7d659a2feaa0c55ad015.pdf',
    expires_in: 7 * 24 * 60 * 60,
    max_downloads: 5,
  }),
});

{
  "status": "success",
  "response": {
    "id": "q8Zr2LwX7nT0vKc4Hs1YbA",
    "url": "https://files.squarecloud.dev/s/q8Zr2LwX7nT0vKc4Hs1YbA",
    "expires_at": "2026-10-02T12:00:00.000Z",
    "max_downloads": 5,
    "password": false,
    "object": "prv/3155597145698959364/reports/q3_mugws5c0-9f86d081884c7d659a2feaa0c55ad015.pdf",
    "object_is_public": false
  }
}

Primi Passi

Oggetti

Upload a Blocchi

Account

Link di Condivisione

S3

Limiti

Risposta

Errori

​Limiti

​Risposta

​Errori

Limiti

Risposta

Errori