aligo

🚀🔥 简单、易用、可扩展的阿里云盘 API 接口库 👍👍

wiki 文档 + examples

文档写得很简单，详情请查看代码提示 + 文档注释

>

有任何疑问请 issue

>

附带一份文档阿里云盘开放平台文档

安装

pip install -U aligo
pip install git+https://github.com/foyoux/aligo.git

Notes： 最近官方更新了接口，导致 getfilelist 无法直接获取下载链接，现在需要单独使用 getdownloadurl 接口获取下载链接。

>

对于不常用（没有封装）的接口，可以直接通过 self.post 方法直接发送请求。

>

接口变动较多，有问题请反馈，我会尽快修复。

快速入门

"""快速入门"""
from aligo import Aligo
if name == 'main':     ali = Aligo()  # 第一次使用，会弹出二维码，供扫描登录
user = ali.get_user()  # 获取用户信息     print(user.username, user.nickname, user.phone)  # 打印用户信息
filelist = ali.getfile_list()  # 获取网盘根目录文件列表     for file in file_list:  # 遍历文件列表         # 注意：print(file) 默认只显示部分信息，但是实际上file有很多的属性         print(file.file_id, file.name, file.type)  # 打印文件信息

https://user-images.githubusercontent.com/35125624/150529002-c2f1b80b-fb11-4e0a-9fd7-6f57f678ccf5.mp4

基本功能

[x] 完全的代码提示
[x] 持久化登录、多帐户登录
[x] 福利码兑换
[x] 文件夹同步
[x] 在线解压缩
[x] 支持功能扩展
[x] 搜索文件/标签
[x] 获取重复文件列表
[x] 文件（夹）重命名
[x] 文件（夹）上传下载
[x] 文件（夹）移动复制
[x] 文件（夹）删除恢复
[x] 获取文档在线预览接口
[x] 文件（夹）分享保存收藏
[x] 文件（夹）自定义分享（无限制）
[x] 获取帐户、云盘（容量）等基本信息
[x] 相册创建删除修改添加文件获取文件

Notes：

1. 由于秒传链接的失效，自定分享信息的有效期只有4个小时。

2. 阿里云盘不同于其他网盘或系统，其定位文件不是基于文件名（路径），而是通过 fileid，这才是唯一定位文件的方式，aligo 中提供了简便函数 getfilebypath/getfolderbypath，通过网盘路径获取文件对象，通过其上的 fileid 属性即可获取所需文件标识。但不建议频繁使用此方法，因为内部是通过 getfilelist 遍历得到的。

3. 在保存超大分享时（分享中的文件特别多），执行保存全部的方法 - sharefilesavealltodrive，它会立刻执行完毕，但是文件不会立刻被保存到网盘中，阿里云盘服务器会帮你在后台陆续将所有文件存到你的网盘中；所有当你使用 sharefilesavealltodrive 保存超大分享时，却只看到一部分文件时，不用疑惑，这是正常情况。

from aligo import Aligo, EMailConfig
   
   if name == 'main':
       email_config = EMailConfig(
           email='<接收登录邮件的邮箱地址>',
           # 自配邮箱
           user='',
           password='',
           host='',
           port=0,
       )
       ali = Aligo(email=email_config)

如何操作资源盘

from aligo import Aligo
if name == 'main':     ali = Aligo()
drives = ali.listmydrives()     # resourcedriveid = [drive.driveid for drive in drives if drive.drivename == 'resource'][0]
v2user = ali.v2user_get()     resourcedriveid = v2user.resourcedrive_id
# 如果后续默认操作资源盘     # ali.defaultdriveid = resourcedriveid
filelist = ali.getfilelist(driveid=resourcedriveid)     for file in file_list:         print(file)

如何自定义配置文件路径

from aligo import setconfigfolder, Aligo
if name == 'main':     # 创建 Aligo 对象前，先设置配置文件目录，默认是 <用户目录>/.aligo     setconfigfolder('/home/aligo')     # 会创建 /home/aligo/小号1.json 配置文件     ali1 = Aligo(name='小号1')     # 会创建 /home/aligo/小号2.json 配置文件     ali2 = Aligo(name='小号2')