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
Diese API erfordert einen der folgenden Bereiche:
files
files.ui_hidden.read

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.

Pattern: \d+

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

Neuer Name. Sofern angegeben, werden „name“ und „fullPath“ des Ordners geändert. Alle Unterordner des Ordners werden entsprechend aktualisiert.

​
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

URL, über die die neue Datei heruntergeladen werden soll.

​
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 February 12, 2026