Bestandsbibliotheek
De bestandsbibliotheek toont de bronbestanden, taakresultaten en app-bestanden die het huidige account kan benaderen. Elk item heeft een stabiel file_id en geeft de acties weer die de aanroeper momenteel kan uitvoeren.
Documenten die als vertaalinput worden gebruikt, hebben ook /api/v1/documents-eindpunten voor lijstweergave, detailweergave, bijwerken en verwijderen. document_id is bedoeld voor het aanmaken van verwerkingsopdrachten; file_id is voor bibliotheekbrede machtigingen en downloads. Ga er niet van uit dat deze twee ID’s onderling uitwisselbaar zijn.
Lijst en details
Section titled “Lijst en details”GET /api/v1/storage/files?offset=0&limit=50GET /api/v1/storage/files/{file_id}Lijstreactie:
{ "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}Om de volgende pagina op te halen, geeft u next_offset door als offset; stop wanneer has_more gelijk is aan false.
Gebruik altijd de capabilities van elk item om te bepalen of het kan worden gedownload, gedeeld of aan een app worden verleend; maak geen afleidingen over machtigingen op basis van de oorsprongsvelden.
Download
Section titled “Download”GET /api/v1/storage/files/{file_id}/contentPOST /api/v1/storage/files/{file_id}/download-ticket/content leidt (302) om naar een kortstondig downloadadres; stuur de API-sleutel niet mee bij het volgen van de redirect. Het wordt aanbevolen eerst een download-ticket op te vragen. Vraag een nieuw adres aan nadat het vorige is verlopen; sla het niet op.
Machtigingen en koppelingen
Section titled “Machtigingen en koppelingen”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}Machtigingswijzigingen en openbare koppelingen zijn afzonderlijke functies. Wanneer u een koppeling maakt, stelt u expliciet het publiek, de downloadmachtiging, de vervaldatum en een optioneel aantal downloads in; trek deze in zodra deze niet langer nodig is.
Werkruimte-weergaven
Section titled “Werkruimte-weergaven”GET /api/v1/workspace/filesGET /api/v1/workspace/entriesGET /api/v1/workspace/appsDe werkruimte-eindpunten zijn geschikt voor een bestandscentrum; /storage/files is geschikt voor machtigings- en downloadacties op één enkel bestand.