📚 帮助文档

快速了解如何使用 聚合网盘 进行文件管理和分享

📋 快速导航

📖 使用说明

重要提醒： 请仔细阅读以下使用条款
  • 文件所有权：文件所有权归上传者所有，请勿上传任何违反中国大陆法律法规的内容
  • 流量管理：流量每月1号清零，流量不累计，超出流量后，文件将无法下载
  • 文件限制：文件类型不限制，单个文件大小限制为 4.0GB
  • 存储安全：建议重要文件请做好本地备份，平台不保证文件永久保存
  • 分享功能：仅会员用户可使用文件分享功能，分享链接可设置有效期
专业提示： 开通会员可享受更大存储空间和直链加速服务

⬆️ 文件上传 API

POST 接口地址

目标文件夹URL - 接口地址填写用户目录下的任意文件夹地址，无需事先创建文件夹

接口会自动创建不存在的文件夹，文件会上传到指定的文件夹下

📋 请求参数

参数名 类型 必需 说明
token string 是 用户鉴权token，可在用户中心获取
file file 是 要上传的文件（form-data格式）

💻 请求示例

curl -X POST \ -F "file=@/path/to/your/file.jpg" \ -F "token=YOUR_TOKEN" \ http://pan.superbed.cn/disk/xxxx/documents/

📤 返回示例

{ "err": 0, "path": "xxxx/documents/demo.jpg" }

🗑️ 文件删除 API

DELETE 接口地址

文件完整URL - 需要删除的文件的完整访问地址

警告： 删除操作不可恢复，请谨慎操作！

📋 请求参数

参数名 类型 必需 说明
token string 是 用户鉴权token，与上传时使用的token相同

💻 请求示例

curl -X DELETE \ -d "token=YOUR_TOKEN" \ http://pan.superbed.cn/disk/xxxx/documents/demo.jpg

📤 返回示例

{ "err": 0, "msg": "demo.jpg删除成功" }

💡 使用示例

📁 批量上传脚本

#!/bin/bash
# 批量上传脚本示例

TOKEN="YOUR_TOKEN"
BASE_URL="http://pan.superbed.cn/disk/YOUR_CODE/"
FOLDER="uploads"

for file in "$FOLDER"/*; do
    if [ -f "$file" ]; then
        echo "上传文件: $file"
        curl -X POST \
            -F "file=@$file" \
            -F "token=$TOKEN" \
            "$BASE_URL"
        echo ""
    fi
done

🐍 Python 上传示例

import requests

def upload_file(file_path, token, target_url):
    """上传文件到服务器"""
    with open(file_path, 'rb') as f:
        files = {'file': f}
        data = {'token': token}

        response = requests.post(target_url, files=files, data=data)

        if response.status_code == 200:
            result = response.json()
            if result['err'] == 0:
                print(f"上传成功: {result['path']}")
            else:
                print(f"上传失败: {result}")
        else:
            print(f"请求失败: {response.status_code}")

# 使用示例
upload_file(
    file_path='/path/to/your/file.jpg',
    token='YOUR_TOKEN',
    target_url='http://pan.superbed.cn/disk/YOUR_CODE/documents/'
)

❓ 常见问题

Q: 如何获取我的 token？

A: 登录后进入用户中心，在 API 设置页面可以找到您的专属 token。

Q: 上传的文件会被公开吗？

A: 不会。默认情况下，只有您自己可以访问上传的文件。如需分享，请使用分享功能生成分享链接。

Q: 支持断点续传吗？

A: 目前网页上传支持断点续传，API 暂不支持此功能。

Q: 如何设置文件夹权限？

A: 在用户中心的设置页面，可以配置文件的访问权限和直链功能。

需要更多帮助？ 请联系客服或查看用户社区的更多教程