目录或相簿

// 使用 marker/limit 分页查询（推荐）
ctx := context.Background()

resp, httpRes, err := apiClient.DirectoryAPI.ListDirectory(ctx, "your-library-id", "your-space-id", "/images").
    ByMarker(1).
    Limit(20).
    OrderBy("creationTime").
    OrderByType("desc").
    Filter("onlyFile").
    SortType("union").
    WithInode(1).
    WithFavoriteStatus(1).
    AccessToken("your-access-token").
    UserId("user-id").
    Execute()
if err != nil {
    panic(err)
}
if httpRes.StatusCode == 200 {
    for _, item := range resp.Contents {
        fmt.Println(*item.Name)
    }
}

// 获取下一页：将上一次响应中的 nextMarker 作为 marker 传入
if resp.NextMarker != nil {
    resp2, _, err := apiClient.DirectoryAPI.ListDirectory(ctx, "your-library-id", "your-space-id", "/images").
        ByMarker(1).
        Marker(*resp.NextMarker).
        Limit(20).
        AccessToken("your-access-token").
        Execute()
    if err != nil {
        panic(err)
    }
    fmt.Printf("下一页条目数: %d\\n", len(resp2.Contents))
}

// 使用 page/pageSize 分页查询（不推荐，page × pageSize 最大翻页条目数为 1 万）
ctx := context.Background()

resp, httpRes, err := apiClient.DirectoryAPI.ListDirectoryByPage(ctx, "your-library-id", "your-space-id", "/images").
    ByPage(1).
    Page(1).
    PageSize(20).
    OrderBy("creationTime").
    OrderByType("desc").
    Filter("onlyFile").
    SortType("union").
    AccessToken("your-access-token").
    UserId("user-id").
    Execute()
if err != nil {
    panic(err)
}
if httpRes.StatusCode == 200 {
    fmt.Printf("总数: %d, 文件数: %d, 子目录数: %d\\n",
        *resp.TotalNum, *resp.FileCount, *resp.SubDirCount)
    for _, item := range resp.Contents {
        fmt.Println(*item.Name)
    }
}

// 获取目录详情
ctx := context.Background()

resp, httpRes, err := apiClient.DirectoryAPI.InfoFileOrDirectory(ctx, "your-library-id", "your-space-id", "/documents").
    Info(1).
    WithInode(1).
    WithFavoriteStatus(1).
    AccessToken("your-access-token").
    Execute()
if err != nil {
    panic(err)
}
if httpRes.StatusCode == 200 {
    fmt.Printf("名称: %s, 类型: %s\\n", *resp.Name, *resp.Type)
}

ctx := context.Background()

httpRes, err := apiClient.DirectoryAPI.CheckDirectoryStatus(ctx, "your-library-id", "your-space-id", "/documents").
    AccessToken("your-access-token").
    UserId("user-id").
    Execute()
if err != nil {
    panic(err)
}
if httpRes.StatusCode == 200 {
    fmt.Println("目录存在")
}

ctx := context.Background()

resp, httpRes, err := apiClient.DirectoryAPI.GetDirectoryStats(ctx, "your-library-id", "your-space-id", "/documents").
    Stats(1).
    StatsType("normal").
    AccessToken("your-access-token").
    UserId("user-id").
    Execute()

if err != nil {
    panic(err)
}

fmt.Printf("Directory stats retrieved successfully: %d\\n", httpRes.StatusCode)
if resp.Storage != nil {
    fmt.Printf("Storage: %d bytes\\n", *resp.Storage)
}

{
  "userId": "user123",
  "statsType": "normal",
  "storage": 5558728615,
  "fileCount": 1024,
  "dirCount": 50
}

ctx := context.Background()

meta := map[string]string{
    "department": "engineering",
    "project":    "sdk-v2",
}
createDirBody := client.CreateDirectoryRequest{
    MetaData:              &meta,
    Labels:                []string{"重要", "项目文档"},
    LocalCreationTime:     client.PtrTime(time.Now()),
    LocalModificationTime: client.PtrTime(time.Now()),
}

resp, httpRes, err := apiClient.DirectoryAPI.CreateDirectory(ctx, "your-library-id", "your-space-id", "/project-docs").
    ConflictResolutionStrategy("rename").
    WithInode(1).
    CreateDirectoryRequest(createDirBody).
    AccessToken("your-access-token").
    Execute()
if err != nil {
    panic(err)
}
if httpRes.StatusCode == 201 {
    fmt.Printf("目录创建成功: %v\\n", resp.Path)
}

// 复制（目录内容较多时可能转为异步任务）
ctx := context.Background()

resp202, resp200, httpRes, err := apiClient.DirectoryAPI.CopyDirectory(ctx, "your-library-id", "your-space-id", "/dest/images").
    ConflictResolutionStrategy("ask").
    CopyDirectoryRequest(client.CopyDirectoryRequest{
        CopyFrom: "/source/images",
    }).
    AccessToken("your-access-token").
    UserId("user-id").
    Execute()
if err != nil {
    panic(err)
}
switch httpRes.StatusCode {
case 200:
    fmt.Printf("同步复制成功，最终路径: %v\\n", resp200.Path)
case 202:
    fmt.Printf("已转为异步复制任务，taskId: %d\\n", *resp202.TaskId)
case 204:
    fmt.Println("同步复制成功")
}

ctx := context.Background()

resp, httpRes, err := apiClient.DirectoryAPI.MoveDirectory(ctx, "your-library-id", "your-space-id", "/dest/images").
    ConflictResolutionStrategy("ask").
    MoveDirectoryRequest(client.MoveDirectoryRequest{
        From: "/source/images",
    }).
    AccessToken("your-access-token").
    UserId("user-id").
    Execute()
if err != nil {
    panic(err)
}
switch httpRes.StatusCode {
case 200:
    fmt.Printf("同步移动成功，最终路径: %v\\n", resp.Path)
case 204:
    fmt.Println("同步移动成功")
}

// 移入回收站
ctx := context.Background()

resp, httpRes, err := apiClient.DirectoryAPI.DeleteDirectory(ctx, "your-library-id", "your-space-id", "/old-folder").
    Permanent(0).
    AccessToken("your-access-token").
    UserId("user-id").
    Execute()
if err != nil {
    panic(err)
}
if httpRes.StatusCode == 200 && resp.RecycledItemId != nil {
    fmt.Printf("目录已移入回收站，回收站项目 ID: %d\\n", *resp.RecycledItemId)
} else if httpRes.StatusCode == 204 {
    fmt.Println("目录已永久删除")
}

ctx := context.Background()

resp, httpRes, err := apiClient.DirectoryAPI.CalibrateDirectoryStats(ctx, "your-library-id", "your-space-id", "/documents").
    Calibrate(1).
    StatsType("normal").
    AccessToken("your-access-token").
    Execute()
if err != nil {
    panic(err)
}

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

ctx := context.Background()

httpRes, err := apiClient.DirectoryAPI.UpdateDirectoryLabels(ctx, "your-library-id", "your-space-id", "/documents").
    Update(1).
    UpdateDirectoryLabelsRequest(client.UpdateDirectoryLabelsRequest{
        Labels: []string{"tag1", "tag2", "important"},
    }).
    AccessToken("your-access-token").
    Execute()
if err != nil {
    panic(err)
}
if httpRes.StatusCode == 204 {
    fmt.Println("目录标签更新成功")
}