Sari la conținut

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.

GET /api/v1/storage/files?offset=0&limit=50
GET /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ță.

GET /api/v1/storage/files/{file_id}/content
POST /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.

GET /api/v1/storage/files/{file_id}/permissions
POST /api/v1/storage/files/{file_id}/permissions
DELETE /api/v1/storage/files/{file_id}/permissions/{grant_id}
GET /api/v1/storage/files/{file_id}/links
POST /api/v1/storage/files/{file_id}/links
DELETE /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.

GET /api/v1/workspace/files
GET /api/v1/workspace/entries
GET /api/v1/workspace/apps

Endpoint-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.