Abrufen von Metadaten für eine Datei oder einen Ordner

Letzte Aktualisierung: 31. Dezember 2024
  • Themen:

Erstellt für:

  • Entwickler

Gibt Metadaten für die angegebene Datei oder den angegebenen Ordner zurück.

URL

GET /metadata?id=[document or folder ID]

Abfrageparameter

-NameBeschreibung
ID

Die ID der Datei oder des Ordners, auf die bzw. den der Webhook-Anbieter verweist. Dies unterscheidet sich von der Dokument-ID von Adobe Workfront. Um die Metadaten des Stammverzeichnisses abzurufen, verwenden Sie den Wert "/".

Hinweis: Die maximale Länge für die ID beträgt 255 Zeichen.

Antwort

-NameTypBeschreibung
AnredeZeichenfolgeDer Name des Dokuments oder Ordners
ArtZeichenfolgeGibt an, ob es sich bei diesem Element um eine Datei oder einen Ordner ('Datei' oder 'Ordner') handelt
IDZeichenfolgeDie ID der Datei oder des Ordners.
viewLinkZeichenfolgeDer URL-Pfad, der von einem Benutzer zum Anzeigen des Dokuments in einem Browser-Fenster verwendet wird. Die URL kann entweder vom Dokumentanbieter oder vom nativen externen Speicheranbieter gehostet werden.
downloadLinkZeichenfolgeDer URL-Pfad, der von einem Benutzer zum Herunterladen des Dokuments in einem Browser-Fenster verwendet wird. Die URL kann entweder vom Dokumentanbieter oder vom nativen externen Speicheranbieter gehostet werden.
mimeTypeZeichenfolgeDer MIME-Typ für die Datei. (optional)
dateModifiedZeichenfolgeLetzter Änderungszeitpunkt dieser Datei (formatierter RFC 3339-Zeitstempel)
GrößeLangDie Größe der Datei in Byte. (optional)
readOnlyBooleschGibt an, ob diese Datei oder dieser Ordner für den authentifizierten Benutzer schreibgeschützt ist.(optional)

Beispiel: https://www.acme.com/api/metadata?id=12345

{
title:„Mein Dokument“,
kind:„file“
id“:„12345“,
viewLink:“https://www.acme.com/viewDocument?id=12345",
downloadLink:“https://www.acme.com/downloadDocument?id=12345",
mimeType:„image/png“,
dateModified:„20140605T17:39:45.251Z“,
size: „32554694“
}
HINWEIS
Die Fehlerbehandlung sollte bei allen API-Aufrufen konsistent sein. Einzelheiten finden Sie im Abschnitt „Fehlerbehandlung“ weiter unten.
Vorherige SeiteOAuth2-Token abrufen
Nächste SeiteElementliste des Ordnerinhalts abrufen

Workfront