Bibliotecă de fișiere
Biblioteca fișierelor afișează fișierele sursă, rezultatele sarcinilor și fișierele aplicației la care poate accesa contul curent. Fiecare element are un identificator stabil file_id și returnează acțiunile pe care le poate efectua în prezent apelantul.
Documentele folosite ca input pentru traducere au, de asemenea, puncte terminale /api/v1/documents pentru listare, detaliere, actualizare și ștergere. document_id este destinat creării de joburi de procesare; file_id se folosește pentru permisiunile la nivel de bibliotecă și descărcări. Nu presupuneți că aceste două ID-uri sunt interschimbabile.
Lista și detaliile
Section titled “Lista și detaliile”GET /api/v1/storage/files?offset=0&limit=50GET /api/v1/storage/files/{file_id}Lista răspunsului:
{ "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}Pentru a obține pagina următoare, treceți next_offset ca offset; opriți când has_more este false.
Utilizați întotdeauna capabilities al fiecărui element pentru a decide dacă poate fi descărcat, partajat sau atribuit unei aplicații; nu deduceți permisiunile din câmpurile de proveniență.
Descarcă
Section titled “Descarcă”GET /api/v1/storage/files/{file_id}/contentPOST /api/v1/storage/files/{file_id}/download-ticket/content redirecționează (302) către o adresă de descărcare cu durată limitată; nu trimiteți cheia API atunci când urmați redirecționarea. Se recomandă să solicitați mai întâi un download-ticket. Solicitați o nouă adresă după expirarea celei anterioare; nu o stocați.
Permisii și link-uri
Section titled “Permisii și link-uri”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}Schimbările de permisiuni și link-urile publice sunt funcționalități distincte. Atunci când creați un link, setați explicit publicul destinatar, permisiunea de descărcare, data de expirare și, opțional, numărul maxim de descărcări; revocați-l imediat ce nu mai este necesar.
Vizualizări ale spațiului de lucru
Section titled “Vizualizări ale spațiului de lucru”GET /api/v1/workspace/filesGET /api/v1/workspace/entriesGET /api/v1/workspace/appsEndpoint-urile spațiului de lucru sunt potrivite pentru un centru de fișiere; /storage/files este adecvat pentru operații de permisiune și descărcare asupra unei singure fișiere.