Zum Hauptinhalt springen
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>'
{
  "extension": "<string>",
  "size": 123,
  "name": "<string>",
  "width": 123,
  "type": "<string>",
  "url": "<string>",
  "expiresAt": "2023-11-07T05:31:56Z",
  "height": 123
}
Produtos suportados
Requer um dos seguintes produtos ou superior.
Marketing HubMarketing HubGrátis
Sales HubSales HubGrátis
Service HubService HubGrátis
Content HubContent HubStarter

​
Escopos Necessários

Esta API requer um dos seguintes escopos:
  • 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

O ID do arquivo.

Query Parameters

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

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

Por quantos segundos o link fornecerá acesso ao arquivo.

​
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

​
extension
string
required

Extensão do arquivo solicitado.

​
size
integer
required

Tamanho em bytes do arquivo solicitado.

​
name
string
required

O nome 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.

​
expiresAt
string<date-time>
required

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

​
width
integer

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

​
height
integer

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

⌘I