Pular para o conteúdo principal
GET
/
files
/
v3
/
files
/
{fileId}
/
signed-url
Obtenha o URL assinado para acessar o arquivo 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
}

Produtos suportados

Requer um dos seguintes produtos ou superior.
Marketing HubMarketing Hub -Grátis
Sales HubSales Hub -Grátis
Service HubService Hub -Grátis
Content HubContent Hub -Grátis
Esta API requer um dos seguintes escopos:
files
files.ui_hidden.read

Autorizações

​
Authorization
string
header
obrigatório

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

Parâmetros de caminho

​
fileId
string
obrigatório

O ID do arquivo.

Pattern: \d+

Parâmetros de consulta

​
expirationSeconds
integer<int64>

Por quantos segundos o link fornecerá acesso ao arquivo.

​
size
enum<string>

Para arquivos de imagem. Redimensionará a imagem para o tamanho desejado antes de compartilhar. Não afeta o arquivo original, apenas o arquivo atendido por este URL assinado.

Opções disponíveis:
icon,
medium,
preview,
thumb
​
upscale
boolean

Se o tamanho for fornecido, aumentará a imagem para se ajustar às dimensões do tamanho.

Resposta

successful operation

Signed Url object with optional ancillary metadata of requested file

​
expiresAt
string<date-time>
obrigatório

A data e hora em que o URL deixará de conceder acesso ao arquivo.

​
extension
string
obrigatório

Extensão do arquivo solicitado.

​
name
string
obrigatório

O novo nome. Se especificado, o nome da pasta e fullPath serão alterados. Todos os objetos secundários serão atualizados de acordo.

​
size
integer<int64>
obrigatório

Tamanho em bytes do arquivo solicitado.

​
type
string
obrigatório

O tipo do arquivo. Pode ser IMG, DOCUMENT, AUDIO, MOVIE ou OTHER.

​
url
string
obrigatório

O URL do qual baixar o novo arquivo.

​
height
integer<int32>

Para arquivos de imagem e vídeo. A altura do arquivo.

​
width
integer<int32>

Para arquivos de imagem e vídeo. A largura do arquivo.

Last modified on March 24, 2026