GET
/
files
/
v3
/
files
/
{fileId}
/
signed-url
Signierte URL für den Zugriff auf eine private Datei abrufen
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
}
Unterstützte Produkte
Erfordert eines der folgenden Produkte oder höher.
Marketing HubMarketing HubKostenlos
Sales HubSales HubKostenlos
Service HubService HubKostenlos
Content HubContent HubStarter

​
Erforderliche Bereiche

Diese API erfordert einen der folgenden Bereiche:
  • 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 der Datei.

Query Parameters

​
size
enum<string>

Für Bilddateien. Das Bild wird vor der Freigabe in die gewünschte Größe geändert. Die Originaldatei ist davon nicht betroffen, nur die Datei, die über diese signierte URL bereitgestellt wird.

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

Wie lange in Sekunden der Link den Zugriff auf die Datei gewährt.

​
upscale
boolean

Bei Angabe der Größe wird das Bild auf die Größe hochskaliert.

Response

200
application/json

successful operation

Signed Url object with optional ancillary metadata of requested file