Saltar al contenido principal
GET
/
files
/
v3
/
files
/
{fileId}
/
signed-url
Obtener la URL firmada para acceder al archivo privado
curl --request GET \
  --url https://api.hubapi.com/files/v3/files/{fileId}/signed-url \
  --header 'Authorization: Bearer <token>'
{
  "expiresAt": "2023-11-07T05:31:56Z",
  "extension": "<string>",
  "name": "<string>",
  "size": 123,
  "type": "<string>",
  "url": "<string>",
  "height": 123,
  "width": 123
}

Productos compatibles

Se requiere uno de los siguientes productos o productos de ediciones superiores.
Marketing HubMarketing Hub -Gratuito
Sales HubSales Hub -Gratuito
Service HubService Hub -Gratuito
Content HubContent Hub -Gratuito
Esta API requiere uno de los siguientes ámbitos:
files
files.ui_hidden.read

Autorizaciones

​
Authorization
string
header
requerido

The access token received from the authorization server in the OAuth 2.0 flow.

Parámetros de ruta

​
fileId
string
requerido

ID del archivo.

Pattern: \d+

Parámetros de consulta

​
expirationSeconds
integer<int64>

El tiempo en segundos que el enlace proporcionará acceso al archivo.

​
size
enum<string>

Para archivos de imagen. Esto redimensionará la imagen al tamaño deseado antes de compartirla. No afecta al archivo original, solo al archivo servido por esta URL firmada.

Opciones disponibles:
icon,
medium,
preview,
thumb
​
upscale
boolean

Si se proporciona el tamaño, la imagen se ampliará para ajustarse a las dimensiones del tamaño.

Respuesta

successful operation

Signed Url object with optional ancillary metadata of requested file

​
expiresAt
string<date-time>
requerido

Marca de tiempo de cuando la URL ya no otorgará acceso al archivo.

​
extension
string
requerido

Extensión del archivo solicitado.

​
name
string
requerido

Nuevo nombre. Si se especifica, el nombre de la carpeta y el parámetro fullPath cambiarán. Todos los elementos de la carpeta se actualizarán en consecuencia.

​
size
integer<int64>
requerido

Tamaño en bytes del archivo solicitado.

​
type
string
requerido

Tipo de archivo. Puede ser IMG, DOCUMENTO, AUDIO, PELÍCULA u OTRO.

​
url
string
requerido

URL para descargar el nuevo archivo.

​
height
integer<int32>

Para archivos de imagen y video. La altura del archivo.

​
width
integer<int32>

Para archivos de imagen y video. El ancho del archivo.

Last modified on March 19, 2026