跳转至

📨 分享链接

分享链接功能允许您创建文件分享链接，让他人无需登录即可下载文件。

📋 功能概览

  • 创建分享 - 创建带密码或不带密码的分享链接
  • 管理分享 - 查看和修改现有分享设置
  • 分享列表 - 获取当前账户的分享列表

🚀 快速示例

from pan123 import Pan123

# 初始化客户端
pan = Pan123("your_access_token")

# 创建分享链接（分享7天，带密码）
result = pan.share.create(
    share_name="我的分享",
    share_expire=7,  # 7天后过期
    file_id_list=[123],  # 分享文件ID为123的文件
    share_pwd="1234"  # 访问密码
)
print(f"分享链接: {result['shareLink']}")

🛠️ 详细功能

创建分享

创建新的分享链接。

result = pan.share.create(share_name, share_expire, file_id_list, share_pwd, traffic_switch, traffic_limit_switch, traffic_limit)
参数 类型 必填 默认值 说明
share_name str 是 - 分享名称
share_expire int 是 - 分享链接有效期天数，只能填: 1、7、30、0（0表示永久分享）
file_id_list list 是 - 分享文件ID列表，最多支持100个文件ID
share_pwd str 否 "" 分享密码，留空表示无密码
traffic_switch bool 否 False 免登录流量包开关，True表示开启，False表示关闭
traffic_limit_switch bool 否 False 流量限制开关，True表示开启，False表示关闭
traffic_limit int 否 0 免登录限制流量，单位：字节，仅当流量限制开关开启时有效

返回值说明： - shareID - 分享的唯一标识ID - shareLink - 生成的分享链接 - shareKey - 分享的密钥

示例： 

# 创建一个带密码、7天后过期的分享
result = pan.share.create(
    share_name="项目文档",
    share_expire=7,
    file_id_list=[123, 456],  # 分享两个文件
    share_pwd="abcd"  # 设置密码
)

print(f"分享链接: {result['shareLink']}")
print(f"分享ID: {result['shareID']}")

修改分享设置

修改现有分享的设置（如流量限制等）。

result = pan.share.list_info(share_id_list, traffic_switch, traffic_limit_switch, traffic_limit)
参数 类型 必填 默认值 说明
share_id_list list 是 - 要修改的分享ID列表
traffic_switch bool 否 False 免登录流量包开关
traffic_limit_switch bool 否 False 流量限制开关
traffic_limit int 否 0 免登录限制流量，单位：字节

获取分享链接列表

获取当前账户创建的分享链接列表。

result = pan.share.list(limit, last_share_id)
参数 类型 必填 默认值 说明
limit int 是 - 每页返回的分享数量，最大不超过100
last_share_id int 否 0 用于分页，表示上一页最后一个分享的ID，首次查询填0

示例： 

# 获取前20个分享
shares = pan.share.list(limit=20)

# 分页获取分享（获取第一页后，用lastShareId作为下一页的起始点）
first_page = pan.share.list(limit=10)
last_share_id = first_page.get("data", {}).get("lastShareId", 0)
second_page = pan.share.list(limit=10, last_share_id=last_share_id)

📝 注意事项

  1. 有效期限制：分享链接有效期只能设置为1天、7天、30天或永久（0天）。
  2. 文件数量限制：单个分享最多包含100个文件。
  3. 密码设置：分享密码最多4位字符。
  4. 流量控制：通过流量限制功能可以控制免登录用户的下载流量。
  5. 分享管理：目前API不支持删除分享链接，只能通过修改设置来管理。

🔗 相关链接