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

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
fileId
string
required

O ID do arquivo.

Query Parameters

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

Response

successful operation

Signed Url object with optional ancillary metadata of requested file

​
expiresAt
string<date-time>
required

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

​
extension
string
required

Extensão do arquivo solicitado.

​
name
string
required

O nome do arquivo solicitado.

​
size
integer<int64>
required

Tamanho em bytes do arquivo solicitado.

​
type
string
required

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

​
url
string
required

O URL assinado com acesso ao arquivo especificado. Qualquer pessoa com este URL poderá acessar o arquivo até que ele expire.

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