Skip to main content
GET
string
erforderlich
Der API-Schlüssel für dein Konto. Du findest ihn in deinen Kontoeinstellungen.
Object List zählt die unter deinem Konto gespeicherten Dateien auf, optional gefiltert nach Präfix und Sichtbarkeit, und paginiert mit einem Cursor, statt alles auf einmal zurückzugeben. Nutze den Endpoint, um einen Dateibrowser zu bauen, zu bestätigen, dass ein Upload angekommen ist, oder deine eigenen Einträge mit dem abzugleichen, was Blob Storage enthält. Erfordert den Scope blob:read. Seiten werden pro Parametersatz 30 Minuten gecacht, und deine eigenen Uploads und Löschvorgänge leeren diesen Cache, sodass sie sofort erscheinen. Die Reihenfolge der Ergebnisse ist nicht garantiert. Eine Seite kann weniger als limit Objekte enthalten, obwohl noch weitere übrig sind: Frage so lange weiter an, bis continuationToken fehlt.

Parameter

string
Nur Dateien, deren Pfad mit dieser Zeichenkette beginnt (zum Beispiel images/ oder images/2026-). Buchstaben, Ziffern, _, ., - und /, bis 256 Zeichen.
string
Nur /. Gruppiert die Dateien unterhalb des nächsten / in folders, statt sie aufzulisten, wie bei einer Verzeichnisauflistung.
boolean
true listet nur private Dateien, false nur öffentliche. Lass es weg, um beide aufzulisten.
number
Standard:"1000"
Maximale Anzahl an Einträgen pro Seite, von 1 bis 1000.
string
Das continuationToken der vorherigen Seite. continuationToken wird auch als Parametername akzeptiert.

Rate Limits

30 Requests pro 30 Sekunden, darüber hinaus für kurze Zeit gesperrt (RATE_LIMITED, 429).

Antwort

string
“success” bei Erfolg, “error” bei Misserfolg.
object

Fehler

Siehe auch