返回提交历史
Added
bangumi/follow.md
+129
-0
XFEstudio/bilibili-API-collect
添加追番/取消追番接口 (#530)
cc6ab5f
代码差异
1 个文件
+129
-0
@@ -0,0 +1,129 @@
1
# 追番相关
2
3
- [追番](#追番)
4
- [取消追番](#取消追番)
5
6
---
7
8
## 追番
9
> https://api.bilibili.com/pgc/web/follow/add
10
11
*请求方式：POST*
12
13
鉴权方式：Cookie（SESSDATA）
14
15
**url参数：**
16
17
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
18
|----------|-----|--------|-----|-----|
19
| season_id | str | 剧集ssid | 必要 | |
20
| csrf | str | csrf token(位于cookies中的bili_jct) | 必要 | |
21
22
**json回复：**
23
24
根对象：
25
26
| 字段 | 类型 | 内容 | 备注 |
27
| ------- | ---- | ------ | ------------------------------- |
28
| code | num | 返回值 | 0：成功<br />-111：csrf校验失败 |
29
| message | str | 信息 | 成功时：success |
30
| result | obj |见下表| |
31
32
根对象中的`result`对象：
33
34
| 字段 | 类型 | 内容 | 备注 |
35
| -------- | ---- | ---------- | ---- |
36
| fmid | num | 0 | |
37
| relation | bool | false | |
38
| status | num | 2 | |
39
| toast | str | 自己追的番就要好好看完哟^o^ | |
40
41
**示例：**
42
43
追番`ssid=41410`的番剧
44
45
```shell
46
curl -G 'https://api.bilibili.com/pgc/web/follow/add' \
47
--data-urlencode 'season_id=41410' \
48
--data-urlencode 'csrf=xxx' \
49
```
50
51
<details>
52
53
<summary>查看响应示例：</summary>
54
55
```json
56
{
57
"code": 0,
58
"message": "success",
59
"result": {
60
"fmid": 0,
61
"relation": false,
62
"status": 2,
63
"toast": "自己追的番就要好好看完哟^o^"
64
}
65
}
66
```
67
</details>
68
69
## 取消追番
70
71
> https://api.bilibili.com/pgc/web/follow/del
72
73
*请求方式：POST*
74
75
鉴权方式：Cookie（SESSDATA）
76
77
**url参数：**
78
79
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
80
| --------- | ---- | ----------------------------------- | ------ | ---- |
81
| season_id | str | 剧集ssid | 必要 | |
82
| csrf | str | csrf token(位于cookies中的bili_jct) | 必要 | |
83
84
**json回复：**
85
86
根对象：
87
88
| 字段 | 类型 | 内容 | 备注 |
89
| ------- | ---- | ------ | ------------------------------- |
90
| code | num | 返回值 | 0：成功<br />-111：csrf校验失败 |
91
| message | str | 信息 | 成功时：success |
92
| result | obj | 见下表 | |
93
94
根对象中的`result`对象：
95
96
| 字段 | 类型 | 内容 | 备注 |
97
| -------- | ---- | ---------- | ---- |
98
| fmid | num | 0 | |
99
| relation | bool | true | |
100
| status | num | 0 | |
101
| toast | str | 已取消追番 | |
102
103
**示例：**
104
105
取消`ssid=41410`的追番
106
107
```shell
108
curl -G 'https://api.bilibili.com/pgc/web/follow/del' \
109
--data-urlencode 'season_id=41410' \
110
--data-urlencode 'csrf=xxx' \
111
```
112
113
<details>
114
115
<summary>查看响应示例：</summary>
116
117
```json
118
{
119
"code": 0,
120
"message": "success",
121
"result": {
122
"fmid": 0,
123
"relation": false,
124
"status": 0,
125
"toast": "已取消追番"
126
}
127
}
128
```
129
</details>