Dateibibliothek
Die Dateibibliothek zeigt die Quelldateien, Aufgabenergebnisse und App-Dateien an, auf die das aktuelle Konto zugreifen kann. Jedes Element verfügt über einen stabilen file_id und gibt die Aktionen zurück, die der Aufrufer derzeit ausführen kann.
Dokumente, die als Übersetzungsinput verwendet werden, verfügen ebenfalls über die Endpunkte /api/v1/documents für Listen, Details, Aktualisierung und Löschen. document_id dient dem Erstellen von Verarbeitungsaufträgen; file_id ist für bibliotheksweite Berechtigungen und Downloads vorgesehen. Gehen Sie nicht davon aus, dass die beiden IDs austauschbar sind.
Auflisten und detailliert beschreiben
Abschnitt betitelt „Auflisten und detailliert beschreiben“GET /api/v1/storage/files?offset=0&limit=50GET /api/v1/storage/files/{file_id}Listenantwort:
{ "items": [ { "id": "x7m4q2k9n6c1v8pa", "name": "report.docx", "content_type": "application/vnd.openxmlformats-officedocument.wordprocessingml.document", "size_bytes": 45678, "status": "ready", "publication_status": "draft", "origin": { "product_code": "omnidoc-main", "display_name": "OmniDoc" }, "capabilities": { "can_view": true, "can_download": true, "can_update": true, "can_delete": true, "can_share": true }, "created_at": "2026-10-01T12:00:00Z", "updated_at": "2026-10-01T12:00:00Z" } ], "has_more": true, "next_offset": 50}Um die nächste Seite zu erhalten, übergeben Sie next_offset als offset; beenden Sie die Ausführung, wenn has_more gleich false ist.
Verwenden Sie stets das capabilities jedes Elements, um zu entscheiden, ob es heruntergeladen, freigegeben oder einer App zugewiesen werden kann; leiten Sie Berechtigungen nicht aus den Ursprungsfeldern ab.
Herunterladen
Abschnitt betitelt „Herunterladen“GET /api/v1/storage/files/{file_id}/contentPOST /api/v1/storage/files/{file_id}/download-ticket/content leitet (302) auf eine kurzlebige Download-Adresse weiter; senden Sie beim Folgen der Weiterleitung keinen API-Schlüssel. Es wird empfohlen, zuerst einen download-ticket anzufordern. Fordern Sie nach Ablauf einer Adresse eine neue an; speichern Sie sie nicht.
Berechtigungen und Links
Abschnitt betitelt „Berechtigungen und Links“GET /api/v1/storage/files/{file_id}/permissionsPOST /api/v1/storage/files/{file_id}/permissionsDELETE /api/v1/storage/files/{file_id}/permissions/{grant_id}
GET /api/v1/storage/files/{file_id}/linksPOST /api/v1/storage/files/{file_id}/linksDELETE /api/v1/storage/files/{file_id}/links/{link_id}Berechtigungsänderungen und öffentliche Links sind separate Funktionen. Wenn Sie einen Link erstellen, legen Sie dessen Zielgruppe, Download-Berechtigung, Ablaufdatum sowie optional eine maximale Anzahl von Downloads explizit fest; widerrufen Sie ihn, sobald er nicht mehr benötigt wird.
Arbeitsbereichsansichten
Abschnitt betitelt „Arbeitsbereichsansichten“GET /api/v1/workspace/filesGET /api/v1/workspace/entriesGET /api/v1/workspace/appsDie Arbeitsbereichs-Endpunkte eignen sich für ein Dateizentrum; /storage/files ist für Berechtigungs- und Downloadaktionen auf eine einzelne Datei geeignet.