Pustaka file
Perpustakaan file menampilkan file sumber, hasil pekerjaan, dan file aplikasi yang dapat diakses oleh akun saat ini. Setiap item memiliki file_id yang stabil dan mengembalikan tindakan yang saat ini dapat dilakukan oleh pemanggil.
Dokumen yang digunakan sebagai input terjemahan juga memiliki endpoint /api/v1/documents untuk daftar, detail, pembaruan, dan penghapusan. document_id digunakan untuk membuat pekerjaan pemrosesan; file_id digunakan untuk izin dan unduhan di seluruh perpustakaan. Jangan menganggap kedua ID tersebut dapat saling dipertukarkan.
Daftar dan rincian
Section titled “Daftar dan rincian”GET /api/v1/storage/files?offset=0&limit=50GET /api/v1/storage/files/{file_id}Daftar respons:
{ "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}Untuk mendapatkan halaman berikutnya, masukkan next_offset sebagai offset; hentikan ketika has_more adalah false.
Selalu gunakan capabilities masing-masing item untuk menentukan apakah item tersebut dapat diunduh, dibagikan, atau diberikan izin kepada sebuah aplikasi; jangan menyimpulkan izin dari bidang asal.
GET /api/v1/storage/files/{file_id}/contentPOST /api/v1/storage/files/{file_id}/download-ticket/content mengarahkan ulang (302) ke alamat unduhan yang hanya berlaku sementara; jangan kirimkan kunci API saat mengikuti pengalihan tersebut. Disarankan untuk terlebih dahulu meminta download-ticket. Mintalah alamat baru setelah yang lama kedaluwarsa; jangan simpan alamat tersebut.
Izin dan tautan
Section titled “Izin dan tautan”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}Perubahan izin dan tautan publik adalah kemampuan yang terpisah. Saat Anda membuat tautan, tetapkan audiens, izin unduh, masa berlaku, serta jumlah unduhan (opsional) secara eksplisit; cabut tautan tersebut segera setelah tidak lagi diperlukan.
Tampilan ruang kerja
Section titled “Tampilan ruang kerja”GET /api/v1/workspace/filesGET /api/v1/workspace/entriesGET /api/v1/workspace/appsEndpoint ruang kerja cocok untuk pusat file; /storage/files cocok untuk tindakan izin dan unduhan pada satu file.