Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs(drivers): update 139Yun driver documentation #402

Merged
merged 1 commit into from
Jan 27, 2025
Merged

docs(drivers): update 139Yun driver documentation #402

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
166 changes: 109 additions & 57 deletions docs/guide/drivers/139.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -18,108 +18,175 @@ star: true
---
# 139Yun

Cloud disk address：**https://yun.139.com/**
Cloud disk address: **<https://yun.139.com/>**

- :warning: The alist version must be greater than `v3.18.0` to use this tutorial (excluding v3.18.0)
:::warning

The alist version must be greater than `v3.41.0` to use this tutorial.

:::

:::tip

Update the method of authentication, please get `Authorization` to fill in
Parameters can be obtained from the browser DevTools -> Network by [searching keywords](#search-keywords).

:::

<br/>

## **Proxy Range**

You need to enable `Web Proxy` or`Webdav Native Proxy` to take effect

## **Root folder ID**

- Personal cloud：It can be left blank and it will be filled in automatically. All will be listed, covering 18 items (check it yourself). Normal files are in **My Folder**.
- If you fill in the folder ID, the normal root directory folder is listed (this method is recommended)
- Currently only applicable to: `alias`、`139Yun`、`AList V3`

- Family cloud：The root directory is empty is all files
- If you want to list a folder separately, get the directory ID method in the picture of the [family cloud](#family-cloud) below
- Personal new：`/`，It can be left blank and it will be automatically filled in and everything will be listed.
- If you want to list a folder separately, get the directory ID method in the picture of the [Personal new](#personal-new) below
- Function Description: **<https://github.com/alist-org/alist/pull/6496#issue-2309839607>**

<br/>

## **Authorization**

Update the method of authentication, please get `Authorization` to fill in

## **Proxy Range**
:::warning

You need to enable `Web Proxy` or` Webdav Native Proxy` to take effect
Fill in the content starting after the Basic and a space, **do not include Basic**!

- Currently only applicable to：`alias`、`139Yun`、`AList V3`
- Function Description：**https://github.com/alist-org/alist/pull/6496#issue-2309839607**
:::

<br/>
## **Type**

Alist currently supports 4 types of cloud storage:

- Personal New: New API

## **Type**
- Note: The account has been migrated to a new personal cloud by the end of 2024

- Use the PUT method to directly connect to EOS multipart uploads

1. Personal Cloud: Choose Personal Cloud
- Family: My Family -> Family Files

2. Family Cloud: Choose Family Cloud
- Limit: The Family Cloud does not support copying, moving, or renaming folders, and files cannot be uploaded to the root directory

3. Personal new：New API
- Only newly registered accounts are available. You can distinguish them by searching for `getDisk` in the request. If it can be found, it is the old version. If it cannot be found, it is the new version.
- Use the POST method to resumable uploads

- Group: Shared Group

If you have a new version of the API, you will not be able to use the `Personal Cloud` type. Although there is no error message, the file will not be loaded.
- Limit: Shared groups do not support copying and uploading

If there is a `getDisk` request, the `New Personal` type cannot be used, otherwise it will prompt `User does not exist`
- Personal: The old personal cloud, which is a thing of the past.

<br/>

## **Root folder ID**

Specifies the directory to be mounted.

## **Other**
:::warning

1. Other information is taken from the request, which has changed from cookie to obtaining `Authorization`
1. The new personal cloud can be obtained in another way. See the picture example of [Personal new](#personal-new)
Please remember to clear or change this Root folder ID after changed the Type!

:::

2. If you can't find the load on the bottom of the request information, go to the top `on the top of the upper row, marked the purple highlight
- Personal New: `/`. It can be left blank and it will be filled in automatically.

- If you want to list a folder separately, please enter the folder ID.

- Family: If the root directory is empty, all files are filed.

- If you want to list a folder separately, please enter the folder ID.

- Group: If the root directory is empty, the group ID will be automatically filled. It is recommended to enter the folder ID that you manually obtained.

- If you want to list a folder separately, please enter the folder ID.

- Note: If you want to mount a group created by others, be sure to fill in the folder ID that you manually obtained, otherwise there will be an infinite loop in the first-level folder.

- Personal: `root`. It can be left blank and it will be filled in automatically. All will be listed, covering 18 items (check it yourself). Normal files are in **My Folder**.

- If the write folder ID is listed in the normal root folder.

<br/>

## **Cloud ID**

Personal cloud does not need to fill in, **Family / Group cloud is dedicated**.

### **Cloud ID**
- Family: family ID, **cannot be empty**

Personal cloud does not need to fill in, **Family cloud is dedicated**.
- Group: group ID, **cannot be empty**

<br/>

## **Custom upload part size**

The upload part size (bytes) can be customized by the user, and if there is a performance issue, please adjust it yourself. Set '0' to 100 MB by default.

- The current upload part size on the web is 20 MB (20971520).

- The [EOS documentation](https://ecloud.10086.cn/op-help-center/api/article/40933) used by the new version of the Personal Cloud states that "objects larger than > 5 GB cannot be uploaded", so the upload part size should not exceed 5 GB.

## **Other**

- Other information is taken from the request, which has changed from cookie to obtaining `Authorization`
- The new personal cloud can be obtained in another way. See the picture example of [Personal new](#personal-new)

- If you can't find the load on the bottom of the request information, go to the top `on the top of the upper row, marked the purple highlight

<br/>

### **Search keywords**

Pay attention to the keywords, use it below to get **`authorization`**
Pay attention to the keywords, use it below to get **`authorization`**, **Root folder ID** and **Cloud ID**

- Personal Cloud: **getDisk**
- Family Cloud: **queryContentList**

- Personal Cloud：**getDisk**
- Family Cloud：**queryContentList**
- Personal New: hcy/file/**list**

- Headers - `Authorization`

- Payload - `parentFileId`: folder ID

- Family: **queryContentList**

- Headers - `Authorization`

- Payload - `cloudID`: family ID

- Payload - `catalogID`: folder ID

- Response - `data.path`: full folder ID

- Group: **queryGroupContentList**

- Headers - `Authorization`

- Payload - `groupID`: group ID

- Payload - `path`: full folder ID

- Personal: **getDisk**

<br/>

### **Personal new:**

<div class="image-preview">
<img src="/img/drivers/139/new_personal.png" alt="Personal new" title="Personal new"/>
</div>

<br/>

### **Personal cloud：**
### **Personal cloud:**

<div class="image-preview">
<img src="/img/drivers/139/other-personal.png" alt="Other Browser" title="Other Browser"/>
<img src="/img/drivers/139/ch-personal.png" alt="Chrome Browser" title="Chrome Browser"/>
</div>
<br/>



Note: Family cloud does not support renames, movement, copying and uploading.

### **Family cloud：**

Note: Family cloud does not support renames, movement, copying and uploading.
### **Family cloud:**

<div class="image-preview">
<img src="/img/drivers/139/other-family.png" alt="Other Browser" title="Other Browser"/>
Expand All @@ -130,27 +197,15 @@ Note: Family cloud does not support renames, movement, copying and uploading.

Although the video is V2 version, the way to obtain the directory ID and the cloud ID is the same.

**https://www.bilibili.com/video/BV1US4y1w79a**
**<https://www.bilibili.com/video/BV1US4y1w79a>**

From the previous way to get cookies, now replaced it with `Authorization`，You can see the [Fill in the Example](#alist-fill-in-examples) tutorial below

:::

<br/>



### **Personal new：**

<div class="image-preview">
<img src="/img/drivers/139/new_personal.png" alt="Personal new" title="Personal new"/>
</div>

<br/>



### **AList fill in examples：**
### **AList fill in examples:**

- ==`Authorization`Just fill in the content of the start after the basic space==
- The new personal cloud folder ID will automatically change after you enter the folder. Just open whichever folder you need, and then get the value of `currentCatalogID`^Figure_3^
Expand All @@ -163,9 +218,6 @@ From the previous way to get cookies, now replaced it with `Authorization`，You

<br/>




### **The default download method used**

```mermaid
Expand Down
Loading