Listar enlaces para compartir
curl --request GET \
--url https://blob.vertracloud.app/v1/shares \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://blob.vertracloud.app/v1/shares', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://blob.vertracloud.app/v1/shares"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://blob.vertracloud.app/v1/shares"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"response": [
{
"id": "3e4f5a6b-7c8d-4e9f-a0b1-c2d3e4f5a6b7",
"object_id": "0b6f7c1e-3d2a-4f5b-9a8c-1d2e3f4a5b6c",
"url": "https://vertracloud.app/share/xK3mP9qLwT2vN8rY",
"expires_at": "2026-10-15T12:00:00.000Z",
"max_downloads": 10,
"remaining_downloads": 10,
"has_password": false,
"object_is_public": false,
"created_at": "2026-10-14T12:00:00.000Z"
}
]
}
Enlaces para compartir
Listar enlaces para compartir
Lista los enlaces para compartir de la cuenta, o solo los de un objeto.
GET
/
v1
/
shares
Listar enlaces para compartir
curl --request GET \
--url https://blob.vertracloud.app/v1/shares \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://blob.vertracloud.app/v1/shares', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://blob.vertracloud.app/v1/shares"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://blob.vertracloud.app/v1/shares"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"response": [
{
"id": "3e4f5a6b-7c8d-4e9f-a0b1-c2d3e4f5a6b7",
"object_id": "0b6f7c1e-3d2a-4f5b-9a8c-1d2e3f4a5b6c",
"url": "https://vertracloud.app/share/xK3mP9qLwT2vN8rY",
"expires_at": "2026-10-15T12:00:00.000Z",
"max_downloads": 10,
"remaining_downloads": 10,
"has_password": false,
"object_is_public": false,
"created_at": "2026-10-14T12:00:00.000Z"
}
]
}
Lista los enlaces para compartir de la cuenta, del más reciente al más antiguo. Pasa
object_id para listar solo los enlaces de un objeto. Los enlaces revocados, caducados y agotados (sin descargas disponibles) no aparecen en la lista.
Ámbito: blob:read.
string
Solo los enlaces de este objeto.
string
El ID del workspace, cuando el blob pertenece a un workspace. La llamada actúa sobre el blob del propietario del workspace y necesita el permiso de workspace
blob:read (blob:manage en las rutas que modifican datos). Omítelo para actuar sobre tu propio blob.Ejemplo de petición
curl "https://blob.vertracloud.app/v1/shares?object_id=0b6f7c1e-3d2a-4f5b-9a8c-1d2e3f4a5b6c" \
-H "Authorization: Bearer $VERTRA_API_KEY"
Respuesta
object[]
Los enlaces para compartir.
Mostrar propiedades
Mostrar propiedades
string
ID del enlace para compartir. Úsalo para revocarlo.
string
El objeto al que da acceso el enlace.
string
URL de la página para compartir. Envíala a quien deba descargar el archivo.
string
Momento en que el enlace deja de funcionar, como marca de tiempo ISO 8601.
number | null
Límite de descargas.
null significa sin límite.number | null
Descargas que quedan.
null cuando no hay límite.boolean
Indica si el enlace pide contraseña.
boolean
true cuando el objeto es público. Un objeto público es accesible por su URL, así que el enlace no lo protege.string
Fecha de creación en ISO 8601.
{
"response": [
{
"id": "3e4f5a6b-7c8d-4e9f-a0b1-c2d3e4f5a6b7",
"object_id": "0b6f7c1e-3d2a-4f5b-9a8c-1d2e3f4a5b6c",
"url": "https://vertracloud.app/share/xK3mP9qLwT2vN8rY",
"expires_at": "2026-10-15T12:00:00.000Z",
"max_downloads": 10,
"remaining_downloads": 10,
"has_password": false,
"object_is_public": false,
"created_at": "2026-10-14T12:00:00.000Z"
}
]
}
Respuestas de error
string
El código de error que indica el motivo del fallo. Valores posibles:
AUTH_TOKEN_MISSING(401): No se envió la cabeceraAuthorization.API_KEY_INVALID(401): La clave de API no existe, fue revocada o su secreto no coincide.API_KEY_SCOPE_DENIED(403): La clave no tiene el ámbito que necesita esta ruta (blob:readoblob:write);details.requiredlo indica.WORKSPACE_PERMISSION_DENIED(403): Solo conworkspace_id: no eres miembro o tu rol no tiene el permiso de blob.WORKSPACE_NOT_FOUND(404): Solo conworkspace_id: no existe ningún workspace con ese ID o no eres miembro.VALIDATION_ERROR(400): Un parámetro o campo del cuerpo no superó la validación.details.pathindica el campo.
{
"code": "AUTH_TOKEN_MISSING"
}
{
"code": "API_KEY_SCOPE_DENIED"
}
{
"code": "WORKSPACE_NOT_FOUND"
}
{
"code": "VALIDATION_ERROR"
}
Última modificación el 28 de octubre de 2026