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>'
{
  "expiresAt": "2023-11-07T05:31:56Z",
  "extension": "<string>",
  "name": "<string>",
  "size": 123,
  "type": "<string>",
  "url": "<string>",
  "height": 123,
  "width": 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 -Kostenlos

Autorisierungen

​
Authorization
string
header
erforderlich

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

Pfadparameter

​
fileId
string
erforderlich

ID der Datei.

Abfrageparameter

​
expirationSeconds
integer<int64>

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

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

Verfügbare Optionen:
icon,
medium,
preview,
thumb
​
upscale
boolean

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

Antwort

successful operation

Signed Url object with optional ancillary metadata of requested file

​
expiresAt
string<date-time>
erforderlich

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

​
extension
string
erforderlich

Erweiterung der angeforderten Datei.

​
name
string
erforderlich

Name der angeforderten Datei.

​
size
integer<int64>
erforderlich

Größe in Bytes der angeforderten Datei.

​
type
string
erforderlich

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

​
url
string
erforderlich

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

​
height
integer<int32>

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

​
width
integer<int32>

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

Last modified on December 8, 2025