Skip to content

Commit

Permalink
docs(drivers): update 139Yun driver documentation
Browse files Browse the repository at this point in the history
  • Loading branch information
@xrgzs
xrgzs committed Jan 20, 2025
1 parent 2463a6e commit 75f1606
Show file tree
Hide file tree
Showing 2 changed files with 214 additions and 108 deletions.
166 changes: 109 additions & 57 deletions docs/guide/drivers/139.md
View file
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, all files are filed.

- 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

0 comments on commit 75f1606

Please sign in to comment.