github-repos/bilibili-API-collect
1
0
Fork 0
mirror of https://github.com/SocialSisterYi/bilibili-API-collect.git synced 2024-12-27 13:00:29 +08:00
Code Issues Packages Projects Releases Wiki Activity

优化文档格式

Browse Source
This commit is contained in:
社会易姐QwQ 2020-04-16 18:47:19 +08:00
parent a0c4316917
commit 4fd408f111
26 changed files with 303 additions and 149 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

36
creativecenter/statistics&data.md
View File

@ -12,6 +12,8 @@
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ----------------------------- |
| code | num | 返回值 | 0：成功<br />-101：账号未登录 |
@ -64,7 +66,7 @@
| ｛YYYYMMDD｝ | num | 掉粉数 | 字段名为日期 |
| …… | num | …… | 近30天的掉粉情况 |
示例：
**示例：**
http://member.bilibili.com/x/web/index/stat
@ -162,6 +164,8 @@ http://member.bilibili.com/x/web/index/stat
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ----------------------------- |
| code | num | 返回值 | 0：成功<br />-101：账号未登录 |
@ -186,7 +190,7 @@ http://member.bilibili.com/x/web/index/stat
| incr_fav | num | 新增收藏数 | |
| incr_share | num | 新增分享数 | |
示例：
**示例：**
http://member.bilibili.com/x/web/data/article
@ -222,13 +226,13 @@ http://member.bilibili.com/x/web/data/article
数据为前30天
参数：
**参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------ | ------ | ---- |
| type | url | 目标数据类型 | 必要 | |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------ | ------ | -------------- |
| type | url | 目标数据类型 | 必要 | 类型代码见下表 |
`type`参数：
类型代码`type`：
| 代码 | 含义 |
| ---- | ---- |
@ -243,6 +247,8 @@ http://member.bilibili.com/x/web/data/article
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ----- | -------- | ------------------------------------------------- |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-400：请求错误 |
@ -266,7 +272,7 @@ http://member.bilibili.com/x/web/data/article
| date_key | num | 对应时间 | 时间戳 前一天的8:00 |
| total_inc | num | 增加数量 | 意义为数据类型决定 |
示例：
**示例：**
查询30天前的视频播放增量趋势，可知`2020-04-05`的播放增量为`46`，`2020-04-04`的播放增量为`58`
@ -311,13 +317,13 @@ http://member.bilibili.com/x/web/data/pandect?type=1
数据为前30天
参数：
**参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------ | ------ | ---- |
| type | url | 目标数据类型 | 必要 | |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------ | ------ | -------------- |
| type | url | 目标数据类型 | 必要 | 类型代码见下表 |
`type`参数：
类型代码`type`：
| 代码 | 含义 |
| ---- | ---- |
@ -330,6 +336,8 @@ http://member.bilibili.com/x/web/data/pandect?type=1
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ----- | -------- | ------------------------------------------------- |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-400：请求错误 |
@ -353,7 +361,7 @@ http://member.bilibili.com/x/web/data/pandect?type=1
| date_key | num | 对应时间 | 时间戳 前一天的8:00 |
| total_inc | num | 增加数量 | 意义为数据类型决定 |
示例：
**示例：**
查询30天前的文章阅读增量趋势，可知`2020-04-05`的阅读增量为`6`，`2020-04-04`的阅读增量为`6`

10
danmaku/danmaku.md
View File

@ -1,6 +1,6 @@
# 弹幕
弹幕均为xml格式，下载至本地后加载
获取的均为xml格式标准弹幕文件，下载至本地后加载
实时弹幕池容量有限（根据视频类型500-3000条不等），占满后再发送会使实时弹幕池底部的弹幕压入历史弹幕池（类似于堆栈）
@ -12,13 +12,13 @@
**使用deflate压缩，注意解码**
参数：
**参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------- | ------ | ---- |
| oid | url | 视频CID | 必要 | |
示例：
**示例：**
http://api.bilibili.com/x/v1/dm/list.so?oid=144541892
@ -32,13 +32,13 @@ http://api.bilibili.com/x/v1/dm/list.so?oid=144541892
**使用deflate压缩，注意解码**
参数：
**参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------- | ------ | ---- |
| cid | url | 视频CID | 必要 | |
示例：
**示例：**
http://comment.bilibili.com/144541892.xml

10
danmaku/history.md
View File

@ -8,7 +8,7 @@
*方式：GET*
参数：
**参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ------------ |
@ -18,6 +18,8 @@
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ------------------------------- | -------- | ------------------------------------------------- |
| code | num | 返回值 | 0：成功<br />-400：请求错误<br />-101：账号未登录 |
@ -33,7 +35,7 @@
| n | str | 存在弹幕的日期(n+1) | yyyy-mm-dd |
| …… | str | …… | …… |
示例：
**示例：**
查询了cid为144541892的视频位于2020年1月中有历史弹幕记录的日期
@ -83,7 +85,7 @@ http://api.bilibili.com/x/v2/dm/history/index?type=1&oid=144541892&month=2019-12
**使用deflate压缩，注意解码**
参数：
**参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ------------ |
@ -91,7 +93,7 @@ http://api.bilibili.com/x/v2/dm/history/index?type=1&oid=144541892&month=2019-12
| oid | url | 视频CID | 必要 | |
| date | url | 弹幕日期 | 必要 | yyyy-mm-dd |
示例：
**示例：**
https://api.bilibili.com/x/v2/dm/history?type=1&oid=144541892&date=2020-01-21

10
danmaku/snapshot.md
View File

@ -8,7 +8,7 @@
最近产生的几条弹幕内容，**最多20条**
参数：
**参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------ | ------ | ---- |
@ -16,6 +16,8 @@
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ----- | -------- | --------------------------------------------- |
| code | num | 返回值 | 0：成功<br />-400：请求错误<br />-404：无视频 |
@ -32,7 +34,9 @@
| …… | str | …… | …… |
| 19 | str | 预览内容20 | 最后一条 |
示例：
**示例：**
获取视频`av43337021`/`BV1rb411m7gE`的弹幕快照，总计20条
http://api.bilibili.com/x/v2/dm/ajax?aid=43337021
@ -68,5 +72,3 @@ http://api.bilibili.com/x/v2/dm/ajax?aid=43337021
}
```
获取了视频av43337021的弹幕快照，总计20条

4
dynamic/publish.md
View File

@ -12,7 +12,7 @@
注意：非日常类型像素宽高必须大于420
参数（multipart/form-data）：
**参数（multipart/form-data）：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| -------- | ---- | ------------------ | ------ | ------------------------------------------------------------ |
@ -21,6 +21,8 @@
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功 <br />-1：未添加图片<br />-2：参数错误<br />-3：图片尺寸过小<br />-4：账号未登录<br />-7：图片信息错误 |

6
electric/Bcoin.md
View File

@ -10,7 +10,7 @@
需要登录(SESSDATA)
参数（ application/x-www-form-urlencoded ）：
**参数（ application/x-www-form-urlencoded ）：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| -------- | ---- | ------------------- | ------ | ------------------------------------------------- |
@ -22,6 +22,8 @@
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功（并不代表充电成功） <br />-400：请求错误<br />-111：csrf校验失败<br />-101：账号未登录 |
@ -41,7 +43,7 @@
| status | num | 返回结果 | 4：成功<br />-2：低于20电池下限<br />-4：B币不足 |
| msg | str | 错误信息 | 默认为空 |
示例：
**示例：**
以空间的方式向用户`UID=293793435`充了20电池，得到2经验，交易编号为`BPRG5CEC3VUPOOANA540`

12
electric/WeChat&Alipay.md
View File

@ -22,7 +22,7 @@
秘钥有效时间为10分钟
参数（ application/x-www-form-urlencoded ）：
**参数（ application/x-www-form-urlencoded ）：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------------------- | ---- | ------------------- | ------ | ------------------------------------------------------------ |
@ -35,6 +35,8 @@
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功<br />-400：请求错误<br />-500：服务器错误<br />-111：csrf校验失败<br />-101：账号未登录 |
@ -50,7 +52,7 @@
| qr_token | str | 扫码秘钥 | |
| exp | num | 获得经验数 | |
示例：
**示例：**
申请空间的方式向用户23215368充电10电池且不使用B币的支付二维码
@ -77,7 +79,7 @@ curl -b "SESSDATA=xxx" -d "up_mid=23215368&elec_num=10&is_bp_remains_prior=false
*方式：GET*
参数：
**参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| -------- | ---- | -------- | ------ | ---- |
@ -85,6 +87,8 @@ curl -b "SESSDATA=xxx" -d "up_mid=23215368&elec_num=10&is_bp_remains_prior=false
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ----------------------------- |
| code | num | 返回值 | 0：成功<br />-101：账号未登录 |
@ -101,7 +105,7 @@ curl -b "SESSDATA=xxx" -d "up_mid=23215368&elec_num=10&is_bp_remains_prior=false
| mid | num | 当前用户UID | |
| status | num | 状态值 | 若秘钥错误则无此项<br />1：已支付<br />2：未扫描<br />3：未确认 |
示例：
**示例：**
当申请到的支付二维码未被扫描时，`data`.`ststus`的值为`2`

6
electric/charge_msg.md
View File

@ -6,7 +6,7 @@
需要登录(SESSDATA)
参数（ application/x-www-form-urlencoded ）：
**参数（ application/x-www-form-urlencoded ）：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| -------- | ---- | ------------------- | ------ | ---- |
@ -16,13 +16,15 @@
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功 <br />-400：请求错误<br />-111：csrf校验失败<br />-101：账号未登录<br />88203：不能重复留言 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | 作用尚不明确 |
示例：
**示例：**
成功为交易编号为`BPRG5CEC3VUPOOANA540`的充电操作，添加了内容为`支持一下大佬`的留言

6
live/info.md
View File

@ -6,7 +6,7 @@
*方式：GET*
参数：
**参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | ---- |
@ -14,6 +14,8 @@
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | --------------------------- |
| code | num | 返回值 | 0：成功<br />-400：请求错误 |
@ -36,7 +38,7 @@
| broadcast_type | num | 0 | |
| online_hidden | num | 0 | |
示例：
**示例：**
查询用户`UID=322892`的直播间信息

11
login/QR.md
View File

@ -23,6 +23,8 @@
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------ | ---- | -------- | ------------ |
| code | num | 返回值 | 0：成功 |
@ -37,7 +39,7 @@
| url | str | 二维码内容url | 恒为87字符 |
| oauthKey | str | 扫码登录秘钥 | 恒为32字符 |
示例：
**示例：**
用申请到的`data`.`url`中的值生成二维码，等待手机客户端扫描，并将`data`.`oauthKey`保存等待使用
@ -68,7 +70,8 @@ http://passport.bilibili.com/qrcode/getLoginUrl
`sid` `DedeUserID` `DedeUserID__ckMd5` `SESSDATA` `bili_jct`
参数（ application/x-www-form-urlencoded ）：
**参数（ application/x-www-form-urlencoded ）：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| -------- | ---- | ------------ | ------ | ----------------------------- |
| oauthKey | data | 扫码登录秘钥 | 必要 | |
@ -76,6 +79,8 @@ http://passport.bilibili.com/qrcode/getLoginUrl
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---------------------------- | ----------------------------------------- | ------------------------------------------------------------ |
| status | bool | 扫码是否成功 | true：成功<br />false：未成功 |
@ -89,7 +94,7 @@ data 对象：
| ---- | ---- | --------------- | ---- |
| url | str | 游戏分站登录url | |
示例：
**示例：**
curl -d "oauthKey=xxx" "http://passport.bilibili.com/qrcode/getLoginInfo"

12
login/login_info.md
View File

@ -12,6 +12,8 @@
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ----------------------------- |
| code | num | 返回值 | 0：成功<br />-101：账号未登录 |
@ -90,7 +92,7 @@
| coupon_balance | num | 每月奖励B币数 | |
| coupon_due_time | num | 0 | 作用尚不明确 |
示例：
**示例：**
查询当前登录用户的信息
@ -166,6 +168,8 @@ http://api.bilibili.com/x/web-interface/nav
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------ | ---- | -------- | ----------------------------- |
| code | num | 返回值 | 0：成功<br />-101：账号未登录 |
@ -198,7 +202,7 @@ http://api.bilibili.com/x/web-interface/nav
| current_exp | num | 当前经验 | |
| next_exp | num | 升级下一等级需达到的经验 | |
示例：
**示例：**
查询当前登录用户的信息
@ -242,6 +246,8 @@ http://account.bilibili.com/home/userInfo
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ----------------------------- |
| code | num | 返回值 | 0：成功<br />-101：账号未登录 |
@ -255,7 +261,7 @@ http://account.bilibili.com/home/userInfo
| follower | num | 粉丝数 | |
| dynamic_count | num | 发布动态数 | |
示例：
**示例：**
查询当前登录用户的状态数

4
login/msg.md
View File

@ -10,6 +10,8 @@
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ----------------------------- |
| code | num | 返回值 | 0：成功<br />-101：账号未登录 |
@ -28,7 +30,7 @@ data 对象：
| sys_msg | num | 未读系统通知数 | |
| up | num | 0 | 作用尚不明确 |
示例：
**示例：**
以下信息代表了未读点赞数为`10`，未读回复数为`3`，未读at消息数为`1`，未读系统通知数为`1`

4
login/private_msg.md
View File

@ -10,6 +10,8 @@
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | --------------------------- |
| code | num | 返回值 | 0：成功<br />-6：账号未登录 |
@ -25,7 +27,7 @@ data 对象：
| follow_unread | num | 已关注用户未读私信数 | |
| _gt_ | num | 0 | 作用尚不明确 |
示例：
**示例：**
以下信息代表了为未关注用户未读私信数为`10`条，已关注用户未读私信数为`3`条

4
other/ip.md
View File

@ -6,6 +6,8 @@
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------ |
| code | num | 返回值 | 0：成功 |
@ -27,7 +29,7 @@
| zone_id | num | ？？？ | |
| country_code | num | 国家/地区代码 | |
示例：
**示例：**
http://api.bilibili.com/x/web-interface/zone

6
ranking&dynamic/dynamic.md
View File

@ -6,7 +6,7 @@
*方式：GET*
参数：
**参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | ------- |
@ -16,6 +16,8 @@
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | --------------------------- |
| code | num | 返回值 | 0：成功<br />-400：请求错误 |
@ -50,7 +52,7 @@
| num | num | 当前页码 | |
| size | num | 每页项数 | |
示例：
**示例：**
获取`tID=21`（生活->日常）分区中的2条最新动态视频信息

6
ranking&dynamic/ranking.md
View File

@ -10,7 +10,7 @@
获取相应时间段内播放量增速为前11的视频
参数：
**参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | ---------------------------------------------------- |
@ -19,6 +19,8 @@
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ------ | -------- | --------------------------- |
| code | num | 返回值 | 0：成功<br />-400：请求错误 |
@ -39,7 +41,7 @@
基本同「[视频详细信息](https://github.com/SocialSisterYi/bilibili-API-collect/blob/master/video/info.md#视频详细信息（avID/bvID互转）)」中的data对象
示例：
**示例：**
获取`tID=1`（动画）分区中的三日视频排行榜

2
user/check_nickname.md
View File

@ -13,6 +13,8 @@
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | --------------------------- |
| code | num | 状态码 | **详细说明见下一表格** |

21
user/info.md
View File

@ -7,13 +7,16 @@
*方式:GET*
参数：
**参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | ---- |
| mid | url | 目标用户UID | 必要 | |
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | --------------------------- |
| code | num | 返回值 | 0：成功<br />-400：请求错误 |
@ -84,7 +87,7 @@
| level | str | 勋章等级 | |
| condition | str | 勋章条件 | |
示列：
**示列：**
查询用户`UID=2`的详细信息
@ -193,14 +196,17 @@ http://i2.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png
*方式:GET*
参数：
**参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------------------- | ------ | ----------------------- |
| mid | url | 目标用户UID | 必要 | |
| photo | url | 是否请求用户主页头图 | 非必要 | true：是<br />false：否 |
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | --------------------------- |
| code | num | 返回值 | 0：成功<br />-400：请求错误 |
@ -309,7 +315,7 @@ http://i2.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png
| s_img | str | 主页头图url 小图 | |
| l_img | str | 主页头图url 正常 | |
示列：
**示列：**
http://api.bilibili.com/x/web-interface/card?mid=2&photo=true
```json
@ -401,6 +407,9 @@ http://api.bilibili.com/x/web-interface/card?mid=2&photo=true
功能同「[登录用户信息1](../login/login_info.md#登录用户信息1（完整）)」
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------- |
| code | num | 返回值 | 0：成功<br />-101：未登录 |
@ -490,7 +499,7 @@ http://api.bilibili.com/x/web-interface/card?mid=2&photo=true
| current_exp | num | 0 | 作用尚不明确 |
| next_exp | num | 0 | 作用尚不明确 |
示例：
**示例：**
http://api.bilibili.com/x/space/myinfo
```json

94
user/relation.md
View File

@ -10,7 +10,7 @@
登录(SESSDATA)可看自己全部
参数：
**参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | -------------------------------- |
@ -20,6 +20,8 @@
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | --------------------------------------------------- |
| code | num | 返回值 | 0：成功<br />-400：请求错误<br />22007：访问超过5页 |
@ -84,7 +86,7 @@
| ---- | ---- | ---- | ------------ |
| path | str | 空 | 作用尚不明确 |
示例：
**示例：**
以每页2项的方式获取`UID=293793435`的用户的第1页的粉丝明细
@ -165,7 +167,7 @@ http://api.bilibili.com/x/relation/followers?vmid=293793435&ps=2&pn=1
登录(SESSDATA)可看自己全部
参数：
**参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | -------------------------------- |
@ -175,6 +177,8 @@ http://api.bilibili.com/x/relation/followers?vmid=293793435&ps=2&pn=1
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | --------------------------------------------------- |
| code | num | 返回值 | 0：成功<br />-400：请求错误<br />22007：访问超过5页 |
@ -247,7 +251,7 @@ data 对象：
| ---- | ---- | ---- | ------------ |
| path | str | 空 | 作用尚不明确 |
示例：
**示例：**
以每页2项的方式获取`UID=293793435`的用户的第1页的关注明细
@ -328,16 +332,16 @@ http://api.bilibili.com/x/relation/followings?vmid=293793435&ps=2&pn=1
需要登录(SESSDATA)
参数（ application/x-www-form-urlencoded ）：
**参数（ application/x-www-form-urlencoded ）：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------- | ------ | ---- |
| fid | data | 目标用户UID | 必要 | |
| act | data | 操作代码 | 必要 | |
| re_src | data | 必须为11 | 必要 | |
| csrf | data | cookies中的bili_jct | 必要 | |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------- | ------ | -------------- |
| fid | data | 目标用户UID | 必要 | |
| act | data | 操作代码 | 必要 | 操作代码见下表 |
| re_src | data | 必须为11 | 必要 | |
| csrf | data | cookies中的bili_jct | 必要 | |
操作代码：
操作代码`act`：
| 代码 | 含义 |
| ---- | ------------ |
@ -351,13 +355,15 @@ http://api.bilibili.com/x/relation/followings?vmid=293793435&ps=2&pn=1
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-102：账号被封停<br />-111：csrf校验失败<br />-400：请求错误<br />22003：用户位于黑名单 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | 作用尚不明确 |
示例：
**示例：**
关注`UID=14082`的用户
@ -381,7 +387,7 @@ curl -b SESSDATA=xxx -d "fid=14082&act=1&re_src=11&csrf=xxx" http://api.bilibili
需要登录(SESSDATA)
参数：
**参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | ---- |
@ -389,6 +395,8 @@ curl -b SESSDATA=xxx -d "fid=14082&act=1&re_src=11&csrf=xxx" http://api.bilibili
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------- |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-400：请求错误 |
@ -414,7 +422,7 @@ curl -b SESSDATA=xxx -d "fid=14082&act=1&re_src=11&csrf=xxx" http://api.bilibili
| n | num | 位于分组（n+1）的分组ID | |
| …… | num | …… | …… |
示例：
**示例：**
可得对于`UID=258150656`的用户，在`2018/10/28 0:51:41`时关注，且设为特别关注，并位于ID为`-10`分组中
@ -445,7 +453,7 @@ http://api.bilibili.com/x/relation?fid=258150656
需要登录(SESSDATA)
参数：
**参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | ---- |
@ -453,6 +461,8 @@ http://api.bilibili.com/x/relation?fid=258150656
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------- |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-400：请求错误 |
@ -495,7 +505,7 @@ http://api.bilibili.com/x/relation?fid=258150656
| n | num | 位于分组（n+1）的分组ID | |
| …… | num | …… | …… |
示例：
**示例：**
可得对于`UID=15858903`的用户，在`2019/1/24 14:24:19`时关注了对方，且互相关注，自己将对方特别关注，并同时位于ID为`-10`和`194110`的分组中，对方也将自己设为特别关注，并同时位于ID为`-10`和`56502`的分组中（虽然我看不到）
@ -541,6 +551,8 @@ http://api.bilibili.com/x/space/acc/relation?mid=15858903
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ------ | -------- | ----------------------------- |
| code | num | 返回值 | 0：成功<br />-101：账号未登录 |
@ -565,7 +577,7 @@ http://api.bilibili.com/x/space/acc/relation?mid=15858903
| name | str | 分组名称 | |
| count | num | 分组成员数 | |
示例：
**示例：**
查询所有的分组的名字以及ID
@ -604,7 +616,7 @@ http://api.bilibili.com/x/relation/tags
需要登录(SESSDATA)
参数：
**参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ---------------------------------- |
@ -614,6 +626,8 @@ http://api.bilibili.com/x/relation/tags
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ------ | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-400：请求错误<br />22104：该分组不存在<br />-101：账号未登录 |
@ -666,7 +680,7 @@ http://api.bilibili.com/x/relation/tags
| ---- | ---- | ---- | ------------ |
| path | str | 空 | 作用尚不明确 |
示例：
**示例：**
以每页2项的方式获取了ID为`207542`分组的第1页的粉丝明细
@ -733,7 +747,7 @@ http://api.bilibili.com/x/relation/tag?tagid=207542&ps=2&pn=1
需要登录(SESSDATA)
参数：
**参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | ---- |
@ -741,6 +755,8 @@ http://api.bilibili.com/x/relation/tag?tagid=207542&ps=2&pn=1
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------- |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-400：请求错误 |
@ -756,7 +772,7 @@ http://api.bilibili.com/x/relation/tag?tagid=207542&ps=2&pn=1
| ｛加入的分组ID n｝ | str | 分组n名称 | |
| …… | str | …… | |
示例：
**示例：**
查询用户`UID=319214221`存在的所有分组ID和名称
@ -786,7 +802,7 @@ http://api.bilibili.com/x/relation/tag/user?fid=319214221
需要登录(SESSDATA)
参数（ application/x-www-form-urlencoded ）：
**参数（ application/x-www-form-urlencoded ）：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------- | ------ | ---------- |
@ -795,6 +811,8 @@ http://api.bilibili.com/x/relation/tag/user?fid=319214221
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功<br />-111：csrf校验失败<br />-101：账号未登录<br />-400：请求错误<br />22106：该分组已经存在<br />22103：分组名过长 |
@ -808,7 +826,7 @@ http://api.bilibili.com/x/relation/tag/user?fid=319214221
| ----- | ---- | -------------- | ---- |
| tagid | num | 创建的分组的ID | |
示例：
**示例：**
创建了名为`vUP`的分组，得到ID为`216677`
@ -835,7 +853,7 @@ curl -b SESSDATA=xxx -d "tag=vUP&csrf=xxx" http://api.bilibili.com/x/relation/ta
需要登录(SESSDATA)
参数（ application/x-www-form-urlencoded ）：
**参数（ application/x-www-form-urlencoded ）：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------- | ------ | ---------- |
@ -845,13 +863,15 @@ curl -b SESSDATA=xxx -d "tag=vUP&csrf=xxx" http://api.bilibili.com/x/relation/ta
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功<br />-111：csrf校验失败<br />-101：账号未登录<br />-400：请求错误<br />22103：分组名过长<br />22104：该分组不存在 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | 作用尚不明确 |
示例：
**示例：**
把ID为`194112`的分组更名为`膜法师`
@ -877,7 +897,7 @@ curl -b SESSDATA=xxx -d "tagid=194112&name=%e8%86%9c%e6%b3%95%e5%b8%88&csrf=xxx"
需要登录(SESSDATA)
参数（ application/x-www-form-urlencoded ）：
**参数（ application/x-www-form-urlencoded ）：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------- | ------ | ---- |
@ -886,6 +906,8 @@ curl -b SESSDATA=xxx -d "tagid=194112&name=%e8%86%9c%e6%b3%95%e5%b8%88&csrf=xxx"
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功<br />-111：csrf校验失败<br />-101：账号未登录<br />-400：请求错误 |
@ -918,7 +940,7 @@ curl -b SESSDATA=xxx -d "tagid=216699&csrf=xxx" http://api.bilibili.com/x/relati
需要登录(SESSDATA)
参数（ application/x-www-form-urlencoded ）：
**参数（ application/x-www-form-urlencoded ）：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------- | ------ | -------------------------- |
@ -928,13 +950,15 @@ curl -b SESSDATA=xxx -d "tagid=216699&csrf=xxx" http://api.bilibili.com/x/relati
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功<br />-111：csrf校验失败<br />-101：账号未登录<br />-400：请求错误<br />22104：无权限<br />22105：未关注 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | 作用尚不明确 |
示例：
**示例：**
把关注用户`UID=205631797`同时添加分组关系到ID为`-10`和`207542`的分组中
@ -958,7 +982,7 @@ curl -b SESSDATA=xxx -d "fids=205631797&tagids=-10%2C207542&csrf=xxx" http://api
需要登录(SESSDATA)
参数（ application/x-www-form-urlencoded ）：
**参数（ application/x-www-form-urlencoded ）：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------- | ------ | -------------------------- |
@ -968,13 +992,15 @@ curl -b SESSDATA=xxx -d "fids=205631797&tagids=-10%2C207542&csrf=xxx" http://api
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功<br />-111：csrf校验失败<br />-101：账号未登录<br />-400：请求错误<br />22104：无权限<br />22105：未关注 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | 作用尚不明确 |
示例：
**示例：**
把关注用户`UID=4856007`和`UID=326499679`同时复制到ID为`231305`的分组中
@ -998,7 +1024,7 @@ curl -b SESSDATA=xxx -d "fids=4856007%2C326499679&tagids=231305&csrf=xxx" http:/
需要登录(SESSDATA)
参数（ application/x-www-form-urlencoded ）：
**参数（ application/x-www-form-urlencoded ）：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------------ | ---- | ------------------- | ------ | -------------------------- |
@ -1009,12 +1035,16 @@ curl -b SESSDATA=xxx -d "fids=4856007%2C326499679&tagids=231305&csrf=xxx" http:/
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功<br />-111：csrf校验失败<br />-101：账号未登录<br />-400：请求错误<br />22104：无权限<br />22105：未关注 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | 作用尚不明确 |
**示例：**
把关注用户`UID=3211734
69`和`UID=327086920`同时从ID为`207542`的分组移动到ID为`231305`的分组中

66
user/space.md
View File

@ -10,7 +10,7 @@
粉丝在其主页上可见
参数：
**参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | ---- |
@ -18,6 +18,8 @@
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ---------------------------------------------------- |
| code | num | 返回值 | 0：成功<br />-400：请求错误<br />53016：没有置顶视频 |
@ -29,7 +31,7 @@
基本同「[视频详细信息](https://github.com/SocialSisterYi/bilibili-API-collect/blob/master/video/info.md#视频详细信息（avID/bvID互转）)」中的data对象
示例：
**示例：**
查询用户`UID=23215368`的置顶视频
@ -112,7 +114,7 @@ http://api.bilibili.com/x/space/top/arc?vmid=23215368
最多可以设置3个
参数：
**参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | ---- |
@ -120,6 +122,8 @@ http://api.bilibili.com/x/space/top/arc?vmid=23215368
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ------ | ---------- | --------------------------- |
| code | num | 返回值 | 0：成功<br />-400：请求错误 |
@ -139,7 +143,7 @@ http://api.bilibili.com/x/space/top/arc?vmid=23215368
基本同「[视频详细信息](https://github.com/SocialSisterYi/bilibili-API-collect/blob/master/video/info.md#视频详细信息（avID/bvID互转）)」中的data对象
示例：
**示例：**
查询用户`UID=23215368`的代表作视频列表
@ -333,7 +337,7 @@ http://api.bilibili.com/x/space/masterpiece?vmid=23215368
*方式:GET*
参数：
**参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | ---- |
@ -343,6 +347,8 @@ http://api.bilibili.com/x/space/masterpiece?vmid=23215368
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | --------------------------- |
| code | num | 返回值 | 0：成功<br />-400：请求错误 |
@ -419,7 +425,7 @@ http://api.bilibili.com/x/space/masterpiece?vmid=23215368
| pn | num | 当前页码 | |
| ps | num | 每页项数 | |
示例：
**示例：**
`pn`（页码）和`ps`（每页项数）只改变`vlist`中成员的多少与内容
@ -519,7 +525,7 @@ http://api.bilibili.com/x/space/arc/search?mid=53456&ps=2&pn=1
带有转义，且只能获取最多15条
参数：
**参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | ---- |
@ -527,6 +533,8 @@ http://api.bilibili.com/x/space/arc/search?mid=53456&ps=2&pn=1
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------ | ------------------------ | ---------------------------------- | --------------------------- |
| status | bool | 状态 | false：失败<br />true：成功 |
@ -565,7 +573,7 @@ http://api.bilibili.com/x/space/arc/search?mid=53456&ps=2&pn=1
| title | str | 标题 | |
| total_count | num | 总计集数 | 未完结：-1<br />已完结：非0正整数 |
示例：
**示例：**
查看用户`UID=14082`的追番预览列表
@ -618,7 +626,7 @@ http://space.bilibili.com/ajax/Bangumi/getList?mid=14082
*方式:GET*
参数：
**参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | -------------------- |
@ -629,6 +637,8 @@ http://space.bilibili.com/ajax/Bangumi/getList?mid=14082
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ---------------------------------------------------------- |
| code | num | 返回值 | 0：成功<br />-400：请求错误<br />53013：用户隐私设置未公开 |
@ -657,7 +667,7 @@ http://space.bilibili.com/ajax/Bangumi/getList?mid=14082
基本同「番剧详细信息」中的result对象（未完工）
示例：
**示例：**
查看用户`UID=14082`的追番明细
@ -864,7 +874,7 @@ http://api.bilibili.com/x/space/bangumi/follow/list?vmid=14082&pn=1&ps=2&type=1
所有类型的相簿
参数：
**参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------ | ------ | ------- |
@ -873,6 +883,8 @@ http://api.bilibili.com/x/space/bangumi/follow/list?vmid=14082&pn=1&ps=2&type=1
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ------ | -------- | --------------------------- |
| code | num | 返回值 | 0：成功<br />-400：请求错误 |
@ -919,7 +931,7 @@ http://api.bilibili.com/x/space/bangumi/follow/list?vmid=14082&pn=1&ps=2&type=1
| img_src | str | 图片url | |
| img_width | num | 图片宽度 | |
示例：
**示例：**
查询用户`UID=53456`的投稿相簿预览
@ -982,7 +994,7 @@ http://api.bilibili.com/x/space/album/index?mid=53456&ps=2
*方式:GET*
参数：
**参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| --------- | ---- | ----------- | ------ | ------------------------------------------------------------ |
@ -993,6 +1005,8 @@ http://api.bilibili.com/x/space/album/index?mid=53456&ps=2
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------- |
| code | num | 返回值 | 0：成功 |
@ -1045,7 +1059,7 @@ http://api.bilibili.com/x/space/album/index?mid=53456&ps=2
| img_src | str | 图片url | |
| img_width | num | 图片宽度 | |
示例：
**示例：**
查询用户`UID=53456`的投稿明细中的全部类型
@ -1117,7 +1131,7 @@ http://api.vc.bilibili.com/link_draw/v1/doc/doc_list?uid=2&page_num=1&page_size=
*方式:GET*
参数：
**参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | ---- |
@ -1125,6 +1139,8 @@ http://api.vc.bilibili.com/link_draw/v1/doc/doc_list?uid=2&page_num=1&page_size=
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------ |
| code | num | 返回值 | 0：成功 |
@ -1159,7 +1175,7 @@ http://api.vc.bilibili.com/link_draw/v1/doc/doc_list?uid=2&page_num=1&page_size=
| mtime | num | 创建时间 | 时间戳 |
| name | str | 标题 | |
示例：
**示例：**
查询用户`UID=53456`的频道列表
@ -1233,7 +1249,7 @@ http://api.bilibili.com/x/space/channel/list?mid=53456
*方式:GET*
参数：
**参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | --------- |
@ -1244,6 +1260,8 @@ http://api.bilibili.com/x/space/channel/list?mid=53456
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------- |
| code | num | 返回值 | 0：成功<br />-400：请求错误<br />-404：无用户对应的频道 |
@ -1291,7 +1309,7 @@ http://api.bilibili.com/x/space/channel/list?mid=53456
| num | num | 当前页码 | |
| size | num | 每页项数 | |
示例：
**示例：**
查询用户`UID=53456`的频道`170`中的视频
@ -1441,7 +1459,7 @@ http://api.bilibili.com/x/space/channel/video?mid=53456&cid=170&ps=2&pn=1
*方式:GET*
参数：
**参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | ---- |
@ -1449,6 +1467,8 @@ http://api.bilibili.com/x/space/channel/video?mid=53456&cid=170&ps=2&pn=1
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | --------------------------- |
| code | num | 返回值 | 0：成功<br />-400：请求错误 |
@ -1456,7 +1476,7 @@ http://api.bilibili.com/x/space/channel/video?mid=53456&cid=170&ps=2&pn=1
| ttl | num | 1 | 作用尚不明确 |
| data | str | 公告信息 | 无则为空 |
示例：
**示例：**
查看用户`UID=53456`的空间公告
@ -1483,7 +1503,7 @@ http://api.bilibili.com/x/space/notice?mid=53456
带有转义
参数：
**参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | ---- |
@ -1491,6 +1511,8 @@ http://api.bilibili.com/x/space/notice?mid=53456
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ------ | -------- | --------------------------- |
| code | num | 返回值 | 0：成功<br />-400：请求错误 |
@ -1520,7 +1542,7 @@ http://api.bilibili.com/x/space/notice?mid=53456
| …… | str | …… | |
| 4 | str | TAG5 | 上限5条 |
示例：
**示例：**
查看用户`UID=53456`的个人TAG

29
user/status_number.md
View File

@ -5,13 +5,16 @@
*方式:GET*
参数：
**参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | ---- |
| vmid | url | 目标用户UID | 必要 | |
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | --------------------------- |
| code | num | 返回值 | 0：成功<br />-400：请求错误 |
@ -29,7 +32,7 @@
| black | num | 黑名单数 | 需要登录(SESSDATA) <br />只能查看自己的<br />默认为0 |
| follower | num | 粉丝数 | |
示例：
**示例：**
查询用户`UID=332704117`的关系状态数
@ -58,13 +61,16 @@ http://api.bilibili.com/x/relation/stat?vmid=332704117
*方式:GET*
参数：
**参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | ---- |
| mid | url | 目标用户UID | 必要 | |
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | --------------------------- |
| code | num | 返回值 | 0：成功<br />-400：请求错误 |
@ -92,7 +98,7 @@ http://api.bilibili.com/x/relation/stat?vmid=332704117
| ---- | ----- | ---------- | ----- |
| view | num | 专栏阅读量 | |
示例：
**示例：**
查询用户`UID=456664753`的UP主状态数
@ -122,13 +128,16 @@ http://api.bilibili.com/x/space/upstat?mid=456664753
*方式:GET*
参数：
**参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | ---- |
| mid | url | 目标用户UID | 必要 | |
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | --------------------------- |
| code | num | 返回值 | 0：成功<br />-400：请求错误 |
@ -166,7 +175,7 @@ http://api.bilibili.com/x/space/upstat?mid=456664753
| master | num | 全部收藏夹数 | 需要登录(SESSDATA) <br />只能查看自己的 |
| guest | num | 公开收藏夹数 | 无视隐私设置 |
示例：
**示例：**
查询用户`UID=239202390`的订阅&投稿状态数
@ -206,7 +215,7 @@ http://api.bilibili.com/x/space/navnum?mid=239202390
*方式：GET*
参数：
**参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | ---- |
@ -214,6 +223,8 @@ http://api.bilibili.com/x/space/navnum?mid=239202390
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------- |
| code | num | 返回值 | 0：成功 |
@ -230,7 +241,7 @@ http://api.bilibili.com/x/space/navnum?mid=239202390
| photo_count | num | 发布摄影数 | |
| daily_count | num | 发布日常（图片动态）数 | |
示例：
**示例：**
查询用户`UID=53456`的投稿相簿数

18
video/info.md
View File

@ -8,7 +8,7 @@
*方式:GET*
参数：
**参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ------------------ |
@ -17,6 +17,8 @@
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | --------------------------------------------- |
| code | num | 返回值 | 0：成功<br />-400：请求错误<br />-404：无视频 |
@ -204,7 +206,7 @@
| desc | str | 成员认证备注 | 无为空 |
| type | num | 成员认证类型 | -1：无<br />0：有 |
示例：
**示例：**
http://api.bilibili.com/x/web-interface/view?aid=85440373
@ -353,7 +355,7 @@ http://i0.hdslb.com/bfs/face/5387950a59be8038daaae3f66dfb5a85e20d5737.jpg
*方式:GET*
参数：
**参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ------------------ |
@ -362,6 +364,8 @@ http://i0.hdslb.com/bfs/face/5387950a59be8038daaae3f66dfb5a85e20d5737.jpg
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | -------------------------------------------------- |
| code | num | 返回值 | 0：成功<br />-400：请求错误<br />62002：稿件不可见 |
@ -369,7 +373,7 @@ http://i0.hdslb.com/bfs/face/5387950a59be8038daaae3f66dfb5a85e20d5737.jpg
| ttl | num | 1 | 作用尚不明确 |
| data | str | 简介内容 | |
示例：
**示例：**
查看视频~~（教主的咕鸽）~~`av39330059`/`BV1Bt411z799`的简介
@ -394,7 +398,7 @@ http://api.bilibili.com/x/web-interface/archive/desc?aid=39330059
*方式:GET*
参数：
**参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ------------------ |
@ -403,6 +407,8 @@ http://api.bilibili.com/x/web-interface/archive/desc?aid=39330059
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ----- | -------- | --------------------------------------------- |
| code | num | 返回值 | 0：成功<br />-400：请求错误<br />-404：无视频 |
@ -439,7 +445,7 @@ http://api.bilibili.com/x/web-interface/archive/desc?aid=39330059
| height | num | 当前分P 高度 | 可能为0 |
| rotate | num | 0 | 作用尚不明确 |
示例：
**示例：**
查询视频`av13502509`/`BV1ex411J7GE`的分P列表

42
video/like_coin_fav.md
View File

@ -12,7 +12,7 @@
*方式：POST*
参数（ application/x-www-form-urlencoded ）：
**参数（ application/x-www-form-urlencoded ）：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------- | ------ | ---------------------- |
@ -23,13 +23,15 @@
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功 <br />-101：账号未登录<br />-111：csrf校验失败<br />-400：请求错误<br />10003：不存在该稿件<br />65006：已赞过<br />65004：取消点赞失败 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | 作用尚不明确 |
示例：
**示例：**
为视频av79677524/BV1uJ411r7hL点赞
@ -55,7 +57,7 @@ curl -b "SESSDATA=xxx" -d "aid=79677524&like=1&csrf=xxx" "http://api.bilibili.co
*方式：POST*
参数（ application/x-www-form-urlencoded ）：
**参数（ application/x-www-form-urlencoded ）：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ----------- | ---- | ------------------- | ------ | --------------------------------------- |
@ -67,6 +69,8 @@ curl -b "SESSDATA=xxx" -d "aid=79677524&like=1&csrf=xxx" "http://api.bilibili.co
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-102：账号被封停<br />-104：硬币不足<br />-111：csrf校验失败<br />-400：请求错误<br />10003：不存在该稿件<br />34002：不能给自己投币<br />34003：非法的投币数量<br />34005：超过投币上限 |
@ -80,7 +84,7 @@ data 对象：
| ---- | ---- | ------------ | ----------------------------------------------------- |
| like | bool | 是否点赞成功 | true：成功<br />false：失败<br />已赞过则附加点赞失败 |
示例：
**示例：**
为视频`av90671873`/`BV1N7411A7wC`投币2枚
@ -111,7 +115,7 @@ curl -b "SESSDATA=xxx" -d "aid=90671873&select_like=1&multiply=2&csrf=xxx" "http
需要验证referer为 `http://www.bilibili.com`或`https://www.bilibili.com`域名下
参数（ application/x-www-form-urlencoded ）：
**参数（ application/x-www-form-urlencoded ）：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------------- | ---- | ------------------- | ------ | ----------------------- |
@ -123,6 +127,8 @@ curl -b "SESSDATA=xxx" -d "aid=90671873&select_like=1&multiply=2&csrf=xxx" "http
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-111：csrf校验失败<br />-400：请求错误<br />-403：访问权限不足<br />10003：不存在该稿件<br />11201：已经收藏过了<br />11202：已经取消收藏了<br />72010017：参数错误 |
@ -135,7 +141,7 @@ curl -b "SESSDATA=xxx" -d "aid=90671873&select_like=1&multiply=2&csrf=xxx" "http
| ------ | ---- | ----- | ------------ |
| prompt | bool | false | 作用尚不明确 |
示例：
**示例：**
将视频`av49166435`添加到收藏夹`49166435`中
@ -163,7 +169,7 @@ curl --referer "http://www.bilibili.com" -b "SESSDATA=xxx" -d "rid=90671873&type
同时点赞投币收藏视频，收藏于默认收藏夹中
参数（ application/x-www-form-urlencoded ）：
**参数（ application/x-www-form-urlencoded ）：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------- | ------ | ------------------ |
@ -173,6 +179,8 @@ curl --referer "http://www.bilibili.com" -b "SESSDATA=xxx" -d "rid=90671873&type
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-111：csrf校验失败<br />-400：请求错误<br />10003：不存在该稿件 |
@ -189,7 +197,7 @@ curl --referer "http://www.bilibili.com" -b "SESSDATA=xxx" -d "rid=90671873&type
| fav | bool | 是否收藏成功 | |
| multiply | num | 投币枚数 | 默认为2 |
示例：
**示例：**
将视频`av91003840`/`BV1Wj411f79U`一键三连
@ -223,7 +231,7 @@ curl -b "SESSDATA=xxx" -d "aid=91003840&csrf=xxx" "http://api.bilibili.com/x/web
*方式:GET*
参数：
**参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------ | ------ | ---- |
@ -231,6 +239,8 @@ curl -b "SESSDATA=xxx" -d "aid=91003840&csrf=xxx" "http://api.bilibili.com/x/web
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------- |
| code | num | 返回值 | 0：成功<br />-400：请求错误<br />-101：账号未登录 |
@ -245,7 +255,7 @@ data 对象：
| count | num | 1 | 作用尚不明确 |
| favoured | bool | 是否收藏 | true：已收藏<br />false：未收藏 |
示例：
**示例：**
视频`av46281123`/`BV1Bb411H7Dv`的状态为已收藏
@ -275,7 +285,7 @@ http://api.bilibili.com/x/v2/fav/video/favoured?aid=46281123
*方式:GET*
参数：
**参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ------------------ |
@ -284,6 +294,8 @@ http://api.bilibili.com/x/v2/fav/video/favoured?aid=46281123
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | ---------- | ------------------------------------------------- |
| code | num | 返回值 | 0：成功<br />-400：请求错误<br />-101：账号未登录 |
@ -291,7 +303,7 @@ http://api.bilibili.com/x/v2/fav/video/favoured?aid=46281123
| ttl | num | 1 | 作用尚不明确 |
| data | num | 被点赞标志 | 0：未点赞<br />1：已点赞 |
示例：
**示例：**
视频`av39330059`/`BV1Bt411z799`的状态为已点赞
@ -318,7 +330,7 @@ http://api.bilibili.com/x/web-interface/archive/has/like?aid=39330059
*方式:GET*
参数：
**参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ------------------ |
@ -327,6 +339,8 @@ http://api.bilibili.com/x/web-interface/archive/has/like?aid=39330059
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------- |
| code | num | 返回值 | 0：成功<br />-400：请求错误<br />-101：账号未登录 |
@ -340,7 +354,7 @@ http://api.bilibili.com/x/web-interface/archive/has/like?aid=39330059
| -------- | ---- | -------- | --------- |
| multiply | num | 投币枚数 | 未投币为0 |
示例：
**示例：**
视频`av37896701`/`BV18t411q7zz`的投币数为2枚

6
video/recommend.md
View File

@ -8,7 +8,7 @@
最多获取40条推荐视频
参数：
**参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ------------------ |
@ -17,6 +17,8 @@
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ------ | -------- | ---------------------------- |
| code | num | 返回值 | 0：成功 <br />-400：请求错误 |
@ -37,7 +39,7 @@
基本同「[视频详细信息](info.md#视频详细信息)」中的data对象
示例：
**示例：**
查询视频`av7`/`BV1xx411c7m9`的推荐视频列表

13
video/snapshot.md
View File

@ -11,7 +11,8 @@
*方式:GET*
参数：
**参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------ | ------ | ----------------------------------- |
| aid | url | 视频avID | 非必要 | avID与bvID任选一个 |
@ -21,6 +22,8 @@
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------ |
| code | num | 返回值 | 0：成功 <br />40001：请求错误<br />40003：无视频 |
@ -57,7 +60,7 @@
| n | num | 图片n 截取时间 | 单位为秒 |
| …… | num | …… | 单位为秒 |
示例：
**示例：**
http://api.bilibili.com/x/player/videoshot?aid=26273789&index=1
@ -90,12 +93,16 @@ http://api.bilibili.com/x/player/videoshot?aid=26273789&index=1
内容与「获取视频快照1」加参数「index」=1相同，但url带有转义，仅限第1P
**参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ---- |
| aid | url | 视频avID | 必要 | |
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ---------------------------------------------- |
| code | num | 返回值 | 0：成功<br />40001：请求错误<br />-404：无视频 |
@ -132,7 +139,7 @@ http://api.bilibili.com/x/player/videoshot?aid=26273789&index=1
| n | num | 图片n 截取时间 | 单位为秒 |
| …… | num | …… | 单位为秒 |
示例：
**示例：**
http://api.bilibili.com/pvideo?aid=26273789

14
video/status_number.md
View File

@ -5,13 +5,16 @@
*方式:GET*
参数：
**参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ---- |
| aid | url | 视频avID | 必要 | |
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ----------------------------------------------- |
| code | num | 返回值 | 0：成功<br />40001：请求错误<br />40003：无视频 |
@ -37,7 +40,7 @@
| no_reprint | num | 禁止转载标志 | 0：无<br />1：禁止 |
| copyright | num | 版权标志 | 1：自制<br />2：转载 |
示例：
**示例：**
查询视频`av91572143`的状态数
@ -80,7 +83,8 @@ http://api.bilibili.com/archive_stat/stat?aid=91572143
**此API克python，UA中只要存在\*python\*字眼就无法获取正确内容，如用py请改UA**
参数：
**参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ------------------ |
| aid | url | 视频avID | 非必要 | avID与bvID任选一个 |
@ -88,6 +92,8 @@ http://api.bilibili.com/archive_stat/stat?aid=91572143
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ----------------------------------------------- |
| code | num | 返回值 | 0：成功 <br />-400：请求错误<br />40003：无视频 |
@ -116,7 +122,7 @@ http://api.bilibili.com/archive_stat/stat?aid=91572143
| argue_msg | str | 警告信息 | 默认为空 |
| evaluation | str | 视频评分 | 默认为空 |
示例：
**示例：**
查询视频`av2271112`/`BV1es411D7sW`的状态数