跳转到内容

கோப்பு நூலகம்

கோப்பு நூலகம், தற்போதைய கணக்கினால் அணுகக்கூடிய மூலக் கோப்புகள், பணி முடிவுகள் மற்றும் பயன்பாட்டுக் கோப்புகளைக் காட்டுகிறது. ஒவ்வொரு உருப்படியும் நிலையான 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 ஒரு கோப்பின் அனுமதி மற்றும் பதிவிறக்க நடவடிக்கைகளுக்கு ஏற்றது.