Signiertes Asset herunterladen
Generierte Referenz für GET /assets/{asset_id}/content: Authentifizierung, Felder, Antworten, Fehler und sichere Nutzung.
Auf dieser Seite
Operation
GET /assets/{asset_id}/content
operationId: download_asset_v1_assets__asset_id__content_get
Lädt Bytes über die vollständig in der Asset-Antwort gelieferte signierte URL. Füge keinen Bearer-Header hinzu. Erfinde keine Signatur und leite keine Zugangsdaten an den Speicher weiter. Je nach Bereitstellung folgen Bytes oder HTTP 302. Abgelaufene oder ungültige Signaturen ergeben NOT_FOUND; erneuere sie über GET /assets/{asset_id}.
Authentifizierung und Nebenwirkungen
Verwende die vollständig zurückgegebene signierte URL ohne Bearer-Schlüssel.
Diese Operation startet keine kostenpflichtige Generierung. Andere Zustandsänderungen sind oben beschrieben.
Parameter
| Parameter | Position | Typ | Erforderlich | Einschränkungen / Standardwert | Bedeutung |
|---|---|---|---|---|---|
asset_id |
path |
string |
Ja | format: uuid |
Owned public resource UUID; task, asset, and file IDs are not interchangeable. |
expires |
query |
integer |
Ja | exclusiveMinimum: 0 |
Use the value in the returned signed URL; never invent or log it. |
signature |
query |
string |
Ja | minLength: 64; maxLength: 64 |
Use the value in the returned signed URL; never invent or log it. |
Antworten
| HTTP | Inhalt | Bedeutung |
|---|---|---|
200 |
string |
Asset bytes; Content-Type depends on the asset. |
302 |
— | Redirect to short-lived storage URL; do not forward credentials. |
400 |
APIErrorEnvelope | Invalid input; correct the request before retrying. |
404 |
APIErrorEnvelope | Resource is unavailable, not owned, or its signature is invalid/expired. |
500 |
APIErrorEnvelope | Internal failure; preserve the task/key and retry only when marked retryable. |
503 |
APIErrorEnvelope | Service/provider unavailable; retry only when error.retryable is true. |
Antwort-Header
| HTTP | Header | Typ | Bedeutung |
|---|---|---|---|
302 |
Location |
string |
Short-lived storage download URL. |
Weiterführende Anleitungen
Statusabfragen und Downloads · Fehler und sichere Wiederholungen
War diese Seite hilfreich?
Es werden keine Suchbegriffe, Codes oder Freitexte erfasst. Dieser Schalter steuert nur Dokumentationsinteraktionen; allgemeine Website-Analysen folgen der Datenschutzerklärung. Datenschutzerklärung