XFE Git
XFE Studio Git
Git 首页 全局搜索
XFE 主站 文档 NuGet
公开
关注 0 Fork 0 Star 0
返回提交历史

XFEstudio/bilibili-API-collect

稿件观众操作接口增加鉴权说明 (#840)

* 修复某些表格全角&半角符号不分 (#838) * Update precious_videos.md * Update manage.md * 修复部分视频无法投币,点赞，收藏问题，增加鉴权参数 * 修改【稿件观众操作】APIDoc --------- Co-authored-by: LaMerChiang <catlair@qq.com> Co-authored-by: djeozhang <djeozhang@tencent.com> Co-authored-by: SocialSisterYi <1440239038@qq.com>

e82b450
Gospel <39577077+zdjniubi@users.noreply.github.com>
提交于
父提交 faa3d97

代码差异

1 个文件 +92 -88
Modified docs/video/action.md +92 -88
@@ -1,4 +1,4 @@
1 # 视频点赞&投币&收藏&分享
1 # 稿件观众操作
2 2
3 3 ## 点赞
4 4
@@ -12,24 +12,26 @@
12 12
13 13 认证方式：仅可Cookie（SESSDATA）
14 14
15 需验证 Cookie 中`buvid3`字段存在且正常, 否则将导致触发风控
16
15 17 **正文参数（ application/x-www-form-urlencoded ）：**
16 18
17 | 参数名 | 类型 | 内容 | 必要性 | 备注 |
18 | ------ | ---- | ------------------------ | ------------ | ---------------------- |
19 | aid | num | 稿件avid | 必要（可选） | avid与bvid任选一个 |
20 | bvid | str | 稿件bvid | 必要（可选） | avid与bvid任选一个 |
21 | like | num | 操作方式 | 必要 | 1：点赞<br />2：取消赞 |
22 | csrf | str | CSRF Token（位于cookie） | 必要 | |
19 | 参数名 | 类型 | 内容 | 必要性 | 备注 |
20 | ------ | ---- | ------------------------- | ------------ | ---------------------- |
21 | aid | num | 稿件 avid | 必要（可选） | avid 与 bvid 任选一个 |
22 | bvid | str | 稿件 bvid | 必要（可选） | avid 与 bvid 任选一个 |
23 | like | num | 操作方式 | 必要 | 1：点赞<br />2：取消赞 |
24 | csrf | str | CSRF Token（位于 Cookie） | 必要 | |
23 25
24 26 **json回复：**
25 27
26 28 根对象：
27 29
28 | 字段 | 类型 | 内容 | 备注 |
29 | ------- | ---- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
30 | code | num | 返回值 | 0：成功 <br />-101：账号未登录<br />-111：csrf校验失败<br />-400：请求错误<br />10003：不存在该稿件<br />65004：取消点赞失败<br />65006：重复点赞 |
31 | message | str | 错误信息 | 默认为0 |
32 | ttl | num | 1 | |
30 | 字段 | 类型 | 内容 | 备注 |
31 | ------- | ---- | -------- | ------------------------------------------------------------ |
32 | code | num | 返回值 | 0：成功 <br />-101：账号未登录<br />-111：csrf校验失败<br />-400：请求错误<br />-403: 账号异常<br/> 10003：不存在该稿件<br />65004：取消点赞失败<br />65006：重复点赞 |
33 | message | str | 错误信息 | 默认为0 |
34 | ttl | num | 1 | |
33 35
34 36 **示例：**
35 37
@@ -78,22 +80,22 @@ curl 'https://api.bilibili.com/x/web-interface/archive/like' \
78 80
79 81 **正文参数（ application/x-www-form-urlencoded ）：**
80 82
81 | 参数名 | 类型 | 内容 | 必要性 | 备注 |
82 | ---------- | ---- | ------------ | ----------- | ---------------------- |
83 | access_key | str | APP登录Token | APP方式必要 | |
84 | aid | num | 稿件avid | 必要 | |
85 | like | num | 操作方式 | 必要 | 0：点赞<br />1：取消赞 |
83 | 参数名 | 类型 | 内容 | 必要性 | 备注 |
84 | ---------- | ---- | -------------- | ------------ | ---------------------- |
85 | access_key | str | APP 登录 Token | APP 方式必要 | |
86 | aid | num | 稿件 avid | 必要 | |
87 | like | num | 操作方式 | 必要 | 0：点赞<br />1：取消赞 |
86 88
87 89 **json回复：**
88 90
89 91 根对象：
90 92
91 | 字段 | 类型 | 内容 | 备注 |
92 | ------- | ---- | -------- | --------------------------------------------------------------------------- |
93 | code | num | 返回值 | 0：成功 <br />-101：账号未登录<br />-400：请求错误<br />10003：不存在该稿件 |
94 | message | str | 错误信息 | 默认为0 |
95 | ttl | num | 1 | |
96 | data | obj | 数据本体 | |
93 | 字段 | 类型 | 内容 | 备注 |
94 | ------- | ---- | -------- | ------------------------------------------------------------ |
95 | code | num | 返回值 | 0：成功 <br />-101：账号未登录<br />-400：请求错误<br />-403: 账号异常<br />10003：不存在该稿件 |
96 | message | str | 错误信息 | 默认为0 |
97 | ttl | num | 1 | |
98 | data | obj | 数据本体 | |
97 99
98 100 `data`对象：
99 101
@@ -138,11 +140,11 @@ curl 'https://app.bilibili.com/x/v2/view/like' \
138 140
139 141 **url参数：**
140 142
141 | 参数名 | 类型 | 内容 | 必要性 | 备注 |
142 | ---------- | ---- | ------------ | ------------ | ------------------ |
143 | access_key | str | APP登录Token | APP方式必要 | |
144 | aid | num | 稿件avid | 必要（可选） | avid与bvid任选一个 |
145 | bvid | str | 稿件bvid | 必要（可选） | avid与bvid任选一个 |
143 | 参数名 | 类型 | 内容 | 必要性 | 备注 |
144 | ---------- | ---- | -------------- | ------------ | --------------------- |
145 | access_key | str | APP 登录 Token | APP 方式必要 | |
146 | aid | num | 稿件 avid | 必要（可选） | avid 与 bvid 任选一个 |
147 | bvid | str | 稿件 bvid | 必要（可选） | avid 与 bvid 任选一个 |
146 148
147 149 **json回复：**
148 150
@@ -201,11 +203,11 @@ curl -G 'https://api.bilibili.com/x/web-interface/archive/has/like' \
201 203
202 204 **正文参数（ application/x-www-form-urlencoded ）：**
203 205
204 | 参数名 | 类型 | 内容 | 必要性 | 备注 |
205 |------------|-----|-----------|-----|-----------------|
206 | access_key | str | APP Token | 必要 | |
207 | aid | num | 视频aid | 必要 | |
208 | dislike | num | 操作类型 | 必要 | 0：点踩<br/>1：取消点踩 |
206 | 参数名 | 类型 | 内容 | 必要性 | 备注 |
207 | ---------- | ---- | -------------- | ------ | ----------------------- |
208 | access_key | str | APP 登录 Token | 必要 | |
209 | aid | num | 视频 aid | 必要 | |
210 | dislike | num | 操作类型 | 必要 | 0：点踩<br/>1：取消点踩 |
209 211
210 212 **json回复：**
211 213
@@ -250,26 +252,28 @@ curl -L -X POST 'https://app.biliapi.net/x/v2/view/dislike' \
250 252
251 253 认证方式：仅可Cookie（SESSDATA）
252 254
255 需验证 Cookie 中`buvid3`字段存在且正常, 否则将导致触发风控
256
253 257 **正文参数（ application/x-www-form-urlencoded ）：**
254 258
255 | 参数名 | 类型 | 内容 | 必要性 | 备注 |
256 | ----------- | ---- | ------------------------ | ------------ | --------------------------------------- |
257 | aid | num | 稿件avid | 必要（可选） | avid与bvid任选一个 |
258 | bvid | str | 稿件bvid | 必要（可选） | avid与bvid任选一个 |
259 | multiply | num | 投币数量 | 必要 | 上限为2 |
260 | select_like | num | 是否附加点赞 | 非必要 | 0：不点赞<br />1：同时点赞<br />默认为0 |
261 | csrf | str | CSRF Token（位于cookie） | 必要 | |
259 | 参数名 | 类型 | 内容 | 必要性 | 备注 |
260 | ----------- | ---- | ------------------------- | ------------ | --------------------------------------- |
261 | aid | num | 稿件 avid | 必要（可选） | avid 与 bvid 任选一个 |
262 | bvid | str | 稿件 bvid | 必要（可选） | avid 与 bvid 任选一个 |
263 | multiply | num | 投币数量 | 必要 | 上限为2 |
264 | select_like | num | 是否附加点赞 | 非必要 | 0：不点赞<br />1：同时点赞<br />默认为0 |
265 | csrf | str | CSRF Token（位于 Cookie） | 必要 | |
262 266
263 267 **json回复：**
264 268
265 269 根对象：
266 270
267 | 字段 | 类型 | 内容 | 备注 |
268 | ------- | ---- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
269 | code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-102：账号被封停<br />-104：硬币不足<br />-111：csrf校验失败<br />-400：请求错误<br />10003：不存在该稿件<br />34002：不能给自己投币<br />34003：非法的投币数量<br />34004：投币间隔太短<br />34005：超过投币上限 |
270 | message | str | 错误信息 | 默认为0 |
271 | ttl | num | 1 | |
272 | data | obj | 信息本体 | |
271 | 字段 | 类型 | 内容 | 备注 |
272 | ------- | ---- | -------- | ------------------------------------------------------------ |
273 | code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-102：账号被封停<br />-104：硬币不足<br />-111：csrf校验失败<br />-400：请求错误<br />-403: 账号异常<br />10003：不存在该稿件<br />34002：不能给自己投币<br />34003：非法的投币数量<br />34004：投币间隔太短<br />34005：超过投币上限 |
274 | message | str | 错误信息 | 默认为0 |
275 | ttl | num | 1 | |
276 | data | obj | 信息本体 | |
273 277
274 278 data 对象：
275 279
@@ -329,12 +333,12 @@ curl 'https://api.bilibili.com/x/web-interface/coin/add' \
329 333
330 334 **正文参数（ application/x-www-form-urlencoded ）：**
331 335
332 | 参数名 | 类型 | 内容 | 必要性 | 备注 |
333 | ----------- | ---- | ------------ | ----------- | --------------------------------------- |
334 | access_key | str | APP登录Token | APP方式必要 | |
335 | aid | num | 稿件avid | 必要 | |
336 | multiply | num | 投币数量 | 必要 | 上限为2 |
337 | select_like | num | 附加点赞 | 非必要 | 0：不点赞<br />1：同时点赞<br />默认为0 |
336 | 参数名 | 类型 | 内容 | 必要性 | 备注 |
337 | ----------- | ---- | -------------- | ------------ | --------------------------------------- |
338 | access_key | str | APP 登录 Token | APP 方式必要 | |
339 | aid | num | 稿件 avid | 必要 | |
340 | multiply | num | 投币数量 | 必要 | 上限为2 |
341 | select_like | num | 附加点赞 | 非必要 | 0：不点赞<br />1：同时点赞<br />默认为0 |
338 342
339 343 **json回复：**
340 344
@@ -389,11 +393,11 @@ curl 'https://app.bilibili.com/x/v2/view/coin/add' \
389 393
390 394 **url参数：**
391 395
392 | 参数名 | 类型 | 内容 | 必要性 | 备注 |
393 | ---------- | ---- | ------------ | ------------ | ------------------ |
394 | access_key | str | APP登录Token | APP方式必要 | |
395 | aid | num | 稿件avid | 必要（可选） | avid与bvid任选一个 |
396 | bvid | str | 稿件bvid | 必要（可选） | avid与bvid任选一个 |
396 | 参数名 | 类型 | 内容 | 必要性 | 备注 |
397 | ---------- | ---- | -------------- | ------------ | --------------------- |
398 | access_key | str | APP 登录 Token | APP方式必要 | |
399 | aid | num | 稿件 avid | 必要（可选） | avid 与 bvid 任选一个 |
400 | bvid | str | 稿件 bvid | 必要（可选） | avid 与 bvid 任选一个 |
397 401
398 402 **json回复：**
399 403
@@ -468,12 +472,12 @@ curl -G 'https://api.bilibili.com/x/web-interface/archive/coins' \
468 472
469 473 | 参数名 | 类型 | 内容 | 必要性 | 备注 |
470 474 | ------------- | ---- | ------------------------ | -------------- | ------------------------------ |
471 | access_key | str | APP登录Token | APP方式必要 | |
472 | rid | num | 稿件avid | 必要 | |
475 | access_key | str | APP 登录 Token | APP 方式必要 | |
476 | rid | num | 稿件 avid | 必要 | |
473 477 | type | num | 必须为2 | 必要 | |
474 | add_media_ids | nums | 需要加入的收藏夹mlid | 非必要 | 同时添加多个，用`,`（%2C）分隔 |
475 | del_media_ids | nums | 需要取消的收藏夹mlid | 非必要 | 同时取消多个，用`,`（%2C）分隔 |
476 | csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | |
478 | add_media_ids | nums | 需要加入的收藏夹 mlid | 非必要 | 同时添加多个，用`,`（%2C）分隔 |
479 | del_media_ids | nums | 需要取消的收藏夹 mlid | 非必要 | 同时取消多个，用`,`（%2C）分隔 |
480 | csrf | str | CSRF Token（位于 Cookie） | Cookie 方式必要 | |
477 481
478 482 **json回复：**
479 483
@@ -544,10 +548,10 @@ curl 'https://api.bilibili.com/medialist/gateway/coll/resource/deal' \
544 548
545 549 **url参数：**
546 550
547 | 参数名 | 类型 | 内容 | 必要性 | 备注 |
548 | ---------- | -------- | ------------------ | ----------- | ---- |
549 | access_key | str | APP登录Token | APP方式必要 | |
550 | aid | num或str | 稿件avid或稿件bvid | 必要 | |
551 | 参数名 | 类型 | 内容 | 必要性 | 备注 |
552 | ---------- | ---------- | --------------------- | ------------ | ---- |
553 | access_key | str | APP 登录 Token | APP 方式必要 | |
554 | aid | num 或 str | 稿件 avid 或稿件 bvid | 必要 | |
551 555
552 556 **json回复：**
553 557
@@ -618,24 +622,26 @@ curl -G 'https://api.bilibili.com/x/v2/fav/video/favoured' \
618 622
619 623 同时点赞投币收藏视频，收藏于默认收藏夹中
620 624
625 需验证 Cookie 中`buvid3`字段存在且正常, 否则将导致触发风控
626
621 627 **正文参数（ application/x-www-form-urlencoded ）：**
622 628
623 | 参数名 | 类型 | 内容 | 必要性 | 备注 |
624 | ------ | ---- | ------------------------ | ------------ | ------------------ |
625 | aid | num | 稿件avid | 必要（可选） | avid与bvid任选一个 |
626 | bvid | str | 稿件bvid | 必要（可选） | avid与bvid任选一个 |
627 | csrf | str | CSRF Token（位于cookie） | 必要 | |
629 | 参数名 | 类型 | 内容 | 必要性 | 备注 |
630 | ------ | ---- | ------------------------- | ------------ | --------------------- |
631 | aid | num | 稿件 avid | 必要（可选） | avid 与 bvid 任选一个 |
632 | bvid | str | 稿件 bvid | 必要（可选） | avid 与 bvid 任选一个 |
633 | csrf | str | CSRF Token（位于 Cookie） | 必要 | |
628 634
629 635 **json回复：**
630 636
631 637 根对象：
632 638
633 | 字段 | 类型 | 内容 | 备注 |
634 | ------- | ---- | -------- | -------------------------------------------------------------------------------------------------- |
635 | code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-111：csrf校验失败<br />-400：请求错误<br />10003：不存在该稿件 |
636 | message | str | 错误信息 | 默认为0 |
637 | ttl | num | 1 | |
638 | data | obj | 信息本体 | |
639 | 字段 | 类型 | 内容 | 备注 |
640 | ------- | ---- | -------- |------------------------------------------------------------------------------------------|
641 | code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-111：csrf校验失败<br />-400：请求错误<br />10003：不存在该稿件<br />-403: 账号异常 |
642 | message | str | 错误信息 | 默认为0 |
643 | ttl | num | 1 | |
644 | data | obj | 信息本体 | |
639 645
640 646 `data`对象：
641 647
@@ -699,10 +705,10 @@ curl 'https://api.bilibili.com/x/web-interface/archive/like/triple' \
699 705
700 706 **正文参数（ application/x-www-form-urlencoded ）：**
701 707
702 | 参数名 | 类型 | 内容 | 必要性 | 备注 |
703 | ---------- | ---- | ------------ | ----------- | ---- |
704 | access_key | str | APP登录Token | APP方式必要 | |
705 | aid | num | 稿件avid | 必要 | |
708 | 参数名 | 类型 | 内容 | 必要性 | 备注 |
709 | ---------- | ---- | -------------- | ------------ | ---- |
710 | access_key | str | APP 登录 Token | APP 方式必要 | |
711 | aid | num | 稿件 avid | 必要 | |
706 712
707 713 **json回复：**
708 714
@@ -761,15 +767,13 @@ curl 'https://app.bilibili.com/x/v2/view/like/triple' \
761 767
762 768 *请求方式：POST*
763 769
764 认证方式 csrf token
765
766 770 **正文参数（ application/x-www-form-urlencoded ）：**
767 771
768 | 参数名 | 类型 | 内容 | 必要性 | 备注 |
769 | ------ | ---- | ------------------------ | ------------ | ------------------ |
770 | aid | num | 稿件avid | 必要（可选） | avid与bvid任选一个 |
771 | bvid | str | 稿件bvid | 必要（可选） | avid与bvid任选一个 |
772 | csrf | str | CSRF Token（位于cookie） | 必要 | |
772 | 参数名 | 类型 | 内容 | 必要性 | 备注 |
773 | ------ | ---- | ------------------------- | ------------ | --------------------- |
774 | aid | num | 稿件 avid | 必要（可选） | avid 与 bvid 任选一个 |
775 | bvid | str | 稿件 bvid | 必要（可选） | avid 与 bvid任 选一个 |
776 | csrf | str | CSRF Token（位于 Cookie） | 必要 | |
773 777
774 778 **json回复：**
775 779