跳转到内容

Βιβλιοθήκη αρχείων

Η βιβλιοθήκη αρχείων εμφανίζει τα πηγαία αρχεία, τα αποτελέσματα εργασιών και τα αρχεία εφαρμογών στα οποία μπορεί να έχει πρόσβαση ο τρέχων λογαριασμός. Κάθε στοιχείο διαθέτει ένα σταθερό file_id και επιστρέφει τις ενέργειες που μπορεί να εκτελέσει ο καλούντας αυτή τη στιγμή.

Τα έγγραφα που χρησιμοποιούνται ως είσοδος μετάφρασης διαθέτουν επίσης τις καταχωρήσεις /api/v1/documents για λίστα, λεπτομέρεια, ενημέρωση και διαγραφή. Το document_id αφορά τη δημιουργία εργασιών επεξεργασίας· το file_id αφορά τις δικαιοδοσίες και τις λήψεις σε ολόκληρη τη βιβλιοθήκη. Μην υποθέτετε ότι οι δύο κωδικοί είναι αλληλοαντικαθίσταμενοι.

Παρουσίαση και λεπτομέρειες

Section titled “Παρουσίαση και λεπτομέρειες”
GET /api/v1/storage/files?offset=0&limit=50
GET /api/v1/storage/files/{file_id}

Λίστα απάντησης:

{
"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
}

Για να πάρετε την επόμενη σελίδα, περάστε next_offset ως offset; σταματήστε όταν το has_more είναι false.

Χρησιμοποιήστε πάντα το capabilities κάθε στοιχείου για να αποφασίσετε εάν μπορεί να κατεβεί, να κοινοποιηθεί ή να δοθεί σε μια εφαρμογή· μην εξάγετε τις άδειες από τα πεδία προέλευσης.

GET /api/v1/storage/files/{file_id}/content
POST /api/v1/storage/files/{file_id}/download-ticket

Η ανακατεύθυνση /content (302) οδηγεί σε μια προσωρινή διεύθυνση λήψης· μην αποστείλετε το κλειδί API όταν ακολουθείτε την ανακατεύθυνση. Συνιστάται να ζητήσετε πρώτα ένα download-ticket. Ζητήστε μια νέα διεύθυνση μόλις λήξει η προηγούμενη· μην την αποθηκεύσετε.

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}

Οι αλλαγές στις άδειες και τα δημόσια συνδέσμοι είναι ξεχωριστές δυνατότητες. Όταν δημιουργείτε έναν σύνδεσμο, ορίστε ρητά το κοινό, την άδεια λήψης, την ημερομηνία λήξης και προαιρετικά τον αριθμό λήψεων· ανακαλέστε τον μόλις δεν χρειάζεται πλέον.

Προβολές χώρου εργασίας

Section titled “Προβολές χώρου εργασίας”
GET /api/v1/workspace/files
GET /api/v1/workspace/entries
GET /api/v1/workspace/apps

Τα σημεία άκρης του χώρου εργασίας ταιριάζουν σε ένα κέντρο αρχείων· το /storage/files ταιριάζει σε ενέργειες περιθωρίου και λήψης για ένα μόνο αρχείο.