Skip to main content
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>'
{
  "extension": "<string>",
  "size": 123,
  "name": "<string>",
  "width": 123,
  "type": "<string>",
  "url": "<string>",
  "expiresAt": "2023-11-07T05:31:56Z",
  "height": 123
}
Productos compatibles
Se requiere uno de los siguientes productos o productos de ediciones superiores.
Marketing HubMarketing HubGratuito
Sales HubSales HubGratuito
Service HubService HubGratuito
Content HubContent HubStarter

​
Ámbitos Requeridos

Esta API requiere uno de los siguientes ámbitos:
  • files.ui_hidden.read
  • files

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
fileId
string
required

ID del archivo.

Query Parameters

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

Available options:
thumb,
icon,
medium,
preview
​
expirationSeconds
integer

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

​
upscale
boolean

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

Response

successful operation

Signed Url object with optional ancillary metadata of requested file

​
extension
string
required

Extensión del archivo solicitado.

​
size
integer
required

Tamaño en bytes del archivo solicitado.

​
name
string
required

Nombre del archivo solicitado.

​
type
string
required

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

​
url
string
required

URL firmado con acceso al archivo especificado. Cualquier persona con este URL podrá acceder al archivo hasta que expire.

​
expiresAt
string<date-time>
required

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

​
width
integer

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

​
height
integer

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

⌘I