分享管理

ctx := context.Background()

expireTime := time.Date(2026, 12, 31, 23, 59, 59, 0, time.Local)
createReq := client.CreateShareRequest{
    Name:     "report.pdf",
    FilePath: []string{"/documents/report.pdf"},
    Config: &client.CreateShareRequestConfig{
        IsPermanent: client.PtrBool(false),
        ExpireTime:  &expireTime,
        CanPreview:  client.PtrBool(true),
        CanDownload: client.PtrBool(true),
    },
}

resp, httpRes, err := apiClient.ShareAPI.CreateShare(ctx, "your-library-id", "your-space-id").
    CreateShareRequest(createReq).
    AccessToken("your-access-token").
    Execute()
if err != nil {
    panic(err)
}

if httpRes.StatusCode == 200 {
    fmt.Printf("分享 ID: %s\\n", *resp.Id)
    fmt.Printf("分享码: %s\\n", *resp.Code)
    fmt.Printf("访问地址: %s\\n", *resp.Endpoint)
}

ctx := context.Background()

resp, httpRes, err := apiClient.ShareAPI.ListShares(ctx, "your-library-id").
    Limit(20).
    OrderByType("desc").
    WithFileInfo(1).
    AccessToken("your-access-token").
    Execute()
if err != nil {
    panic(err)
}

if httpRes.StatusCode == 200 {
    for _, share := range resp.Contents {
        fmt.Printf("%s (code: %s)\\n", *share.Name, *share.Code)
    }
    if resp.HasMore != nil && *resp.HasMore {
        fmt.Printf("还有更多分享，marker: %s\\n", *resp.Marker)
    }
}

ctx := context.Background()

searchReq := client.SearchSharesRequest{
    Name:        client.PtrString("report"),
    OrderBy:     client.PtrString("createTime"),
    OrderByType: client.PtrString("desc"),
}

resp, httpRes, err := apiClient.ShareAPI.SearchShares(ctx, "your-library-id").
    SearchSharesRequest(searchReq).
    Limit(20).
    AccessToken("your-access-token").
    Execute()
if err != nil {
    panic(err)
}

if httpRes.StatusCode == 200 {
    for _, share := range resp.Contents {
        fmt.Printf("%s\\n", *share.Name)
    }
}

ctx := context.Background()

resp, httpRes, err := apiClient.ShareAPI.GetShareDetail(ctx, "your-library-id", "12345").
    Detail(1).
    WithFileInfo(1).
    AccessToken("your-access-token").
    Execute()
if err != nil {
    panic(err)
}

if httpRes.StatusCode == 200 {
    fmt.Printf("名称: %s, 分享码: %s, 是否过期: %v\\n", *resp.Name, *resp.Code, *resp.IsExpired)
}

ctx := context.Background()

resp, httpRes, err := apiClient.ShareAPI.GetShareUrlDetail(ctx, "share-token-from-url").
    Execute()
if err != nil {
    panic(err)
}

if httpRes.StatusCode == 200 {
    fmt.Printf("名称: %s, 需要提取码: %v, 是否可用: %v\\n",
        *resp.Name, *resp.NeedExtractionCode, *resp.Enabled)
}

ctx := context.Background()

expireTime := time.Date(2027, 6, 30, 23, 59, 59, 0, time.Local)
updateReq := client.UpdateShareRequest{
    Name: client.PtrString("report-v2.pdf"),
    Config: client.UpdateShareRequestConfig{
        IsPermanent: client.PtrBool(false),
        ExpireTime:  &expireTime,
        CanPreview:  client.PtrBool(true),
        CanDownload: client.PtrBool(true),
    },
}

resp, httpRes, err := apiClient.ShareAPI.UpdateShare(ctx, "your-library-id", "12345").
    Update(1).
    UpdateShareRequest(updateReq).
    AccessToken("your-access-token").
    Execute()
if err != nil {
    panic(err)
}

if httpRes.StatusCode == 200 {
    fmt.Printf("更新成功，访问地址: %s\\n", *resp.Endpoint)
}

ctx := context.Background()

// 创建者禁用分享
httpRes, err := apiClient.ShareAPI.SetShareEnabled(ctx, "your-library-id", "12345").
    SetEnabled(1).
    SetShareEnabledRequest(client.SetShareEnabledRequest{
        OwnerEnabled: client.PtrBool(false),
    }).
    AccessToken("your-access-token").
    Execute()
if err != nil {
    panic(err)
}

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

ctx := context.Background()

httpRes, err := apiClient.ShareAPI.DeleteShare(ctx, "your-library-id", "12345").
    AccessToken("your-access-token").
    Execute()
if err != nil {
    panic(err)
}

if httpRes.StatusCode == 204 {
    fmt.Println("分享已删除")
}

ctx := context.Background()

verifyReq := client.VerifyExtractionCodeRequest{
    ExtractionCode: "ab12",
}

resp, httpRes, err := apiClient.ShareAPI.VerifyExtractionCode(ctx, "share-code").
    VerifyExtractionCodeRequest(verifyReq).
    Execute()
if err != nil {
    panic(err)
}

if httpRes.StatusCode == 200 {
    shareAccessToken := *resp.AccessToken
    fmt.Printf("分享访问令牌: %s, 过期时间: %v\\n", shareAccessToken, *resp.ExpireTime)
    // 后续访问分享文件时，将该令牌作为 accessToken 传入
}

ctx := context.Background()

resp, httpRes, err := apiClient.ShareAPI.ListShareFiles(ctx, "share-code", "root-inode").
    List(1).
    AccessToken(shareAccessToken). // 验证提取码获取的分享访问令牌
    Limit(50).
    Execute()
if err != nil {
    panic(err)
}

if httpRes.StatusCode == 200 {
    for _, file := range resp.Contents {
        fmt.Printf("%s (%s)\\n", *file.Name, *file.Type)
    }
}

ctx := context.Background()

// 预览分享文件
httpRes, err := apiClient.ShareAPI.PreviewShareFile(ctx, "share-code", "file-inode").
    Preview(1).
    AccessToken(shareAccessToken).
    Execute()
if err != nil {
    panic(err)
}
fmt.Printf("Preview status: %d\\n", httpRes.StatusCode)

// 下载分享文件
httpRes2, err := apiClient.ShareAPI.DownloadShareFile(ctx, "share-code", "file-inode").
    Download(1).
    AccessToken(shareAccessToken).
    Execute()
if err != nil {
    panic(err)
}
fmt.Printf("Download status: %d\\n", httpRes2.StatusCode)

ctx := context.Background()

saveReq := client.SaveShareFileRequest{
    TargetSpaceId:    "your-space-id",
    TargetPath:       client.PtrString("/saved/"),
    SourceInodesPath: "/",
    Inodes:           []string{"file-inode-1"},
    ConflictResolutionStrategy: client.PtrString("rename"),
}

resp200, resp202, resp207, httpRes, err := apiClient.ShareAPI.SaveShareFile(ctx, "share-code").
    Save(1).
    SaveShareFileRequest(saveReq).
    AccessToken(shareAccessToken).
    Execute()
if err != nil {
    panic(err)
}

switch httpRes.StatusCode {
case 200:
    for _, item := range resp200.Result {
        fmt.Printf("status=%d path=%v\\n", *item.Status, item.Path)
    }
case 202:
    fmt.Printf("异步转存任务，taskId: %d\\n", *resp202.TaskId)
case 207:
    fmt.Println("部分成功")
    for _, item := range resp207.Result {
        fmt.Printf("status=%d path=%v\\n", *item.Status, item.Path)
    }
}