Upload-Token erstellen
Erstelle mit POST /v1/upload-tokens ein kurzlebiges Upload-Token, damit ein Browser ohne deinen API-Schlüssel direkt in Blob Storage hochladen kann.
POST
Der API-Schlüssel für dein Konto. Du findest ihn in deinen Kontoeinstellungen.
blob:write und einen aktiven Plan.
Das Token kommt in den Header Authorization von Object Post oder den Routen des Chunked Uploads und funktioniert nirgendwo sonst (403 UPLOAD_TOKEN_NOT_ALLOWED). Alles, was du beim Erstellen festlegst, ist fixiert: Der Browser kann Name, Präfix, Sichtbarkeit, Ablauf oder Metadaten nicht ändern, keine größere Datei senden und keinen anderen Dateityp verwenden.
- Jeder Upload verbraucht eine Nutzung: ein Aufruf von Object Post oder das Öffnen eines Chunked Uploads (dessen Teile und Abschluss verbrauchen keine weiteren).
- Bei Chunked Uploads steuert ein Token nur die Uploads, die es selbst geöffnet hat (Status, Teile, Abschluss und Abbruch): Ein
upload-Wert aus einem anderen Upload antwortet mit400 INVALID_UPLOAD_TOKEN. - Ohne
namewählt der Browser ihn, und der Name erhält immer einen Security Hash, sodass ein geleaktes Token niemals deine bestehenden Dateien ersetzen kann. - Das Token funktioniert nicht mehr, wenn seine Nutzungen aufgebraucht sind (
401 UPLOAD_TOKEN_USED), wenn es abläuft, wenn der API-Schlüssel, der es erstellt hat, neu generiert oder widerrufen wird, oder wenn die Dashboard-Sitzung, die es erstellt hat, abgemeldet wird (401 ACCESS_DENIED).
Parameter
Nur mit
name: false erlaubt dem Upload, die Datei mit diesem Namen zu ersetzen. Andernfalls erhält der Name immer einen Hash.Metadaten, die jeder mit dem Token hochgeladenen Datei hinzugefügt werden. Nur Pro und Enterprise.
Rate Limits
120 Tokens pro Minute (
RATE_LIMITED, 429). Das Erstellen speichert nichts, daher ist ein Token pro Upload eines Endnutzers in Ordnung.Antwort
Fehler
Wenn der Browser hochlädt:
401 UPLOAD_TOKEN_USED (aufgebraucht), 401 ACCESS_DENIED (abgelaufen, sein Schlüssel neu generiert oder widerrufen, oder seine Sitzung abgemeldet), 403 PREFIX_NOT_ALLOWED (anderes Präfix), 400 FILE_TYPE_NOT_ALLOWED (Endung nicht erlaubt) und 413 FILE_TOO_LARGE (über max_size).
Siehe auch
- Blob SDK:
blob.uploadTokens.create()

