Upload API

Upload ist eine temporäre Ressource, die durch das Hochladen einer Datei entsteht. Als erster Schritt vor dem Erstellen von Media erhalten Sie als Antwort auf einen Upload genau ein Upload zurück, und mit den Informationen dieses Upload erzeugen Sie dann Media. Das Erstellen von Media erfolgt über CMA (Weegloo User) oder ACMA (Service User) und liegt außerhalb des Umfangs dieser Seite.

Upload ist eine temporäre Ressource. 24 Stunden nach der Erstellung läuft sie ab (expiresAt), und wenn sie bis dahin nicht in Media umgewandelt wird, verschwindet sie. Upload kennt kein Veröffentlichungs- oder Versionskonzept (es gibt keine Eigenschaften version, status oder publish). Es gibt auch keine inhaltlichen Felder, sondern nur die Systemeigenschaft sys. Die Basis-URL lautet https://upload.weegloo.com/v1, und jede Anfrage benötigt einen Bearer-Token, der den Upload authentifiziert.

Ressourcenstruktur

Im Folgenden sehen Sie die Antwort eines Upload, bei dem ein Produktfoto eines Bekleidungsgeschäfts (ein Bild eines Trinkbechers) in einen Space hochgeladen wurde. Es enthält nur sys, und darin Schlüssel wie owner, expiresAt und size.

{
  "sys": {
    "id": "4bgMfu7cFGYDRQn4jdqFI8tkOWKZIm",
    "type": "Upload",
    "owner": { "sys": { "id": "HnQ32YiH", "type": "Refer", "targetType": "Space" } },
    "createdBy": { "sys": { "id": "3p4tcFbQRwz503VXdtHXNI5dZH5TVB", "type": "Refer", "targetType": "User" } },
    "createdAt": "2026-06-18T04:48:44.057Z",
    "updatedBy": { "sys": { "id": "3p4tcFbQRwz503VXdtHXNI5dZH5TVB", "type": "Refer", "targetType": "User" } },
    "updatedAt": "2026-06-18T04:48:44.057Z",
    "expiresAt": "2026-06-19T04:48:44.057Z",
    "size": 50847
  }
}

Wichtige Schlüssel:

• sys.id: Der eindeutige Bezeichner des Upload. Diesen Wert übergeben Sie beim Erstellen von Media. Er steht außerdem im {uploadId} der Pfade zum Abrufen und Löschen einzelner Ressourcen.
• sys.owner: Eine Referenz, die angibt, wohin dieses Upload gehört. targetType ist Space oder Organization (siehe unten Space- und Organization-Kontext).
• sys.expiresAt: Der Ablaufzeitpunkt. Er liegt 24 Stunden nach createdAt, und nach diesem Zeitpunkt verschwindet das Upload.
• sys.size: Die Größe der hochgeladenen Datei (in Bytes). Das Beispiel oben ist 50847 Bytes groß.

Systemeigenschaften (sys)

Jedes Upload hält seine Systemeigenschaften im Objekt sys. owner, createdBy und updatedBy haben die Refer-Form ({ "sys": { "id", "type": "Refer", "targetType" } }).

Die 9 oben genannten Eigenschaften sind stets in der Antwort enthalten. version, status und publish, die im sys von Content oder Content Type vorkommen, gibt es bei Upload nicht. Denn Upload ist keine Ressource, die veröffentlicht oder versioniert wird, sondern ein einmaliges Ausgangsmaterial zum Erstellen von Media. owner verweist anders als das space anderer Ressourcen nicht nur auf eine einzige Art, sondern je nach targetType auf einen Space oder eine Organization.

Space- und Organization-Kontext

Upload lässt sich in zwei Kontexten erstellen, und je nach Kontext unterscheiden sich der Pfad und sys.owner.

Ein Upload im Space-Kontext ist das Ausgangsmaterial zum Erstellen von Media dieses Space. Ein Upload im Organization-Kontext verwenden Sie, um Dateien hochzuladen, die wie ein Organisationssymbol direkt für die Organisation genutzt werden. In beiden Fällen ist die als Antwort zurückgegebene Ressourcenstruktur identisch, lediglich der Wert von targetType in sys.owner unterscheidet sich.

Upload-Verfahren: multipart und binary

Für die POST-Anfrage zum Hochladen einer Datei gibt es zwei Verfahren. In beiden Fällen wird dieselbe Upload-Ressource als Antwort zurückgegeben.

Das multipart-Verfahren sendet den Anfragetext als multipart/form-data. Die Datei wird in ein Formularfeld mit dem Namen file gelegt. Es eignet sich für Situationen, in denen als Formulardaten gesendet wird, etwa beim direkten Hochladen aus dem Dateiauswahlfeld eines Browsers.

Das binary-Verfahren legt die rohen Bytes der Datei unverändert in den Anfragetext. Für den Medientyp (Content-Type) des Texts gibt es keine Einschränkung (üblicherweise wird application/octet-stream verwendet), und im Space-Kontext müssen Sie im Header Content-Length die Byte-Länge des Texts mitsenden. Es eignet sich etwa für serverseitigen Code, der ohne Formularstruktur nur die Datei-Bytes überträgt.

API

Die Basis-URL aller folgenden Endpunkte lautet https://upload.weegloo.com/v1, und im Header Authorization wird ein Bearer-Token benötigt, der den Upload authentifiziert. Zuerst werden die 4 Endpunkte des Space-Kontexts behandelt, anschließend die 4 des Organization-Kontexts.

Verwandte Dokumente

• Media: Das Anfrageformat, um mit einem hochgeladenen Upload Media zu erstellen.
• Media (Konzept): Wie Sie Datei-Assets im Content-Studio verwalten.