aligo 4.5.0

aliyundrive apis package

aligo

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

wiki 文档 + examples

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

有任何疑问 请 issue 或 加入 aligo交流反馈群 （群二维码在底部）

如果觉得好用，欢迎 ⭐star 和 fork ！

pip install --upgrade aligo

快速入门

"""快速入门"""
from aligo import Aligo

if __name__ == '__main__':
    ali = Aligo()  # 第一次使用，会弹出二维码，供扫描登录

    user = ali.get_user()  # 获取用户信息
    print(user.user_name, user.nick_name, user.phone)  # 打印用户信息

    ll = ali.get_file_list()  # 获取网盘根目录文件列表
    for file in ll:  # 遍历文件列表
        print(file.file_id, file.name, file.type)  # 打印文件信息

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

基本功能

• 完全的代码提示
• 福利码兑换
• 文件夹同步
• 在线解压缩
• 支持功能扩展
• 搜索文件/标签
• 文件（夹）重命名
• 文件（夹）上传下载
• 文件（夹）移动复制
• 文件（夹）删除恢复
• 文件（夹）分享收藏
• 持久化登录、多帐户登录
• 文件（夹）自定义分享（无限制）
• 获取帐户、云盘（容量）等基本信息
• ⭐⭐⭐ 欢迎大家发起 新功能请求

温馨提示：

1. 由于秒传链接的失效，自定分享信息的有效期只有4个小时。
2. 阿里云盘不同于其他网盘或系统，其定位文件不是基于文件名（路径），而是通过 file_id，这才是唯一定位文件的方式，aligo 中提供了简便函数 get_file_by_path，通过网盘路径获取文件对象，通过 其上的 file_id 属性即可获取所需文件标识。但不建议频繁使用此方法，因为内部是通过 get_file_list 遍历得到的。

网页扫码登录

from aligo import Aligo

# 提供 port 参数即可, 之后打开浏览器访问 http://<YOUR_IP>:<port>
ali = Aligo(port=8080)

发送登录二维码到邮箱（推荐）

最佳实践：建议将邮箱绑定到微信，这样能实时收到提醒，登录过期后也可以第一时间收到登录请求。

安全性问题：虽然自带公开邮箱，但是他人并不能通过这个获取任何人发送的邮件，所以 防伪字符串 策略是安全的。

from aligo import Aligo


"""
email: 发送扫码登录邮件 ("接收邮件的邮箱地址", "防伪字符串"). 提供此值时，将不再弹出或打印二维码
        关于防伪字符串: 为了方便大家使用, aligo 自带公开邮箱, 省去邮箱配置的麻烦.
        所以收到登录邮件后, 一定要对比确认防伪字符串和你设置一致才可扫码登录, 否则将导致: 包括但不限于云盘文件泄露.
"""

# 提供 email 参数即可
ali = Aligo(email=('[e-mail]', '防伪字符串，可任意字符串'))

如何彻底删除文件？

无需先移动文件到回收站

此功能太危险，aligo 未直接提供。不过 这里 扩展了该功能，请小心使用！

关于扩展功能

这个功能讲得很少，因为觉得没什么好讲的，参考 彻底删除文件 章节应该一下子就可以看懂。

一直也没有人反馈或者咨询这个功能，觉得用的人大概很少，所以稍微说下。

一般步骤：

1. 使用浏览器或其他抓包工具，观察通信过程；
2. 获取 url/path + 请求体；
3. 继承 `Aligo`, 使用现有的方法 `self._post` 等，进行发送请求；

会自动维护 token, 你只需关注如何发送请求即可。

扩展功能举栗🌰

---

❤️‍🔥欢迎加入🤝🏼	🍗接受捐赠😘
😃 二维码会保持更新 😜	☕😁 谢谢老板 🎉🎉🌹🌹