返回提交历史
Modified
favlist/action.md
+95
-28
XFEstudio/bilibili-API-collect
收藏夹操作APP端
6dd4f07
代码差异
1 个文件
+95
-28
@@ -1,29 +1,34 @@
1
1
# 收藏夹操作
2
2
3
3
- [收藏夹操作](#收藏夹操作)
4
- [新建收藏夹(web)](#新建收藏夹web)
5
- [修改收藏夹(web)](#修改收藏夹web)
6
- [删除收藏夹(web)](#删除收藏夹web)
4
- [新建收藏夹(双端)](#新建收藏夹双端)
5
- [修改收藏夹(双端)](#修改收藏夹双端)
6
- [删除收藏夹(双端)](#删除收藏夹双端)
7
- [清空所有失效内容(双端)](#清空所有失效内容双端)
7
8
8
9
---
9
10
10
## 新建收藏夹(web)
11
## 新建收藏夹(双端)
11
12
12
13
> https://api.bilibili.com/x/v3/fav/folder/add
13
14
14
15
*请求方式：POST*
15
16
16
认证方式：Cookie（SESSDATA）
17
认证方式：APP或Cookie（SESSDATA）
17
18
18
19
**正文参数（ application/x-www-form-urlencoded ）：**
19
20
20
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
21
| ------- | ---- | ---------- | ------ | ---------------- |
22
| title | str | 收藏夹标题 | 必要 | |
23
| intro | str | 收藏夹简介 | 非必要 | |
24
| privacy | int | 是否公开 | 非必要 | 0公开<br />1私密 |
25
| cover | str | 封面图url | 非必要 | 封面会被审核 |
26
| csrf | str | CSRF Token | 必要 | 位于Cookie |
21
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
22
| ---------- | ---- | ------------ | ----------- | ---------------------- |
23
| access_key | str | APP登录Token | APP方式必要 | |
24
| appkey | str | APP密钥 | APP方式必要 | 可为`1d8b6e7d45233436` |
25
| ts | int | 时间戳（秒） | APP方式必要 | |
26
| title | str | 收藏夹标题 | 必要 | |
27
| intro | str | 收藏夹简介 | 非必要 | |
28
| privacy | int | 是否公开 | 非必要 | 0公开<br />1私密 |
29
| cover | str | 封面图url | 非必要 | 封面会被审核 |
30
| csrf | str | CSRF Token | 必要 | 位于Cookie |
31
| sign | str | APP签名 | APP方式必要 | |
27
32
28
33
**json回复：**
29
34
@@ -135,24 +140,28 @@
135
140
136
141
</details>
137
142
138
## 修改收藏夹(web)
143
## 修改收藏夹(双端)
139
144
140
145
> https://api.bilibili.com/x/v3/fav/folder/edit
141
146
142
147
*请求方式：POST*
143
148
144
认证方式：Cookie（SESSDATA）
149
认证方式：APP或Cookie（SESSDATA）
145
150
146
151
**正文参数（ application/x-www-form-urlencoded ）：**
147
152
148
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
149
| -------- | ---- | ---------------- | ------ | ---------------- |
150
| title | str | 新收藏夹标题 | 必要 | |
151
| intro | str | 新收藏夹简介 | 非必要 | |
152
| privacy | int | 是否公开 | 非必要 | 0公开<br />1私密 |
153
| cover | str | 封面图url | 非必要 | 封面会被审核 |
154
| csrf | str | CSRF Token | 必要 | 位于Cookie |
155
| media_id | int | 欲修改的收藏夹id | 必要 | |
153
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
154
| ---------- | ---- | ---------------- | ----------- | ---------------------- |
155
| access_key | str | APP登录Token | APP方式必要 | |
156
| appkey | str | APP密钥 | APP方式必要 | 可为`1d8b6e7d45233436` |
157
| ts | int | 时间戳（秒） | APP方式必要 | |
158
| title | str | 新收藏夹标题 | 必要 | |
159
| intro | str | 新收藏夹简介 | 非必要 | |
160
| privacy | int | 是否公开 | 非必要 | 0公开<br />1私密 |
161
| cover | str | 封面图url | 非必要 | 封面会被审核 |
162
| csrf | str | CSRF Token | 必要 | 位于Cookie |
163
| media_id | int | 欲修改的收藏夹id | 必要 | |
164
| sign | str | APP签名 | APP方式必要 | |
156
165
157
166
**json回复：**
158
167
@@ -266,20 +275,24 @@
266
275
267
276
</details>
268
277
269
## 删除收藏夹(web)
278
## 删除收藏夹(双端)
270
279
271
280
> https://api.bilibili.com/x/v3/fav/folder/del
272
281
273
282
*请求方式：POST*
274
283
275
认证方式：Cookie（SESSDATA）
284
认证方式：APP或Cookie（SESSDATA）
276
285
277
286
**正文参数（ application/x-www-form-urlencoded ）：**
278
287
279
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
280
| --------- | ---- | ----------------------- | ------ | ------------------ |
281
| media_ids | int | 收藏夹id | 必要 | 看名字貌似可以多个 |
282
| csrf | str | CSRF Token (位于Cookie) | 必要 | |
288
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
289
| ---------- | ---- | ----------------------- | ----------- | ---------------------- |
290
| access_key | str | APP登录Token | APP方式必要 | |
291
| appkey | str | APP密钥 | APP方式必要 | 可为`1d8b6e7d45233436` |
292
| ts | int | 时间戳（秒） | APP方式必要 | |
293
| media_ids | int | 收藏夹id | 必要 | 看名字貌似可以多个 |
294
| csrf | str | CSRF Token (位于Cookie) | 必要 | |
295
| sign | str | APP签名 | APP方式必要 | |
283
296
284
297
**json回复：**
285
298
@@ -315,4 +328,58 @@
315
328
}
316
329
```
317
330
331
</details>
332
333
## 清空所有失效内容(双端)
334
335
> https://api.bilibili.com/x/v3/fav/resource/clean
336
337
*请求方式：POST*
338
339
认证方式：APP或Cookie（SESSDATA）
340
341
**正文参数（ application/x-www-form-urlencoded ）：**
342
343
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
344
| ---------- | ---- | ---------------- | ----------- | ---------------------- |
345
| access_key | str | APP登录Token | APP方式必要 | |
346
| appkey | str | APP密钥 | APP方式必要 | 可为`1d8b6e7d45233436` |
347
| csrf | str | CSRF Token | 必要 | 位于Cookie |
348
| media_id | int | 欲清理的收藏夹id | 必要 | |
349
| sign | str | APP签名 | APP方式必要 | |
350
351
**json回复：**
352
353
根对象：
354
355
| 字段 | 类型 | 内容 | 备注 |
356
| ------- | ---- | -------- | ------- |
357
| code | num | 返回值 | 0：成功 |
358
| message | str | 错误信息 | 默认为0 |
359
| ttl | num | 1 | |
360
| data | obj | 信息本体 | 成功为0 |
361
362
**示例：**
363
364
清理id为`1161340172`的收藏夹:
365
366
```shell
367
curl -G 'https://api.bilibili.com/x/v3/fav/resource/clean' \
368
--data-urlencode 'csrf=563e9d79a8e289dbd96604668edfa802' \
369
--data-urlencode 'media_id=1161340172' \
370
-b 'SESSDATA=00cbbdf2%2C1628861933%2Ce228c%2A21; bili_jct=563e9d79a8e289dbd96604668edfa802;'
371
```
372
373
<details>
374
<summary>查看响应示例：</summary>
375
376
```json
377
{
378
"code":0,
379
"message":"0",
380
"ttl":1,
381
"data":0
382
}
383
```
384
318
385
</details>