Ressource herunterladen

Lädt die an eine Ressource angehängte Datei herunter. Gibt eine 302-Weiterleitung auf eine kurzlebige, vorsignierte S3-URL zurück — Clients müssen Weiterleitungen folgen, um die Datei abzurufen. Gibt 404 mit dem Code „no_file“ zurück, wenn die Ressource keine Datei hat.

Übergeben Sie ?locale=de, um die Variante für diese Sprache zu erhalten. Hat die Ressource keine Datei für diese Sprache, wird stattdessen die Standarddatei zurückgegeben — der Aufruf schlägt also nicht fehl. So kann ein Client immer die Sprache seiner Leserschaft anfragen, ohne vorher zu prüfen.

Bilder und PDFs öffnen sich standardmäßig im Browser-Tab; mit ?disposition=attachment erzwingen Sie das Speichern.

AuthentifizierungBearer mpt_... or OAuth JWT

Plan-AnforderungPro+

Parameter

Name	Typ	Pflichtfeld	Beschreibung
`model_id`	`String (UUID)`	✓	[Ressource herunterladen] UUID des Modells. Pfadparameter.
`asset_id`	`String (UUID)`	✓	[Ressource herunterladen] UUID der Ressource, deren Datei heruntergeladen werden soll. Pfadparameter.
`locale`	`String`	—	[Ressource herunterladen] Lädt die Variante der Datei für diese Sprache herunter, zum Beispiel `de`. Hat die Ressource keine Datei für diese Sprache, wird stattdessen die Standarddatei zurückgegeben — der Aufruf schlägt nicht fehl. Lassen Sie den Parameter weg, um die Standarddatei zu erhalten.
`disposition`	`String`	—	[Ressource herunterladen] Übergeben Sie `attachment`, damit der Browser die Datei speichert statt sie anzuzeigen. Ohne den Parameter öffnen sich Bilder und PDFs im Tab.

Beispielantwort

HTTP/1.1 302 Found
Location: https://s3.example.com/...presigned...
Cache-Control: no-cache