From cc6ab5f542f5c0360d0c8bb29c98341ea68f4d24 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?XC=E3=81=A1=E3=82=83=E3=82=93?=
 <60663465+SpaceXC@users.noreply.github.com>
Date: Fri, 18 Nov 2022 19:48:53 +0800
Subject: [PATCH] =?UTF-8?q?=E6=B7=BB=E5=8A=A0=E8=BF=BD=E7=95=AA/=E5=8F=96?=
 =?UTF-8?q?=E6=B6=88=E8=BF=BD=E7=95=AA=E6=8E=A5=E5=8F=A3=20(#530)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 bangumi/follow.md | 129 ++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 129 insertions(+)
 create mode 100644 bangumi/follow.md

diff --git a/bangumi/follow.md b/bangumi/follow.md
new file mode 100644
index 0000000..e46beea
--- /dev/null
+++ b/bangumi/follow.md
@@ -0,0 +1,129 @@
+# 追番相关
+
+- [追番](#追番)
+- [取消追番](#取消追番)
+
+---
+
+## 追番
+> https://api.bilibili.com/pgc/web/follow/add
+
+*请求方式：POST*
+
+鉴权方式：Cookie（SESSDATA）
+
+**url参数：**
+
+| 参数名      | 类型  | 内容     | 必要性 | 备注  |
+|----------|-----|--------|-----|-----|
+| season_id | str | 剧集ssid | 必要  |     |
+| csrf | str | csrf token(位于cookies中的bili_jct) | 必要  |     |
+
+**json回复：**
+
+根对象：
+
+| 字段    | 类型 | 内容   | 备注                            |
+| ------- | ---- | ------ | ------------------------------- |
+| code    | num  | 返回值 | 0：成功<br />-111：csrf校验失败 |
+| message | str  | 信息   |            成功时：success                    |
+| result | obj  |见下表|                                 |
+
+根对象中的`result`对象：
+
+| 字段     | 类型 | 内容       | 备注 |
+| -------- | ---- | ---------- | ---- |
+| fmid     | num  |      0      |      |
+| relation | bool |        false    |      |
+| status   | num  |        2    |      |
+| toast    | str  | 自己追的番就要好好看完哟^o^ |      |
+
+**示例：**
+
+追番`ssid=41410`的番剧
+
+```shell
+curl -G 'https://api.bilibili.com/pgc/web/follow/add' \
+--data-urlencode 'season_id=41410' \
+--data-urlencode 'csrf=xxx' \
+```
+
+<details>
+
+<summary>查看响应示例：</summary>
+
+```json
+{
+  "code": 0,
+  "message": "success",
+  "result": {
+    "fmid": 0,
+    "relation": false,
+    "status": 2,
+    "toast": "自己追的番就要好好看完哟^o^"
+  }
+}
+```
+</details>
+
+## 取消追番
+
+> https://api.bilibili.com/pgc/web/follow/del
+
+*请求方式：POST*
+
+鉴权方式：Cookie（SESSDATA）
+
+**url参数：**
+
+| 参数名    | 类型 | 内容                                | 必要性 | 备注 |
+| --------- | ---- | ----------------------------------- | ------ | ---- |
+| season_id | str  | 剧集ssid                            | 必要   |      |
+| csrf      | str  | csrf token(位于cookies中的bili_jct) | 必要   |      |
+
+**json回复：**
+
+根对象：
+
+| 字段    | 类型 | 内容   | 备注                            |
+| ------- | ---- | ------ | ------------------------------- |
+| code    | num  | 返回值 | 0：成功<br />-111：csrf校验失败 |
+| message | str  | 信息   |              成功时：success                  |
+| result  | obj  | 见下表 |                                 |
+
+根对象中的`result`对象：
+
+| 字段     | 类型 | 内容       | 备注 |
+| -------- | ---- | ---------- | ---- |
+| fmid     | num  |       0     |      |
+| relation | bool |     true       |      |
+| status   | num  |     0       |      |
+| toast    | str  | 已取消追番 |      |
+
+**示例：**
+
+取消`ssid=41410`的追番
+
+```shell
+curl -G 'https://api.bilibili.com/pgc/web/follow/del' \
+--data-urlencode 'season_id=41410' \
+--data-urlencode 'csrf=xxx' \
+```
+
+<details>
+
+<summary>查看响应示例：</summary>
+
+```json
+{
+  "code": 0,
+  "message": "success",
+  "result": {
+    "fmid": 0,
+    "relation": false,
+    "status": 0,
+    "toast": "已取消追番"
+  }
+}
+```
+</details>