Zum Hauptinhalt springen
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 Hub -Kostenlos
Sales HubSales Hub -Kostenlos
Service HubService Hub -Kostenlos
Content HubContent Hub -Starter
Diese API erfordert einen der folgenden Bereiche:
files
files.ui_hidden.read

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

successful operation

Signed Url object with optional ancillary metadata of requested file

​
extension
string
required

Erweiterung der angeforderten Datei.

​
size
integer
required

Größe in Bytes der angeforderten Datei.

​
name
string
required

Name der angeforderten Datei.

​
type
string
required

Typ der Datei: IMG, DOCUMENT, AUDIO, MOVIE oder OTHER.

​
url
string
required

Signierte URL mit Zugriff auf die angegebene Datei. Jeder, der diese URL kennt, kann auf die Datei zugreifen, bis sie abläuft.

​
expiresAt
string<date-time>
required

Zeitstempel, wann die URL keinen Zugriff mehr auf die Datei gewährt.

​
width
integer

Für Bild- und Videodateien. Die Breite der Datei.

​
height
integer

Für Bild- und Videodateien. Die Höhe der Datei.

⌘I