返回提交历史
Modified
fav/action.md
+198
-10
XFEstudio/bilibili-API-collect
添加【收藏夹批量操作】相关api
ef94d78
代码差异
1 个文件
+198
-10
@@ -1,14 +1,19 @@
1
1
# 收藏夹操作
2
2
3
3
- [收藏夹操作](#收藏夹操作)
4
- [新建收藏夹](#新建收藏夹)
5
- [修改收藏夹](#修改收藏夹)
6
- [删除收藏夹](#删除收藏夹)
7
- [清空所有失效内容](#清空所有失效内容)
4
- [管理收藏夹](#管理收藏夹)
5
- [新建收藏夹](#新建收藏夹)
6
- [修改收藏夹](#修改收藏夹)
7
- [删除收藏夹](#删除收藏夹)
8
- [管理收藏内容](#管理收藏内容)
9
- [批量复制内容](#批量复制内容)
10
- [清空所有失效内容](#清空所有失效内容)
8
11
9
12
---
10
13
11
## 新建收藏夹
14
## 管理收藏夹
15
16
### 新建收藏夹
12
17
13
18
> http://api.bilibili.com/x/v3/fav/folder/add
14
19
@@ -41,7 +46,7 @@
41
46
42
47
略....
43
48
44
详见【[获取收藏夹元数据](info.md#获取收藏夹元数据)】中的`data`对象
49
详见[获取收藏夹元数据](info.md#获取收藏夹元数据)中的`data`对象
45
50
46
51
**示例：**
47
52
@@ -101,7 +106,7 @@ curl 'http://api.bilibili.com/x/v3/fav/folder/add' \
101
106
102
107
</details>
103
108
104
## 修改收藏夹
109
### 修改收藏夹
105
110
106
111
> http://api.bilibili.com/x/v3/fav/folder/edit
107
112
@@ -135,7 +140,7 @@ curl 'http://api.bilibili.com/x/v3/fav/folder/add' \
135
140
136
141
略....
137
142
138
详见【[获取收藏夹元数据](info.md#获取收藏夹元数据)】中的`data`对象
143
详见[获取收藏夹元数据](info.md#获取收藏夹元数据)中的`data`对象
139
144
140
145
**示例：**
141
146
@@ -196,7 +201,7 @@ curl 'http://api.bilibili.com/x/v3/fav/folder/edit' \
196
201
197
202
</details>
198
203
199
## 删除收藏夹
204
### 删除收藏夹
200
205
201
206
> http://api.bilibili.com/x/v3/fav/folder/del
202
207
@@ -247,7 +252,189 @@ curl 'http://api.bilibili.com/x/v3/fav/folder/del' \
247
252
248
253
</details>
249
254
250
## 清空所有失效内容
255
## 管理收藏内容
256
257
### 批量复制内容
258
259
> http://api.bilibili.com/x/v3/fav/resource/copy
260
261
*请求方式：POST*
262
263
认证方式：APP或Cookie（SESSDATA）
264
265
**正文参数（ application/x-www-form-urlencoded ）：**
266
267
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
268
| ------------ | ---- | ------------------------ | -------------- | ------------------------------------------------------------ |
269
| src_media_id | num | 源收藏夹id | 必要 | |
270
| tar_media_id | num | 目标收藏夹id | 必要 | |
271
| mid | num | 当前用户mid | 必要 | |
272
| resources | strs | 目标内容id列表 | 必要 | 格式：{内容id}:{内容类型}<br />每个成员间用`,`分隔<br />类型：<br />2：视频稿件<br />12：音频<br />21：视频合集<br />内容id：<br />视频稿件：视频稿件avid<br />音频：音频auid<br />视频合集：视频合集id |
273
| platform | str | 平台标识 | 非必要 | 可为web |
274
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
275
276
**json回复：**
277
278
根对象：
279
280
| 字段 | 类型 | 内容 | 备注 |
281
| ------- | ---- | -------- | ------------------------------------------------------------ |
282
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-111：csrf校验失败<br />-400：请求错误<br />11010：您访问的内容不存在 |
283
| message | str | 错误信息 | 默认为0 |
284
| ttl | num | 1 | |
285
| data | obj | 信息本体 | 成功为0 |
286
287
**示例：**
288
289
将id为`1288061499`的收藏夹中视频稿件`av21822819` `av21918689` `av22288065`复制到id为`1178751999`的收藏夹中
290
291
清理id为`1161340172`的收藏夹
292
293
```shell
294
curl 'http://api.bilibili.com/x/v3/fav/resource/copy' \
295
--data-urlencode 'src_media_id=1288061499' \
296
--data-urlencode 'tar_media_id=1178751999' \
297
--data-urlencode 'mid=233333' \
298
--data-urlencode 'resources=21822819:2,21918689:2,22288065:2' \
299
--data-urlencode 'platform=web' \
300
--data-urlencode 'csrf=xxx' \
301
-b 'SESSDATA=xxx'
302
```
303
304
<details>
305
<summary>查看响应示例：</summary>
306
307
308
```json
309
{
310
"code":0,
311
"message":"0",
312
"ttl":1,
313
"data":0
314
}
315
```
316
317
</details>
318
319
### 批量移动内容
320
321
> http://api.bilibili.com/x/v3/fav/resource/move
322
323
*请求方式：POST*
324
325
认证方式：APP或Cookie（SESSDATA）
326
327
**正文参数（ application/x-www-form-urlencoded ）：**
328
329
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
330
| ------------ | ---- | ------------------------ | -------------- | ------------------------------------------------------------ |
331
| src_media_id | num | 源收藏夹id | 必要 | |
332
| tar_media_id | num | 目标收藏夹id | 必要 | |
333
| mid | num | 当前用户mid | 必要 | |
334
| resources | strs | 目标内容id列表 | 必要 | 格式：{内容id}:{内容类型}<br />每个成员间用`,`分隔<br />类型：<br />2：视频稿件<br />12：音频<br />21：视频合集<br />内容id：<br />视频稿件：视频稿件avid<br />音频：音频auid<br />视频合集：视频合集id |
335
| platform | str | 平台标识 | 非必要 | 可为web |
336
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
337
338
**json回复：**
339
340
根对象：
341
342
| 字段 | 类型 | 内容 | 备注 |
343
| ------- | ---- | -------- | ------------------------------------------------------------ |
344
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-111：csrf校验失败<br />-400：请求错误<br />11010：您访问的内容不存在 |
345
| message | str | 错误信息 | 默认为0 |
346
| ttl | num | 1 | |
347
| data | obj | 信息本体 | 成功为0 |
348
349
**示例：**
350
351
将id为`1288061499`的收藏夹中视频稿件`av21822819` `av21918689` `av22288065`移动到id为`1178751999`的收藏夹中
352
353
清理id为`1161340172`的收藏夹
354
355
```shell
356
curl 'http://api.bilibili.com/x/v3/fav/resource/move' \
357
--data-urlencode 'src_media_id=1288061499' \
358
--data-urlencode 'tar_media_id=1178751999' \
359
--data-urlencode 'mid=233333' \
360
--data-urlencode 'resources=21822819:2,21918689:2,22288065:2' \
361
--data-urlencode 'platform=web' \
362
--data-urlencode 'csrf=xxx' \
363
-b 'SESSDATA=xxx'
364
```
365
366
<details>
367
<summary>查看响应示例：</summary>
368
369
370
```json
371
{
372
"code":0,
373
"message":"0",
374
"ttl":1,
375
"data":0
376
}
377
```
378
379
</details>
380
381
### 批量删除内容
382
383
> http://api.bilibili.com/x/v3/fav/resource/batch-del
384
385
*请求方式：POST*
386
387
认证方式：APP或Cookie（SESSDATA）
388
389
**正文参数（ application/x-www-form-urlencoded ）：**
390
391
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
392
| --------- | -------------- | ------------------------ | ------------------------------------------------------------ | ------- |
393
| resources | 目标内容id列表 | 必要 | 格式：{内容id}:{内容类型}<br />每个成员间用`,`分隔<br />类型：<br />2：视频稿件<br />12：音频<br />21：视频合集<br />内容id：<br />视频稿件：视频稿件avid<br />音频：音频auid<br />视频合集：视频合集id | |
394
| media_id | num | 目标收藏夹id | 必要 | |
395
| platform | str | 平台标识 | 非必要 | 可为web |
396
| csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
397
398
**json回复：**
399
400
根对象：
401
402
| 字段 | 类型 | 内容 | 备注 |
403
| ------- | ---- | -------- | ------------------------------------------------------------ |
404
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-111：csrf校验失败<br />-400：请求错误<br />11010：您访问的内容不存在 |
405
| message | str | 错误信息 | 默认为0 |
406
| ttl | num | 1 | |
407
| data | obj | 信息本体 | 成功为0 |
408
409
**示例：**
410
411
将id为`1178751999`的收藏夹中视频稿件`av21822819` `av21918689` `av22288065`取消收藏
412
413
```shell
414
curl 'http://api.bilibili.com/x/v3/fav/resource/batch-del' \
415
--data-urlencode 'resources=21822819:2,21918689:2,22288065:2' \
416
--data-urlencode 'media_id=1178751999' \
417
--data-urlencode 'platform=web' \
418
--data-urlencode 'csrf=xxx' \
419
-b 'SESSDATA=xxx'
420
```
421
422
<details>
423
<summary>查看响应示例：</summary>
424
425
426
```json
427
{
428
"code":0,
429
"message":"0",
430
"ttl":1,
431
"data":0
432
}
433
```
434
435
</details>
436
437
### 清空所有失效内容
251
438
252
439
> http://api.bilibili.com/x/v3/fav/resource/clean
253
440
@@ -287,6 +474,7 @@ curl 'http://api.bilibili.com/x/v3/fav/resource/clean' \
287
474
<details>
288
475
<summary>查看响应示例：</summary>
289
476
477
290
478
```json
291
479
{
292
480
"code":0,