Skip to content

Commit ad6aa33

Browse files
xrgzsxrgzs
authored
docs(drivers): update 139Yun driver documentation (#402)
1 parent 2463a6e commit ad6aa33

File tree

2 files changed

+214
-108
lines changed

2 files changed

+214
-108
lines changed

‎docs/guide/drivers/139.md

Lines changed: 109 additions & 57 deletions
Original file line numberDiff line numberDiff line change
@@ -18,108 +18,175 @@ star: true
1818
---
1919
# 139Yun
2020

21-
Cloud disk address：**https://yun.139.com/**
21+
Cloud disk address: **<https://yun.139.com/>**
2222

23-
- :warning: The alist version must be greater than `v3.18.0` to use this tutorial (excluding v3.18.0)
23+
:::warning
24+
25+
The alist version must be greater than `v3.41.0` to use this tutorial.
26+
27+
:::
2428

2529
:::tip
2630

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

2933
:::
3034

3135
<br/>
3236

37+
## **Proxy Range**
3338

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

35-
## **Root folder ID**
36-
37-
- 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**.
38-
- If you fill in the folder ID, the normal root directory folder is listed (this method is recommended)
41+
- Currently only applicable to: `alias`、`139Yun`、`AList V3`
3942

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

4545
<br/>
4646

47+
## **Authorization**
4748

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

49-
## **Proxy Range**
51+
:::warning
5052

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

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

56-
<br/>
57+
## **Type**
5758

59+
Alist currently supports 4 types of cloud storage:
5860

61+
- Personal New: New API
5962

60-
## **Type**
63+
- Note: The account has been migrated to a new personal cloud by the end of 2024
64+
65+
- Use the PUT method to directly connect to EOS multipart uploads
6166

62-
1. Personal Cloud: Choose Personal Cloud
67+
- Family: My Family -> Family Files
6368

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

66-
3. Personal new：New API
67-
- 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.
71+
- Use the POST method to resumable uploads
6872

73+
- Group: Shared Group
6974

70-
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.
75+
- Limit: Shared groups do not support copying and uploading
7176

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

7479
<br/>
7580

81+
## **Root folder ID**
7682

83+
Specifies the directory to be mounted.
7784

78-
## **Other**
85+
:::warning
7986

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

83-
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
91+
- Personal New: `/`. It can be left blank and it will be filled in automatically.
92+
93+
- If you want to list a folder separately, please enter the folder ID.
94+
95+
- Family: If the root directory is empty, all files are filed.
96+
97+
- If you want to list a folder separately, please enter the folder ID.
98+
99+
- 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.
100+
101+
- If you want to list a folder separately, please enter the folder ID.
102+
103+
- 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.
104+
105+
- 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**.
106+
107+
- If the write folder ID is listed in the normal root folder.
84108

85109
<br/>
86110

111+
## **Cloud ID**
87112

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

89-
### **Cloud ID**
115+
- Family: family ID, **cannot be empty**
90116

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

93119
<br/>
94120

121+
## **Custom upload part size**
122+
123+
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.
95124

125+
- The current upload part size on the web is 20 MB (20971520).
126+
127+
- 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.
128+
129+
## **Other**
130+
131+
- Other information is taken from the request, which has changed from cookie to obtaining `Authorization`
132+
- The new personal cloud can be obtained in another way. See the picture example of [Personal new](#personal-new)
133+
134+
- 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
135+
136+
<br/>
96137

97138
### **Search keywords**
98139

99-
Pay attention to the keywords, use it below to get **`authorization`**
140+
Pay attention to the keywords, use it below to get **`authorization`**, **Root folder ID** and **Cloud ID**
141+
142+
- Personal Cloud: **getDisk**
143+
- Family Cloud: **queryContentList**
100144

101-
- Personal Cloud：**getDisk**
102-
- Family Cloud：**queryContentList**
145+
- Personal New: hcy/file/**list**
146+
147+
- Headers - `Authorization`
148+
149+
- Payload - `parentFileId`: folder ID
150+
151+
- Family: **queryContentList**
152+
153+
- Headers - `Authorization`
154+
155+
- Payload - `cloudID`: family ID
156+
157+
- Payload - `catalogID`: folder ID
158+
159+
- Response - `data.path`: full folder ID
160+
161+
- Group: **queryGroupContentList**
162+
163+
- Headers - `Authorization`
164+
165+
- Payload - `groupID`: group ID
166+
167+
- Payload - `path`: full folder ID
168+
169+
- Personal: **getDisk**
103170

104171
<br/>
105172

173+
### **Personal new:**
106174

175+
<div class="image-preview">
176+
<img src="/img/drivers/139/new_personal.png" alt="Personal new" title="Personal new"/>
177+
</div>
178+
179+
<br/>
107180

108-
### **Personal cloud：**
181+
### **Personal cloud:**
109182

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

116-
117-
118-
Note: Family cloud does not support renames, movement, copying and uploading.
119-
120-
### **Family cloud：**
121-
122-
Note: Family cloud does not support renames, movement, copying and uploading.
189+
### **Family cloud:**
123190

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

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

133-
**https://www.bilibili.com/video/BV1US4y1w79a**
200+
**<https://www.bilibili.com/video/BV1US4y1w79a>**
134201

135202
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
136203

137204
:::
138205

139206
<br/>
140207

141-
142-
143-
### **Personal new：**
144-
145-
<div class="image-preview">
146-
<img src="/img/drivers/139/new_personal.png" alt="Personal new" title="Personal new"/>
147-
</div>
148-
149-
<br/>
150-
151-
152-
153-
### **AList fill in examples：**
208+
### **AList fill in examples:**
154209

155210
- ==`Authorization`Just fill in the content of the start after the basic space==
156211
- 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^
@@ -163,9 +218,6 @@ From the previous way to get cookies, now replaced it with `Authorization`，You
163218

164219
<br/>
165220

166-
167-
168-
169221
### **The default download method used**
170222

171223
```mermaid

0 commit comments

Comments
 (0)