收藏夹操作（增删改）

@@ -0,0 +1,318 @@

1 # 收藏夹操作

2

3 - [收藏夹操作](#收藏夹操作)

4 - [新建收藏夹(web)](#新建收藏夹web)

5 - [修改收藏夹(web)](#修改收藏夹web)

6 - [删除收藏夹(web)](#删除收藏夹web)

7

8 ---

9

10 ## 新建收藏夹(web)

11

12 > https://api.bilibili.com/x/v3/fav/folder/add

13

14 *请求方式：POST*

15

16 认证方式：Cookie（SESSDATA）

17

18 **正文参数（ application/x-www-form-urlencoded ）：**

19

20 | 参数名 | 类型 | 内容 | 必要性 | 备注 |

21 | ------- | ---- | ---------- | ------ | ---------------- |

22 | title | str | 收藏夹标题 | 必要 | |

23 | intro | str | 收藏夹简介 | 非必要 | |

24 | privacy | int | 是否公开 | 非必要 | 0公开 1私密 |

25 | cover | str | 封面图url | 非必要 | 封面会被审核 |

26 | csrf | str | CSRF Token | 必要 | 位于Cookie |

27

28 **json回复：**

29

30 根对象：

31

32 | 字段 | 类型 | 内容 | 备注 |

33 | ------- | ---- | -------- | ------- |

34 | code | num | 返回值 | 0：成功 |

35 | message | str | 错误信息 | 默认为0 |

36 | ttl | num | 1 | |

37 | data | obj | 信息本体 | |

38

39 `data`对象：

40

41 | 字段 | 类型 | 内容 | 备注 |

42 | ----------- | ---- | ----------------- | ---------------------------------- |

43 | id | num | 收藏夹id | |

44 | fid | num | 未知 | 不知道啥的id,后期补上 |

45 | mid | num | 创建者uid | |

46 | attr | num | 未知 | |

47 | title | str | 收藏夹标题 | |

48 | cover | str | 收藏夹封面图片url | |

49 | upper | obj | 创建者信息 | |

50 | cover_type | num | 封面图类别（？） | |

51 | cnt_info | obj | 收藏夹数据 | 点赞观看收藏等 |

52 | type | num | 不知道是啥 | 一般是0 |

53 | intro | str | 简介 | |

54 | ctime | num | 0 | 看起来意思是创建时间，但是是0 |

55 | mtime | num | 0 | 看起来意思是创建时间，但是是0 |

56 | state | num | 未知 | 一般为0 |

57 | fav_state | num | 收藏状态 | 已被自己收藏:1 未被自己收藏:0 |

58 | like_state | num | 点赞状态 | 同上 |

59 | media_count | num | 收藏夹内容数量 | |

60

61 `data`对象中的`upper`对象

62

63 | 字段 | 类型 | 内容 | 备注 |

64 | -------- | ---- | ---------------- | ----------------------------------------------- |

65 | mid | num | 0 | 谁也不知道知道为啥是空的 |

66 | name | str | 空 | 谁也不知道知道为啥是空的 |

67 | face | str | 空 | 谁也不知道知道为啥是空的 |

69 | vip_type | num | 会员类别 | 0：无 1：月大会员 2：年度及以上大会员 |

70

71 `data`对象中的`cnt_info`对象

72

73 | 字段 | 类型 | 内容 | 备注 |

74 | -------- | ---- | ------ | ------------- |

75 | collect | num | 收藏数 | 刚创建当然是0 |

76 | play | num | 播放数 | 刚创建当然是0 |

77 | thumb_up | num | 点赞数 | 刚创建当然是0 |

78 | share | unm | 分享数 | 刚创建当然是0 |

79

80 **示例：**

81

82

创建一个叫`test`,简介是`2333`,封面`http://i0.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png`,的公开收藏夹:

83

84 ```shell

85 curl 'https://api.bilibili.com/x/v3/fav/folder/add' \

86 --data-urlencode 'title=test' \

87 --data-urlencode 'intro=2333' \

88 --data-urlencode 'privacy: 0' \

89 --data-urlencode 'csrf=xxxx' \

90 --data-urlencode 'cover=http://i0.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png' \

91 -b 'SESSDATA=xxxx'

92 ```

93

94 <details>

95 <summary>查看响应示例：</summary>

96

97 ```json

98 {

99 "code": 0,

100 "message": "0",

101 "ttl": 1,

102 "data": {

103 "id": 1182306172,

104 "fid": 11823061,

105 "mid": 470310172,

106 "attr": 6,

107 "title": "test",

108 "cover": "http://i0.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png",

109 "upper": {

110 "mid": 0,

111 "name": "",

112 "face": "",

113 "followed": false,

114 "vip_type": 0,

115 "vip_statue": 0

116 },

117 "cover_type": 0,

118 "cnt_info": {

119 "collect": 0,

120 "play": 0,

121 "thumb_up": 0,

122 "share": 0

123 },

124 "type": 0,

125 "intro": "2333",

126 "ctime": 0,

127 "mtime": 0,

128 "state": 0,

129 "fav_state": 0,

130 "like_state": 0,

131 "media_count": 0

132 }

133 }

134 ```

135

136 </details>

137

138 ## 修改收藏夹(web)

139

140 > https://api.bilibili.com/x/v3/fav/folder/edit

141

142 *请求方式：POST*

143

144 认证方式：Cookie（SESSDATA）

145

146 **正文参数（ application/x-www-form-urlencoded ）：**

147

148 | 参数名 | 类型 | 内容 | 必要性 | 备注 |

149 | -------- | ---- | ---------------- | ------ | ---------------- |

150 | title | str | 新收藏夹标题 | 必要 | |

151 | intro | str | 新收藏夹简介 | 非必要 | |

152 | privacy | int | 是否公开 | 非必要 | 0公开 1私密 |

153 | cover | str | 封面图url | 非必要 | 封面会被审核 |

154 | csrf | str | CSRF Token | 必要 | 位于Cookie |

155 | media_id | int | 欲修改的收藏夹id | 必要 | |

156

157 **json回复：**

158

159 根对象：

160

161 | 字段 | 类型 | 内容 | 备注 |

162 | ------- | ---- | -------- | ------- |

163 | code | num | 返回值 | 0：成功 |

164 | message | str | 错误信息 | 默认为0 |

165 | ttl | num | 1 | |

166 | data | obj | 信息本体 | |

167

168 `data`对象：

169

170 | 字段 | 类型 | 内容 | 备注 |

171 | ----------- | ---- | ----------------- | ---------------------------------- |

172 | id | num | 收藏夹id | |

173 | fid | num | 未知 | 不知道啥的id,后期补上 |

174 | mid | num | 创建者uid | |

175 | attr | num | 未知 | |

176 | title | str | 收藏夹标题 | |

177 | cover | str | 收藏夹封面图片url | |

178 | upper | obj | 创建者信息 | |

179 | cover_type | num | 封面图类别（？） | |

180 | cnt_info | obj | 收藏夹数据 | 点赞观看收藏等 |

181 | type | num | 不知道是啥 | 一般是11 |

182 | intro | str | 备注 | |

183 | ctime | num | 创建时间 | 时间戳（秒） |

184 | mtime | num | 收藏时间 | 时间戳（秒） |

185 | state | num | 未知 | 一般为0 |

186 | fav_state | num | 收藏状态 | 已被自己收藏:1 未被自己收藏:0 |

187 | like_state | num | 点赞状态 | 同上 |

188 | media_count | num | 收藏夹内容数量 | |

189

190 `data`对象中的`upper`对象

191

192 | 字段 | 类型 | 内容 | 备注 |

193 | ---------- | ---- | ---------------- | ----------------------------------------------- |

194 | mid | num | 创建者uid | |

195 | name | str | 创建者用户名 | |

196 | face | str | 创建者头像url | |

198 | vip_type | num | 会员类别 | 0：无 1：月大会员 2：年度及以上大会员 |

199 | vip_statue | num | 会员开通状态 | 0：无 1：有 |

200

201 `data`对象中的`cnt_info`对象

202

203 | 字段 | 类型 | 内容 | 备注 |

204 | -------- | ---- | ------ | ---- |

205 | collect | num | 收藏数 | |

206 | play | num | 播放数 | |

207 | thumb_up | num | 点赞数 | |

208 | share | unm | 分享数 | |

209

210 **示例：**

211

212

修改id为`1182306172`的名字为`test`,简介为`2333`,封面为`http://i0.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png`,公开收藏夹:

213

214 ```shell

215 curl 'https://api.bilibili.com/x/v3/fav/folder/add' \

216 --data-urlencode 'title=test' \

217 --data-urlencode 'intro=2333' \

218 --data-urlencode 'privacy: 0' \

219 --data-urlencode 'cover=http://i0.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png' \

220 --data-urlencode 'media_id=1182306172' \

221 --data-urlencode 'csrf=xxxx' \

222 -b 'SESSDATA=xxxx' \

223 ```

224

225 <details>

226 <summary>查看响应示例：</summary>

227

228 ```json

229 {

230 "code": 0,

231 "message": "0",

232 "ttl": 1,

233 "data": {

234 "id": 1182306172,

235 "fid": 11823061,

236 "mid": 470310172,

237 "attr": 6,

238 "title": "test",

239 "cover": "http://i0.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png",

240 "upper": {

241 "mid": 0,

242 "name": "",

243 "face": "",

244 "followed": false,

245 "vip_type": 0,

246 "vip_statue": 0

247 },

248 "cover_type": 0,

249 "cnt_info": {

250 "collect": 0,

251 "play": 0,

252 "thumb_up": 0,

253 "share": 0

254 },

255 "type": 0,

256 "intro": "2333",

257 "ctime": 0,

258 "mtime": 0,

259 "state": 0,

260 "fav_state": 0,

261 "like_state": 0,

262 "media_count": 0

263 }

264 }

265 ```

266

267 </details>

268

269 ## 删除收藏夹(web)

270

271 > https://api.bilibili.com/x/v3/fav/folder/del

272

273 *请求方式：POST*

274

275 认证方式：Cookie（SESSDATA）

276

277 **正文参数（ application/x-www-form-urlencoded ）：**

278

279 | 参数名 | 类型 | 内容 | 必要性 | 备注 |

280 | --------- | ---- | ----------------------- | ------ | ------------------ |

281 | media_ids | int | 收藏夹id | 必要 | 看名字貌似可以多个 |

282 | csrf | str | CSRF Token (位于Cookie) | 必要 | |

283

284 **json回复：**

285

286 根对象：

287

288 | 字段 | 类型 | 内容 | 备注 |

289 | ------- | ---- | -------- | ------- |

290 | code | num | 返回值 | 0：成功 |

291 | message | str | 错误信息 | 成功为0 |

292 | ttl | num | 1 | |

293 | data | num | 信息本体 | 成功为0 |

294

295 **示例：**

296

297 删除id为`1182306172`的收藏夹:

298

299 ```shell

300 curl 'https://api.bilibili.com/x/v3/fav/folder/del' \

301 --data-urlencode 'csrf=xxxx' \

302 --data-urlencode 'media_ids=1182306172' \

303 -b 'SESSDATA=xxxx'

304 ```

305

306 <details>

307 <summary>查看响应示例：</summary>

308

309 ```json

310 {

311 "code":0,

312 "message":"0",

313 "ttl":1,

314 "data":0

315 }

316 ```

317

318 </details>

bilibili-API-collect

收藏夹操作（增删改）

代码差异