Файл кітапханасы
Файл кітапханасы ағымдағы тіркелгінің қол жеткізе алатын дереккөздерін, тапсырма нәтижелерін және қосымша файлдарын көрсетеді. Әрбір элементтің тұрақты file_id коды бар және шақырушының қазіргі уақытта орындай алатын әрекеттерін қайтарады.
Аудару кірісі ретінде пайдаланылатын құжаттарда да /api/v1/documents тізімдеу, егжей-тегжейлі анықтау, жаңарту және жою нүктелері бар. document_id өңдеу жұмыстарын жасауға арналған; file_id кітапхана бойынша рұқсаттар мен жүктеулерге арналған. Бұл екі идентификаторды бір-бірін алмастыруға болады деп есептемеңіз.
Тізімдеу және егжей-тегжейлі баяндау
Section titled “Тізімдеу және егжей-тегжейлі баяндау”GET /api/v1/storage/files?offset=0&limit=50GET /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}Келесі бетті алу үшін offset ретінде next_offset-ды беріңіз; has_more false болғанда тоқтаңыз.
Әрбір элементтің capabilities қасиетін әрқашан пайдаланып, оның жүктелуіне, бөлісуіне немесе қосымшаға берілуіне болатынын анықтаңыз; рұқсаттарды шығу деректерінен шығармаңыз.
Жүктеу
Section titled “Жүктеу”GET /api/v1/storage/files/{file_id}/contentPOST /api/v1/storage/files/{file_id}/download-ticket/content бағыттауы (302) қысқа мерзімді жүктеу мекенжайына бағыттайды; бағыттауды ұстанған кезде API кілтін жібермеңіз. Алдымен download-ticket сұрау ұсынылады. Біреуі уақыты өткеннен кейін жаңа мекенжай сұраңыз; оны сақтамаңыз.
Рұқсаттар мен сілтемелер
Section titled “Рұқсаттар мен сілтемелер”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}Рұқсаттарды өзгерту және жария сілтемелер — бұл бөлек мүмкіндіктер. Сілтеме жасағанда, оның аудиториясын, жүктеу рұқсатын, мерзімін және балама жүктеу санын нақты белгілеңіз; ол енді қажет болмаған кезде дереу тоқтатыңыз.
Жұмыс алаңы көріністері
Section titled “Жұмыс алаңы көріністері”GET /api/v1/workspace/filesGET /api/v1/workspace/entriesGET /api/v1/workspace/appsЖұмыс аймағының шекаралары файл орталығына сәйкес келеді; /storage/files бір файлға қатысты рұқсаттар мен жүктеу әрекеттеріне қолайлы.