115 开放平台

提示

使用官方 115开放平台 API 开发

请仔细阅读注意事项

请规范使用帐号，包含但不限于 多人共享使用、图床、软件床 和 视频外链到视频网站播放 等分发服务以及一些没有提到的不规范使用的方式导致帐号被封禁的，后果自负

1.必要条件

必须有 115 的帐号

注意事项

速度与稳定性与本地网络环境，115 服务器的网络环境以及 OpenList 的运行机器的性能有关

2.准备接入

2.1.开放平台注册应用（可选，如果使用OpenList/公益服务器/自建服务器内置的密钥对，则不用创建）

提示

请根据115 开放平台的要求注册应用

开放平台地址: 115 开放平台:https://open.115.com

2.2.获取令牌

1. 访问api.oplist.org ⚠️如果使用公益服务器/自建服务器，请访问公益服务器/自建服务器的地址
2. 在下拉框中选择 115 验证网盘

3. 如果你使用的是 OpenList （或者公益服务器/自建服务器）内置的密钥对（即：自身没有115开放平台的应用信息），请按照3.1、3.2和3.3进行配置
   3.1. 勾选使用 OpenList 提供的参数。
   3.2. 客户端ID（ClientID/AppID）和应用秘钥 (AppKey/Secret)均留空
   3.3. 点击获取Token按钮。

4. 如果你使用的是自己创建的 OAuth 客户端 ID 和密钥，请按照4.1、4.2和4.3进行配置
   4.1. 不要勾选使用 OpenList 提供的参数。
   4.2. 在客户端ID中填写你的AppId，在应用密钥中填写你的AppSecret
   4.3. 点击获取Token按钮。

5. 在弹出的窗口中，登录你的 115 账号，并授权 OpenList 访问你的 115 网盘。

6. 授权成功后，页面会显示你的 访问令牌（Access Token） 和 刷新令牌（Refresh Token），请复制并保存这两个令牌。

3.在OpenList中添加115网盘

3.1. 配置说明

3.1.1.根文件夹 ID

默认根目录ID为：0

打开 115 网盘官网，点击进入要设置的文件夹时点击 URL 中 cid后面的数字

如 https://115.com/?cid=249163533602609229&offset=0&tab=&mode=wangpan

这个文件夹的 根文件夹ID 即为 249163533602609229

3.2.开始添加

1. 打开 Alist 的管理界面，点击左侧菜单中的存储。
2. 在存储列表页面，点击右上角的添加存储按钮。
3. 选择驱动为115 开放平台。
   
   
4. 输入挂载路径，如：115。
5. 在根文件夹 ID中填写上面获取的根文件夹 ID（请参考3.1.1.根文件夹 ID）。
6. 刷新令牌中填写上面获取的刷新令牌和Access token（如未获取，请参考2. 准备接入）。
7. 如果你使用的是 OpenList （或者公益服务器/自建服务器）提供的 OAuth 客户端 ID 和密钥，请按照7.1和7.2进行配置
   7.1. 在Use online api中勾选，表示使用 OpenList 提供的在线 API。
   7.2. Api url address填写为 https://api.oplist.org/115cloud/renewapi，如果是公益服务器/自建服务器，请填写对应的服务器地址。

8. 如果你使用的是自己创建的 OAuth 客户端 ID 和密钥，请按照8.1和8.2进行配置
   8.1. 在Use online api中不勾选，表示使用自建的 OAuth 客户端 ID 和密钥。
   8.2. 在客户端ID中填写你的Oauth 客户端 ID，在客户端密钥中填写你的Oauth 客户端密钥

9. 点击添加按钮，完成115网盘的添加。

4.关于Use online api选项的说明

4.1.自身有密钥的情况下，AccessToken刷新的方式

4.2.自身没有密钥的情况下，AccessToken刷新的方式

5.注意事项

Token 泄漏后处理方法

如果不小心泄漏了 Token，可以前往115设备登录管理解除应用授权

• 115 APP：【iOS 、Android】版本 需要 ≥ 35.11.0
• 115 网页端：https://115.com/?mode=device_manage

失效后会提示如下内容：

failed get objs: failed to list objs: code: 40140116, message: no auth

一个帐号可以在同一个应用获取两次Refresh token，第三次获取后第一次获取到的Refresh token就会失效，使用第一个Refresh token会提示上面的错误

6.使用其他 APP ID 获取刷新令牌（尚未实现）

提示

开发中, 教程暂未更新, 敬请期待!

7.手机扫码授权PKCE模式（尚未实现）

提示

开发中, 教程暂未更新, 敬请期待!

8.默认使用的下载方式