跳转到内容

Файл кітапханасы

Файл кітапханасы ағымдағы тіркелгінің қол жеткізе алатын дереккөздерін, тапсырма нәтижелерін және қосымша файлдарын көрсетеді. Әрбір элементтің тұрақты 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
}

Келесі бетті алу үшін offset ретінде next_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 сұрау ұсынылады. Біреуі уақыты өткеннен кейін жаңа мекенжай сұраңыз; оны сақтамаңыз.

Рұқсаттар мен сілтемелер

Section titled “Рұқсаттар мен сілтемелер”
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 бір файлға қатысты рұқсаттар мен жүктеу әрекеттеріне қолайлы.