파일 라이브러리
파일 라이브러리는 현재 계정에서 접근할 수 있는 소스 파일, 작업 결과 및 앱 파일을 표시합니다. 각 항목에는 고유한 file_id이 있으며, 호출자가 현재 수행할 수 있는 작업을 반환합니다.
번역 입력으로 사용되는 문서에도 /api/v1/documents 목록, 세부 정보, 업데이트 및 삭제 엔드포인트가 있습니다. document_id는 처리 작업 생성용이며, file_id은 라이브러리 전체 권한 및 다운로드용입니다. 두 ID가 서로 교환 가능하다고 가정하지 마십시오.
목록 및 세부 사항
섹션 제목: “목록 및 세부 사항”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}다음 페이지를 가져오려면 next_offset을 offset로 전달하고, has_more가 false이 되면 중지합니다.
항상 각 항목의 capabilities를 사용하여 다운로드, 공유 또는 앱에 부여할 수 있는지 여부를 결정하십시오. 원본 필드에서 권한을 추론하지 마십시오.
다운로드
섹션 제목: “다운로드”GET /api/v1/storage/files/{file_id}/contentPOST /api/v1/storage/files/{file_id}/download-ticket/content는 (302) 리디렉션을 통해 단기 다운로드 주소로 연결되며, 리디렉션을 따라갈 때는 API 키를 전송하지 마십시오. 먼저 download-ticket을 요청하는 것이 권장됩니다. 기존 주소가 만료된 후에는 새 주소를 요청하고, 이를 저장하지 마십시오.
권한 및 링크
섹션 제목: “권한 및 링크”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}권한 변경과 공개 링크는 별도의 기능입니다. 링크를 생성할 때는 대상, 다운로드 권한, 만료일 및 선택적 다운로드 횟수를 명시적으로 설정하고, 더 이상 필요하지 않으면 즉시 취소하십시오.
작업 공간 보기
섹션 제목: “작업 공간 보기”GET /api/v1/workspace/filesGET /api/v1/workspace/entriesGET /api/v1/workspace/apps작업 공간 엔드포인트는 파일 센터에 적합하며, /storage/files은 단일 파일에 대한 권한 및 다운로드 작업에 적합합니다.