文件管理

ctx := context.Background()

resp, httpRes, err := apiClient.FileAPI.InfoFile(ctx, "your-library-id", "your-space-id", "/test.txt").
    AccessToken("your-access-token").
    UserId("user-id").
    Info(1).
    ContentDisposition("inline").
    Execute()

if err != nil {
    panic(err)
}

fmt.Printf("File info: %s, Size: %s\\n", *resp.CosUrl, *resp.Size)

{
  "cosUrl": "https://example.com/file.txt?sign=xxx",
  "type": "file",
  "creationTime": "2024-01-15T10:30:00Z",
  "modificationTime": "2024-01-15T11:30:00Z",
  "contentType": "text/plain",
  "size": "1024",
  "eTag": "\\"abc123\\"",
  "crc64": "1234567890",
  "fileType": "txt",
  "previewByDoc": false,
  "previewByCI": false,
  "previewAsIcon": false,
  "metaData": {"department": "engineering"},
  "labels": ["文档"],
  "category": "document",
  "localCreationTime": "2024-01-15T10:30:00Z",
  "localModificationTime": "2024-01-15T10:30:00Z",
  "versionId": 1,
  "contentCas": "xxx"
}

ctx := context.Background()

httpRes, err := apiClient.FileAPI.GetCover(ctx, "your-library-id", "your-space-id", "/photo.jpg").
    AccessToken("your-access-token").
    UserId("user-id").
    Preview(1).
    Size(256).
    Scale(12).
    WidthSize(256).
    HeightSize(256).
    FrameNumber(1).
    Execute()

// SDK 使用 http.DefaultClient 且未设置 CheckRedirect，会自动跟随 302，
// 因此这里拿到的是最终响应（200），响应体为图片/文档内容
if err != nil {
    panic(err)
}

fmt.Printf("Cover image: %d\\n", httpRes.StatusCode)

ctx := context.Background()

httpRes, err := apiClient.FileAPI.PreviewFile(ctx, "your-library-id", "your-space-id", "/test.docx").
    AccessToken("your-access-token").
    UserId("user-id").
    Preview(1).
    HistoryId("1").
    Type_("html").
    Execute()

// SDK 使用 http.DefaultClient 且未设置 CheckRedirect，会自动跟随 302，
// 因此这里拿到的是最终响应（200），响应体为图片/文档内容
if err != nil {
    panic(err)
}

fmt.Printf("File preview: %d\\n", httpRes.StatusCode)

ctx := context.Background()

httpRes, err := apiClient.FileAPI.CheckFileStatus(ctx, "your-library-id", "your-space-id", "/test.txt").
    AccessToken("your-access-token").
    UserId("user-id").
    Execute()

if err != nil && httpRes == nil {
    panic(err)
}

fmt.Printf("File status checked: %d\\n", httpRes.StatusCode)

ctx := context.Background()

resp, httpRes, err := apiClient.FileAPI.GetFileInfoByInode(ctx, "your-library-id", "your-space-id", "file-inode-123").
    AccessToken("your-access-token").
    Execute()

if err != nil {
    panic(err)
}

fmt.Printf("File name: %s, Size: %s\\n", resp.Name, resp.Size)

{
  "path": ["documents", "report.txt"],
  "name": "report.txt",
  "type": "file",
  "creationTime": "2024-01-15T10:30:00Z",
  "modificationTime": "2024-01-15T11:30:00Z",
  "contentType": "text/plain",
  "size": "1024",
  "crc64": "1234567890",
  "contentCas": "xxx"
}

ctx := context.Background()

copyRequest := client.CopyFileRequest{
    CopyFrom: "/source/test.txt",
}

resp, httpRes, err := apiClient.FileAPI.CopyFile(ctx, "your-library-id", "your-space-id", "/dest/test.txt").
    AccessToken("your-access-token").
    UserId("user-id").
    ConflictResolutionStrategy("rename").
    CopyFileRequest(copyRequest).
    Execute()

if err != nil {
    panic(err)
}

fmt.Printf("File copied, path: %v\\n", resp.Path)

{
  "path": ["dest", "test.txt"],
  "contentCas": "xxx"
}

ctx := context.Background()

moveRequest := client.MoveFileRequest{
    From: "/old-name.txt",
}

resp, httpRes, err := apiClient.FileAPI.MoveFile(ctx, "your-library-id", "your-space-id", "/new-name.txt").
    AccessToken("your-access-token").
    UserId("user-id").
    ConflictResolutionStrategy("rename").
    MoveFileRequest(moveRequest).
    Execute()

if err != nil {
    panic(err)
}

fmt.Printf("File moved, path: %v\\n", resp.Path)

{
  "path": ["new-name.txt"],
  "contentCas": "xxx"
}

ctx := context.Background()

resp, httpRes, err := apiClient.FileAPI.DeleteFile(ctx, "your-library-id", "your-space-id", "/test.txt").
    AccessToken("your-access-token").
    UserId("user-id").
    Permanent(0).
    Execute()

if err != nil {
    panic(err)
}

if resp != nil && resp.RecycledItemId != nil {
    fmt.Printf("File moved to recycle bin, recycledItemId: %d\\n", *resp.RecycledItemId)
} else {
    fmt.Printf("File deleted: %d\\n", httpRes.StatusCode)
}

{
  "recycledItemId": 123456
}

ctx := context.Background()

symlinkRequest := client.CreateSymlinkRequest{
    LinkTo: "/source/test.xlsx",
}

resp, httpRes, err := apiClient.FileAPI.CreateSymlink(ctx, "your-library-id", "your-space-id", "/link/test.xlsx").
    AccessToken("your-access-token").
    UserId("user-id").
    ConflictResolutionStrategy("rename").
    CreateSymlinkRequest(symlinkRequest).
    Execute()

if err != nil {
    panic(err)
}

fmt.Printf("Symlink created, path: %v\\n", resp.Path)

{
  "path": ["link", "test.xlsx"]
}

ctx := context.Background()

convertRequest := client.ConvertFileRequest{
    ConvertFrom: "/source/test.docx",
}

resp, httpRes, err := apiClient.FileAPI.ConvertFile(ctx, "your-library-id", "your-space-id", "/dest/test.pdf").
    AccessToken("your-access-token").
    UserId("user-id").
    Convert(1).
    ConflictResolutionStrategy("rename").
    ConvertFileRequest(convertRequest).
    Execute()

if err != nil {
    panic(err)
}

if httpRes.StatusCode == 202 && resp != nil && resp.TaskId != nil {
    fmt.Printf("转码任务已提交，taskId: %d\\n", *resp.TaskId)
}

{
  "taskId": 12345
}

ctx := context.Background()

typeFilter := client.StringAsListRecentlyUsedFileRequestType(client.PtrString("doc"))
recentRequest := client.ListRecentlyUsedFileRequest{
    Limit:          client.PtrInt32(20),
    FilterActionBy: client.PtrString("preview"),
    Type:           &typeFilter,
    WithPath:       client.PtrBool(true),
}

resp, httpRes, err := apiClient.RecentAPI.ListRecentlyUsedFile(ctx, "your-library-id", "your-space-id").
    AccessToken("your-access-token").
    ListRecentlyUsedFileRequest(recentRequest).
    Execute()

if err != nil {
    panic(err)
}

for _, item := range resp.Contents {
    if item.Name != nil && item.OperationTime != nil {
        fmt.Printf("File: %s, Action: %s, Time: %s\\n", 
            *item.Name, 
            *item.ActionType, 
            *item.OperationTime)
    }
}