Northern_Lights/bilibili-API-collect
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

增加了若干个人空间的api

Browse Source
This commit is contained in:
SocialSisterYi 2020-04-10 11:17:32 +08:00
parent 0941945348
commit 994c99caf5
10 changed files with 877 additions and 68 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
README.md
View File

@ -103,7 +103,7 @@
- 哔哩哔哩漫画
- 哔哩哔哩游戏
- [其他](other)
- [ip查询](other/ip.md)√
- [ip位置查询](other/ip.md)√
B站专栏同步推出[《B站api研究记》](https://www.bilibili.com/read/readlist/rl207146)系列，欢迎关注

2
live/info.md
View File

@ -30,7 +30,7 @@
| liveStatus | num | 直播状态 | 0：未开播<br />1：直播中 |
| url | str | 直播间网页url | |
| title | str | 直播间标题 | |
| cover | str | 直播间封面 | jpg png |
| cover | str | 直播间封面 | |
| online | num | 直播间人气 | 值为上次直播刷新 |
| roomid | num | 直播间ID | |
| broadcast_type | num | 0 | |

8
login/login_info.md
View File

@ -25,7 +25,7 @@
| --------------- | ---- | ---------------- | ------------------------------- |
| isLogin | bool | 是否已登录 | |
| email_verified | num | 是否验证邮箱地址 | 0：未验证<br />1：已验证 |
| face | str | 登录用户头像url | jpg gif |
| face | str | 登录用户头像url | |
| level_info | obj | 等级信息 | |
| mid | num | 登录UID | |
| mobile_verified | num | 是否验证手机号 | 0：未验证<br />1：已验证 |
@ -78,7 +78,7 @@
| ------ | ---- | ----------- | ------------ |
| pid | num | 挂件id | |
| name | str | 挂件名称 | |
| image | str | 挂件图片url | png |
| image | str | 挂件图片url | |
| expire | num | 0 | 作用尚不明确 |
`data`中的`wallet`对象：
@ -179,9 +179,9 @@ http://api.bilibili.com/x/web-interface/nav
| level_info | obj | 等级信息 | |
| bCoins | num | 拥有B币数 | |
| coins | num | 拥有硬币数 | |
| face | str | 登录用户头像url | jpg gif |
| face | str | 登录用户头像url | |
| nameplate_current | null | ??? | 作用尚不明确 |
| pendant_current | str | 登录用户头像框url | png |
| pendant_current | str | 登录用户头像框url | |
| uname | str | 登录用户昵称 | |
| userStatus | str | 登录用户状态 | |
| vipType | num | 大会员类型 | 0：无<br />1：月度<br />2：年度 |

22
user/info.md
View File

@ -28,7 +28,7 @@
| mid | num | UID | |
| name | str | 昵称 | |
| sex | str | 性别 | 男 女 保密 |
| face | str | 头像链接 | jpg或gif |
| face | str | 头像链接 | |
| sign | str | 签名 | |
| rank | num | 10000 | 作用尚不明确 |
| level | num | 当前等级 | 0-6级 |
@ -70,7 +70,7 @@
| ------ | ---- | ----------- | ------------ |
| pid | num | 挂件id | |
| name | str | 挂件名称 | |
| image | str | 挂件图片url | png |
| image | str | 挂件图片url | |
| expire | num | 0 | 作用尚不明确 |
`data`中的`nameplate`对象：
@ -79,8 +79,8 @@
| ----------- | ---- | ---------------- | ---- |
| nid | num | 勋章id | |
| name | str | 勋章名称 | |
| image | str | 挂件图片url 正常 | png |
| image_small | str | 勋章图片url 小 | png |
| image | str | 挂件图片url 正常 | |
| image_small | str | 勋章图片url 小 | |
| level | str | 勋章等级 | |
| condition | str | 勋章条件 | |
@ -222,7 +222,7 @@ http://i2.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png
| approve | bool | false | 作用尚不明确 |
| name | str | 用户昵称 | |
| sex | str | 用户性别 | 男 女 保密 |
| face | str | 用户头像链接 | jpg或gif |
| face | str | 用户头像链接 | |
| DisplayRank | str | 0 | 作用尚不明确 |
| regtime | num | 0 | 作用尚不明确 |
| spacesta | num | 0 | 作用尚不明确 |
@ -306,8 +306,8 @@ http://i2.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png
| 字段 | 类型 | 内容 | 备注 |
| ----- | ---- | ---------------- | ---- |
| s_img | str | 主页头图url 小图 | png |
| l_img | str | 主页头图url 正常 | png |
| s_img | str | 主页头图url 小图 | |
| l_img | str | 主页头图url 正常 | |
示列：
@ -415,7 +415,7 @@ http://api.bilibili.com/x/web-interface/card?mid=2&photo=true
| mid | num | UID | |
| name | str | 昵称 | |
| sex | str | 性别 | 男 女 保密 |
| face | str | 头像图片url | jpg gif |
| face | str | 头像图片url | |
| sign | str | 签名 | |
| rank | num | 10000 | 作用尚不明确 |
| level | num | 当前等级 | 0-6级 |
@ -458,7 +458,7 @@ http://api.bilibili.com/x/web-interface/card?mid=2&photo=true
| ------ | ---- | ----------- | ------------ |
| pid | num | 挂件id | |
| name | str | 挂件名称 | |
| image | str | 挂件图片url | png |
| image | str | 挂件图片url | |
| expire | num | 0 | 作用尚不明确 |
`data`中的`nameplate`对象：
@ -467,8 +467,8 @@ http://api.bilibili.com/x/web-interface/card?mid=2&photo=true
| ----------- | ---- | ---------------- | ---- |
| nid | num | 勋章id | |
| name | str | 勋章名称 | |
| image | str | 挂件图片url 正常 | png |
| image_small | str | 勋章图片url 小 | png |
| image | str | 挂件图片url 正常 | |
| image_small | str | 勋章图片url 小 | |
| level | str | 勋章等级 | |
| condition | str | 勋章条件 | |

137
user/relation.md
View File

@ -53,7 +53,7 @@
| tag | null | | 作用尚不明确 |
| special | num | 0 | 作用尚不明确 |
| uname | str | 用户昵称 | |
| face | str | 用户头像url | jpg gif |
| face | str | 用户头像url | |
| sign | str | 用户签名 | |
| official_verify | obj | 认证信息 | |
| vip | obj | 会员信息 | |
@ -86,7 +86,7 @@
示例：
以每页2项的方式获取UID为293793435的用户的第1页的粉丝明细
以每页2项的方式获取`UID=293793435`的用户的第1页的粉丝明细
http://api.bilibili.com/x/relation/followers?vmid=293793435&ps=2&pn=1
@ -208,7 +208,7 @@ data 对象：
| tag | null默认分组<br />arrary存在至少一个分组 | 分组ID | 作用尚不明确 |
| special | num | 特别关注标志 | 0：否<br />1：是 |
| uname | str | 用户昵称 | |
| face | str | 用户头像url | jpg gif |
| face | str | 用户头像url | |
| sign | str | 用户签名 | |
| official_verify | obj | 认证信息 | |
| vip | obj | 会员信息 | |
@ -249,7 +249,7 @@ data 对象：
示例：
以每页2项的方式获取UID为293793435的用户的第1页的关注明细
以每页2项的方式获取`UID=293793435`的用户的第1页的关注明细
http://api.bilibili.com/x/relation/followings?vmid=293793435&ps=2&pn=1
@ -353,13 +353,13 @@ http://api.bilibili.com/x/relation/followings?vmid=293793435&ps=2&pn=1
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功<br />-111：csrf校验失败<br />-101：账号未登录<br />-400：请求错误<br />22003：用户位于黑名单 |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-102：账号被封停<br />-111：csrf校验失败<br />-400：请求错误<br />22003：用户位于黑名单 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | 作用尚不明确 |
示例：
关注了UID为14082的用户
关注`UID=14082`的用户
curl -b SESSDATA=xxx -d "fid=14082&act=1&re_src=11&csrf=xxx" http://api.bilibili.com/x/relation/modify
@ -416,7 +416,7 @@ curl -b SESSDATA=xxx -d "fid=14082&act=1&re_src=11&csrf=xxx" http://api.bilibili
示例：
可得对于UID为258150656的用户，在2018/10/28 0:51:41时关注，且设为特别关注，并位于ID为-10分组中
可得对于`UID=258150656`的用户，在`2018/10/28 0:51:41`时关注，且设为特别关注，并位于ID为`-10`分组中
http://api.bilibili.com/x/relation?fid=258150656
@ -497,7 +497,7 @@ http://api.bilibili.com/x/relation?fid=258150656
示例：
可得对于UID为15858903的用户，在2019/1/24 14:24:19时关注了对方，且互相关注，自己将对方特别关注，并同时位于ID为-10和194110的分组中，对方也将自己设为特别关注，并同时位于-10和56502的分组中（虽然我看不到）
可得对于`UID=15858903`的用户，在`2019/1/24 14:24:19`时关注了对方，且互相关注，自己将对方特别关注，并同时位于ID为`-10`和`194110`的分组中，对方也将自己设为特别关注，并同时位于ID为`-10`和`56502`的分组中（虽然我看不到）
http://api.bilibili.com/x/space/acc/relation?mid=15858903
@ -631,14 +631,14 @@ http://api.bilibili.com/x/relation/tags
数组`data`中的对象：
| 字段 | 类型 | 内容 | 备注 |
| --------------- | ---- | ----------- | ------- |
| mid | num | 用户UID | |
| uname | str | 用户昵称 | |
| face | str | 用户头像url | jpg gif |
| sign | str | 用户签名 | |
| official_verify | obj | 认证信息 | |
| vip | obj | 会员信息 | |
| 字段 | 类型 | 内容 | 备注 |
| --------------- | ---- | ----------- | ---- |
| mid | num | 用户UID | |
| uname | str | 用户昵称 | |
| face | str | 用户头像url | |
| sign | str | 用户签名 | |
| official_verify | obj | 认证信息 | |
| vip | obj | 会员信息 | |
数组`data`中的对象中的`official_verify`对象：
@ -668,7 +668,7 @@ http://api.bilibili.com/x/relation/tags
示例：
以每页2项的方式获取了分组ID为207542分组的第1页的粉丝明细
以每页2项的方式获取了ID为`207542`分组的第1页的粉丝明细
http://api.bilibili.com/x/relation/tag?tagid=207542&ps=2&pn=1
@ -758,7 +758,7 @@ http://api.bilibili.com/x/relation/tag?tagid=207542&ps=2&pn=1
示例：
查询用户319214221存在的分组的ID和名称
查询用户`UID=319214221`存在的所有分组ID和名称
http://api.bilibili.com/x/relation/tag/user?fid=319214221
@ -810,7 +810,7 @@ http://api.bilibili.com/x/relation/tag/user?fid=319214221
示例：
创建了名为"vUP"的分组，ID为216677
创建了名为`vUP`的分组，得到ID为`216677`
curl -b SESSDATA=xxx -d "tag=vUP&csrf=xxx" http://api.bilibili.com/x/relation/tag/create
@ -853,7 +853,7 @@ curl -b SESSDATA=xxx -d "tag=vUP&csrf=xxx" http://api.bilibili.com/x/relation/ta
示例：
把ID为194112的分组更名为"膜法师"
把ID为`194112`的分组更名为`膜法师`
curl -b SESSDATA=xxx -d "tagid=194112&name=%e8%86%9c%e6%b3%95%e5%b8%88&csrf=xxx" http://api.bilibili.com/x/relation/tag/update
@ -894,7 +894,7 @@ curl -b SESSDATA=xxx -d "tagid=194112&name=%e8%86%9c%e6%b3%95%e5%b8%88&csrf=xxx"
示例：
删除分组ID为216699的分组
删除分组ID为`216699`的分组
curl -b SESSDATA=xxx -d "tagid=216699&csrf=xxx" http://api.bilibili.com/x/relation/tag/del
@ -920,23 +920,23 @@ curl -b SESSDATA=xxx -d "tagid=216699&csrf=xxx" http://api.bilibili.com/x/relati
参数（ application/x-www-form-urlencoded ）：
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------- | ------ | ------------------------ |
| fids | data | 目标用户UID | 必要 | |
| tagids | data | 分组ID | 必要 | 每个ID见用","（%2C）间隔 |
| csrf | data | cookies中的bili_jct | 必要 | |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------- | ------ | -------------------------- |
| fids | data | 目标用户UID | 必要 | 每个ID之间用","（%2C）间隔 |
| tagids | data | 分组ID | 必要 | 每个ID之间用","（%2C）间隔 |
| csrf | data | cookies中的bili_jct | 必要 | |
**json回复：**
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功<br />-111：csrf校验失败<br />-101：账号未登录<br />-400：请求错误<br />22105：未关注 |
| 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的分组中
把关注用户`UID=205631797`同时添加分组关系到ID为`-10`和`207542`的分组中
curl -b SESSDATA=xxx -d "fids=205631797&tagids=-10%2C207542&csrf=xxx" http://api.bilibili.com/x/relation/tags/addUsers
@ -948,3 +948,84 @@ curl -b SESSDATA=xxx -d "fids=205631797&tagids=-10%2C207542&csrf=xxx" http://api
}
```
### 批量复制关注用户到分组
> http://api.bilibili.com/x/relation/tags/copyUsers
*方式:POST*
需要登录(SESSDATA)
参数（ application/x-www-form-urlencoded ）：
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------- | ------ | -------------------------- |
| fids | data | 目标用户UID | 必要 | 每个ID之间用","（%2C）间隔 |
| tagids | data | 分组ID | 必要 | 每个ID之间用","（%2C）间隔 |
| csrf | data | cookies中的bili_jct | 必要 | |
**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`的分组中
curl -b SESSDATA=xxx -d "fids=4856007%2C326499679&tagids=231305&csrf=xxx" http://api.bilibili.com/x/relation/tags/copyUsers
```json
{
"code":0,
"message":"0",
"ttl":1
}
```
### 批量移动关注用户到分组
> http://api.bilibili.com/x/relation/tags/moveUsers
*方式:POST*
需要登录(SESSDATA)
参数（ application/x-www-form-urlencoded ）：
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------------ | ---- | ------------------- | ------ | -------------------------- |
| beforeTagids | data | | | |
| afterTagids | data | | | |
| fids | data | 目标用户UID | 必要 | 每个ID之间用","（%2C）间隔 |
| csrf | data | cookies中的bili_jct | 必要 | |
**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`的分组中
curl -b SESSDATA=xxx -d "beforeTagids=207542&afterTagids=231305&fids=3211734
69%2C327086920&csrf=xxx" http://api.bilibili.com/x/relation/tags/moveUsers
```json
{
"code":0,
"message":"0",
"ttl":1
}
```

678
user/space.md
View File

@ -403,7 +403,7 @@ http://api.bilibili.com/x/space/masterpiece?vmid=23215368
| is_union_video | num | 是否为合作视频 | 0：否<br />1：是 |
| length | str | 视频长度 | MM:SS |
| mid | num | 视频UP主UID | 不一定为目标用户（合作视频） |
| pic | str | 视频封面 | jpg gif |
| pic | str | 视频封面 | |
| play | num | 视频播放次数 | |
| review | num | 0 | 作用尚不明确 |
| subtitle | str | 空 | 作用尚不明确 |
@ -509,6 +509,105 @@ http://api.bilibili.com/x/space/arc/search?mid=53456&ps=2&pn=1
### 查询用户追番预览列表
> http://space.bilibili.com/ajax/Bangumi/getList
*方式:GET*
带有转义，且只能获取最多15条
参数：
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | ---- |
| mid | url | 目标用户UID | 必要 | |
**json回复：**
| 字段 | 类型 | 内容 | 备注 |
| ------ | ------------------------ | ---------------------------------- | --------------------------- |
| status | bool | 状态 | false：失败<br />true：成功 |
| data | 失败：str<br />成功：obj | 失败：错误信息<br />成功：信息本体 | |
`data`对象：
| 字段 | 类型 | 内容 | 备注 |
| ------ | ------ | ------------ | ------------ |
| count | num | 总计追番数 | |
| pages | num | 0 | 作用尚不明确 |
| result | arrary | 追番预览列表 | |
`data`中的`result`数组：
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ----------- | -------------------------- |
| 0 | obj | 追番1 | |
| n | obj | 追番（n+1） | 按照目标用户的关注顺序排列 |
| …… | obj | …… | |
| 14 | obj | 追番15 | 最后一项 |
`data`中的`result`数组中的对象：
| 字段 | 类型 | 内容 | 备注 |
| --------------- | ---- | --------------- | --------------------------------- |
| brief | str | 简介 | |
| cover | str | 封面图片url | |
| evaluate | str | 空 | |
| favorites | num | 追番数 | |
| is_finish | num | 是否已完结 | 0：未完结<br />1：已完结 |
| last_ep_index | num | 0 | 作用尚不明确 |
| newest_ep_index | num | 最新一话 | 可能为0 |
| season_id | str | 番剧ssID | |
| share_url | str | 播放页面链接url | |
| title | str | 标题 | |
| total_count | num | 总计集数 | 未完结：-1<br />已完结：非0正整数 |
示例：
查看用户`UID=14082`的追番预览列表
http://space.bilibili.com/ajax/Bangumi/getList?mid=14082
```json
{
"status": true,
"data": {
"count": 25,
"pages": 0,
"result": [{
"season_id": "29310",
"share_url": "http:\/\/bangumi.bilibili.com\/anime\/29310\/",
"title": "\u5f02\u5ea6\u4fb5\u5165 ID:INVADED",
"is_finish": 1,
"favorites": 3479220,
"newest_ep_index": 13,
"last_ep_index": 0,
"total_count": 13,
"cover": "http:\/\/i0.hdslb.com\/bfs\/bangumi\/image\/9bf9e66968f85b33ec3769a16c86b36dc984abbc.png",
"evaluate": "",
"brief": "\u672c\u7247\u8bb2\u8ff0\u5229\u7528\u80fd\u68c0\u6d4b\u51fa\u4eba\u4eec\u6740\u610f\u7684\u88c5\u7f6e\u4ee5\u53ca\u5229\u7528\u601d\u60f3\u7c92\u5b50\u505a\u51fa\u7684\u201c\u4e95\u201d\uff0c\u6765\u63a2\u77e5\u4e8b\u4ef6\u771f\u76f8\u7684\u79d1\u5e7b\u6545\u4e8b\u3002"
}, {
"season_id": "25739",
"share_url": "http:\/\/bangumi.bilibili.com\/anime\/25739\/",
"title": "\u5173\u4e8e\u6211\u8f6c\u751f\u53d8\u6210\u53f2\u83b1\u59c6\u8fd9\u6863\u4e8b",
"is_finish": 1,
"favorites": 5518829,
"newest_ep_index": 0,
"last_ep_index": 0,
"total_count": 27,
"cover": "http:\/\/i0.hdslb.com\/bfs\/bangumi\/a4c0e0ccc44fe3949a734f546cf5bb07da925bad.png",
"evaluate": "",
"brief": "\u53f2\u83b1\u59c6\u751f\u6d3b\uff0c\u5f00\u59cb\u4e86\u3002\n\u4e0a\u73ed\u65cf\u7684\u4e09\u4e0a\u609f\u5728\u9053\u8def\u4e0a\u88ab\u6b79\u5f92\u7ed9\u523a\u6740\u8eab\u4ea1\u540e\uff0c\u56de\u8fc7\u795e\u6765\u53d1\u73b0\u81ea\u5df1\u8f6c\u751f\u5230\u4e86\u5f02\u4e16\u754c\u3002\n\u4e0d..."
},
…………
]
}
}
```
### 查询用户追番（追剧）明细
> http://api.bilibili.com/x/space/bangumi/follow/list
@ -753,6 +852,583 @@ http://api.bilibili.com/x/space/bangumi/follow/list?vmid=14082&pn=1&ps=2&type=1
### 查询用户投稿相簿预览
> http://api.bilibili.com/x/space/album/index
*方式:GET*
所有类型的相簿
参数：
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------ | ------ | ------- |
| mid | url | 目标用户UID | 必要 | |
| ps | url | 获取的相簿量 | 非必要 | 默认为8 |
**json回复：**
| 字段 | 类型 | 内容 | 备注 |
| ------- | ------ | -------- | --------------------------- |
| code | num | 返回值 | 0：成功<br />-400：请求错误 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | 作用尚不明确 |
| data | arrary | 相簿列表 | |
`data`数组：
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | --------------- | ---- |
| 0 | obj | 相簿内容1 | |
| n | obj | 相簿内容（n+1） | |
| …… | obj | …… | …… |
`data`数组中的对象：
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ------ | ----------- | -------------- |
| count | num | 总计图片数 | |
| ctime | num | 发布时间 | 时间戳 |
| description | str | 简介 | |
| doc_id | num | 相册ID | 非动态ID！！！ |
| like | num | 点赞数 | |
| pictures | arrary | 图片内容 | |
| poster_uid | num | 上传用户UID | |
| title | str | 标题 | 动态内容无 |
| view | num | 浏览数 | |
`data`数组中的对象中的`pictures`数组：
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | --------------- | --------------------- |
| 0 | obj | 内容图片1 | |
| n | obj | 内容图片（n+1） | 项数取决于`count`的值 |
| …… | obj | …… | …… |
`pictures`数组中的对象：
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ---- | -------- | ----------- |
| img_height | num | 图片高度 | |
| img_size | num | 图片大小 | 单位为KByte |
| img_src | str | 图片url | |
| img_width | num | 图片宽度 | |
示例：
查询用户`UID=53456`的投稿相簿预览
http://api.bilibili.com/x/space/album/index?mid=53456&ps=2
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": [{
"doc_id": 60470424,
"poster_uid": 53456,
"title": "",
"description": "你醒啦！[tv_大佬]\n之前说到过的百万粉纪念的视频已经定时在了今天下午七点，欢迎来看呀！",
"pictures": [{
"img_src": "https://i0.hdslb.com/bfs/album/2840366e30bf7c0aba9da5adde1a771255a57bc7.jpg",
"img_width": 625,
"img_height": 134,
"img_size": 14
}],
"count": 1,
"ctime": 1583444859,
"view": 1677521,
"like": 29974
}, {
"doc_id": 58962388,
"poster_uid": 53456,
"title": "",
"description": "上次的那些写实儿童画发出来啦！可以打印下来辟邪[tv_大佬]",
"pictures": [{
"img_src": "https://i0.hdslb.com/bfs/album/8acaf7c7897cb858cccab36c33a5e875adfef177.jpg",
"img_width": 2172,
"img_height": 3258,
"img_size": 2831
}, {
"img_src": "https://i0.hdslb.com/bfs/album/1611b6b56d3d4328889a62b9f9bdc92e9d065532.jpg",
"img_width": 3456,
"img_height": 5184,
"img_size": 3024
}, {
"img_src": "https://i0.hdslb.com/bfs/album/f3a30a2ef5b39711af8b945d54d85ffd1e932b8a.jpg",
"img_width": 1200,
"img_height": 757,
"img_size": 313
}],
"count": 3,
"ctime": 1582881332,
"view": 1176646,
"like": 25734
}]
}
```
### 查询用户投稿相簿明细
> http://api.vc.bilibili.com/link_draw/v1/doc/doc_list
*方式:GET*
参数：
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| --------- | ---- | ----------- | ------ | ------------------------------------------------------------ |
| uid | url | 目标用户UID | 必要 | |
| page_num | url | 页码 | 非必要 | 默认为1 |
| page_size | url | 每页项数 | 非必要 | 默认为20 |
| biz | url | 查询类型 | 非必要 | 全部：all<br />绘画：draw<br />摄影：photo<br />日常：daily<br />默认为all |
**json回复：**
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------- |
| code | num | 返回值 | 0：成功 |
| msg | str | 错误信息 | 默认为success |
| message | str | 错误信息 | 默认为success |
| data | obj | 信息本体 | |
`data`对象：
| 字段 | 类型 | 内容 | 备注 |
| ----- | ------ | -------- | ---- |
| items | arrary | 相簿列表 | |
`items`数组：
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | --------------- | ---- |
| 0 | obj | 相簿内容1 | |
| n | obj | 相簿内容（n+1） | |
| …… | obj | …… | …… |
`items`数组中的对象：
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ------ | ----------- | -------------- |
| count | num | 总计图片数 | |
| ctime | num | 发布时间 | 时间戳 |
| description | str | 简介 | |
| doc_id | num | 相册ID | 非动态ID！！！ |
| like | num | 点赞数 | |
| pictures | arrary | 图片内容 | |
| poster_uid | num | 上传用户UID | |
| title | str | 标题 | 动态内容无 |
| view | num | 浏览数 | |
`items`数组中的对象中的`pictures`数组：
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | --------------- | --------------------- |
| 0 | obj | 内容图片1 | |
| n | obj | 内容图片（n+1） | 项数取决于`count`的值 |
| …… | obj | …… | …… |
`pictures`数组中的对象：
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ---- | -------- | ----------- |
| img_height | num | 图片高度 | |
| img_size | num | 图片大小 | 单位为KByte |
| img_src | str | 图片url | |
| img_width | num | 图片宽度 | |
示例：
查询用户`UID=53456`的投稿明细中的全部类型
http://api.vc.bilibili.com/link_draw/v1/doc/doc_list?uid=2&page_num=1&page_size=2&biz=all
```json
{
"code": 0,
"msg": "success",
"message": "success",
"data": {
"items": [{
"doc_id": 59015720,
"poster_uid": 2,
"title": "",
"description": "6影是真的无脑，2个宝石都护不住（设计师：这真是太酷了）",
"pictures": [{
"img_src": "http://i0.hdslb.com/bfs/album/8456f050ec8639c6e0cef36aba27bfdedc550590.jpg",
"img_width": 1824,
"img_height": 840,
"img_size": 1024
}],
"count": 1,
"ctime": 1582894607,
"view": 707073,
"like": 7055
}, {
"doc_id": 46853140,
"poster_uid": 2,
"title": "",
"description": "#年度报告# #新年Flag# https://www.bilibili.com/blackboard/timemachine2019.html\n决定了，这就是我的新年Flag！今年我一定要…",
"pictures": [{
"img_src": "http://i0.hdslb.com/bfs/album/5b3ae76f79d7cf2501afc3ca7c7da509dcf0e38a.jpg",
"img_width": 1125,
"img_height": 2184,
"img_size": 465
}, {
"img_src": "http://i0.hdslb.com/bfs/album/87789fe9644337a1f7e6a0655a32584705af8bda.jpg",
"img_width": 1125,
"img_height": 2184,
"img_size": 421
}, {
"img_src": "http://i0.hdslb.com/bfs/album/f752d7f3bb7952f6c0013b3f48ddcb07060b4721.jpg",
"img_width": 1125,
"img_height": 2184,
"img_size": 524
}, {
"img_src": "http://i0.hdslb.com/bfs/active/7a52a411bccb716c8e67fe70e6c330d5209346de.jpg",
"img_width": 1125,
"img_height": 2184,
"img_size": 534
}],
"count": 4,
"ctime": 1577966163,
"view": 833193,
"like": 5667
}]
}
}
```
### 查询用户频道列表
> http://api.bilibili.com/x/space/channel/list
*方式:GET*
参数：
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | ---- |
| mid | url | 目标用户UID | 必要 | |
**json回复：**
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------ |
| code | num | 返回值 | 0：成功 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | 作用尚不明确 |
| data | obj | 信息本体 | 无则为空 |
`data`对象：
| 字段 | 类型 | 内容 | 备注 |
| ----- | ------ | ---------- | ---- |
| count | num | 总计频道数 | |
| list | arrary | 频道列表 | |
`data`中的`list`数组：
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ----------- | --------------------- |
| 0 | obj | 频道1 | |
| n | obj | 频道（n+1） | 项数取决于`count`的值 |
| …… | obj | …… | …… |
`data`中的`list`数组中的对象：
| 字段 | 类型 | 内容 | 备注 |
| ----- | ---- | -------------- | -------- |
| cid | num | 频道ID | |
| count | num | 频道内含视频数 | |
| cover | str | 封面图片url | |
| intro | str | 简介 | 无则为空 |
| mid | num | 创建用户UID | |
| mtime | num | 创建时间 | 时间戳 |
| name | str | 标题 | |
示例：
查询用户`UID=53456`的频道列表
http://api.bilibili.com/x/space/channel/list?mid=53456
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"count": 6,
"list": [{
"cid": 100249,
"mid": 53456,
"name": "【实况】动物之森",
"intro": "",
"mtime": 1579898830,
"count": 2,
"cover": "http://i1.hdslb.com/bfs/archive/6a7ed9483c34e839dfca981b9e2b94cd4c4efa0a.jpg"
}, {
"cid": 79323,
"mid": 53456,
"name": "忆雨",
"intro": "忆雨出现过的视频",
"mtime": 1562535222,
"count": 7,
"cover": "http://i2.hdslb.com/bfs/archive/1783e4f03042b282495799adda1cb56270cea647.jpg"
}, {
"cid": 79322,
"mid": 53456,
"name": "大画家",
"intro": "",
"mtime": 1562535122,
"count": 6,
"cover": "http://i0.hdslb.com/bfs/archive/9c85a14e805c6c23cb7a42e1dbef97821bb68960.jpg"
}, {
"cid": 77758,
"mid": 53456,
"name": "灭火器",
"intro": "",
"mtime": 1561270856,
"count": 4,
"cover": "http://i2.hdslb.com/bfs/archive/0073208d086b4ebe9cdc540e7664aa74b483aeb6.jpg"
}, {
"cid": 75696,
"mid": 53456,
"name": "沃玛小剧场",
"intro": "",
"mtime": 1559129460,
"count": 5,
"cover": "http://i2.hdslb.com/bfs/archive/db2b20ecdb6ed013fc3780b0e741ea88d46b5b40.jpg"
}, {
"cid": 170,
"mid": 53456,
"name": "爆炸电台",
"intro": "闲聊的电台",
"mtime": 1503298893,
"count": 7,
"cover": "http://i2.hdslb.com/bfs/archive/73d77bc6bb0d44b239fd4f5a2682fe3144e81692.jpg"
}]
}
}
```
### 查询用户频道中的视频
> http://api.bilibili.com/x/space/channel/video
*方式:GET*
参数：
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | --------- |
| mid | url | 目标用户UID | 必要 | |
| cid | url | 目标频道ID | 必要 | |
| pn | url | 页码 | 非必要 | 默认为1 |
| ps | url | 每页项数 | 非必要 | 默认为100 |
**json回复：**
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------- |
| code | num | 返回值 | 0：成功<br />-400：请求错误<br />-404：无用户对应的频道 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | 作用尚不明确 |
| data | obj | 信息本体 | |
`data`对象：
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | -------- | ---- |
| list | obj | 频道信息 | |
| page | obj | 页面信息 | |
`data`中的`list`对象：
| 字段 | 类型 | 内容 | 备注 |
| -------- | ------ | -------------- | -------- |
| archives | arrary | 包含的视频列表 | |
| cid | num | 频道ID | |
| count | num | 频道内含视频数 | |
| cover | str | 封面图片url | |
| intro | str | 简介 | 无则为空 |
| mid | num | 创建用户UID | |
| mtime | num | 创建时间 | 时间戳 |
| name | str | 标题 | |
`list`中的`archives`数组：
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ----------- | --------------------- |
| 0 | obj | 视频1 | |
| n | obj | 视频（n+1） | 项数取决于`count`的值 |
| …… | obj | …… | …… |
`list`中的`archives`数组中的对象：
基本同「[视频详细信息](https://github.com/SocialSisterYi/bilibili-API-collect/blob/master/video/info.md#视频详细信息（avID/bvID互转）)」中的data对象
`data`中的`page`对象：
| 字段 | 类型 | 内容 | 备注 |
| ----- | ---- | ---------- | ---- |
| count | num | 总计视频数 | |
| num | num | 当前页码 | |
| size | num | 每页项数 | |
示例：
查询用户`UID=53456`的频道`170`中的视频
http://api.bilibili.com/x/space/channel/video?mid=53456&cid=170&ps=2&pn=1
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"list": {
"cid": 170,
"mid": 53456,
"name": "爆炸电台",
"intro": "闲聊的电台",
"mtime": 1503298893,
"count": 7,
"cover": "http://i2.hdslb.com/bfs/archive/73d77bc6bb0d44b239fd4f5a2682fe3144e81692.jpg",
"archives": [{
"aid": 87673204,
"videos": 1,
"tid": 21,
"tname": "日常",
"copyright": 1,
"pic": "http://i0.hdslb.com/bfs/archive/5387bdcbbe4d5551adbf0ee2e607e4b7d3d8f2f0.jpg",
"title": "【warma爆炸电台】迟来的自我介绍【第八期】",
"pubdate": 1581244539,
"ctime": 1581244540,
"desc": "时隔半年的新的一期爆炸电台来啦，这是我的一系列杂谈聊天电台，这次因为多了很多新关注的朋友们，所以来做个自我介绍吧！\n画师：Dr-H_喵_ 动画：K_Lacid\n结尾提到的壁纸稍后在动态发原图，动态壁纸在steam那个壁纸软件的创意工坊里搜warma能找到\n\n往期的电台：\n第一期：av6786024 \n第三期：av13619263\n第四期：av18862091\n第五期：av25092410\n第六期：av42492515\n第七期：av62910468",
"state": 0,
"attribute": 16512,
"duration": 2388,
"rights": {
"bp": 0,
"elec": 0,
"download": 0,
"movie": 0,
"pay": 0,
"hd5": 0,
"no_reprint": 1,
"autoplay": 1,
"ugc_pay": 0,
"is_cooperation": 0,
"ugc_pay_preview": 0,
"no_background": 0
},
"owner": {
"mid": 53456,
"name": "Warma",
"face": "http://i1.hdslb.com/bfs/face/c1bbee6d255f1e7fc434e9930f0f288c8b24293a.jpg"
},
"stat": {
"aid": 87673204,
"view": 1383542,
"danmaku": 88908,
"reply": 9237,
"favorite": 32929,
"coin": 68849,
"share": 5140,
"now_rank": 0,
"his_rank": 52,
"like": 116164,
"dislike": 0
},
"dynamic": "来做个自我介绍吧！ #warma##沃玛##爆炸电台#",
"cid": 149793525,
"dimension": {
"width": 1920,
"height": 1080,
"rotate": 0
},
"bvid": "BV1D7411t7Be",
"inter_video": false
}, {
"aid": 62910468,
"videos": 1,
"tid": 21,
"tname": "日常",
"copyright": 1,
"pic": "http://i2.hdslb.com/bfs/archive/4bd598f71a144d4505e259b143c0de0bf27968b2.jpg",
"title": "【warma爆炸电台】居然收到了几千条问题！【第七期】",
"pubdate": 1565345410,
"ctime": 1565338559,
"desc": "时隔半年的爆炸电台第七期终于来啦！在这一期里回答了很多问题，祝看得开心！此外，就在昨天，50万订阅了…真的谢谢大家！\n也欢迎来看往期的电台：\n第一期：av6786024 （2016年10月）\n第二期：av10373352（2017年5月）\n第三期：av13619263（2017年8月）\n第四期：av18862091（2018年1月）\n第五期：av25092410（2018年6月）\n第六期：av42492515（2019年2月）",
"state": 0,
"attribute": 16512,
"duration": 1987,
"mission_id": 11740,
"rights": {
"bp": 0,
"elec": 0,
"download": 0,
"movie": 0,
"pay": 0,
"hd5": 0,
"no_reprint": 1,
"autoplay": 1,
"ugc_pay": 0,
"is_cooperation": 0,
"ugc_pay_preview": 0,
"no_background": 0
},
"owner": {
"mid": 53456,
"name": "Warma",
"face": "http://i1.hdslb.com/bfs/face/c1bbee6d255f1e7fc434e9930f0f288c8b24293a.jpg"
},
"stat": {
"aid": 62910468,
"view": 455277,
"danmaku": 19383,
"reply": 2108,
"favorite": 10507,
"coin": 19422,
"share": 1208,
"now_rank": 0,
"his_rank": 0,
"like": 31515,
"dislike": 0
},
"dynamic": "爆炸电台 第七期 来啦！",
"cid": 109284065,
"dimension": {
"width": 1920,
"height": 1080,
"rotate": 0
},
"bvid": "BV1gt411K7Ga",
"inter_video": false
}]
},
"page": {
"count": 7,
"num": 1,
"size": 2
}
}
}
```
### 查看用户空间公告
> http://api.bilibili.com/x/space/notice

52
user/status_number.md
View File

@ -198,3 +198,55 @@ http://api.bilibili.com/x/space/navnum?mid=239202390
}
```
## 投稿相簿数
> http://api.vc.bilibili.com/link_draw/v1/doc/upload_count
*方式：GET*
参数：
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | ---- |
| uid | url | 目标用户UID | 必要 | |
**json回复：**
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------- |
| code | num | 返回值 | 0：成功 |
| msg | str | 错误信息 | 默认为success |
| message | str | 错误信息 | 默认为success |
| data | obj | 信息本体 | |
`data`对象：
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | ---------------------- | ------------------ |
| all_count | num | 相簿总数 | 总数为以下三者之和 |
| draw_count | num | 发布绘画数 | |
| photo_count | num | 发布摄影数 | |
| daily_count | num | 发布日常（图片动态）数 | |
示例：
查询用户`UID=53456`的投稿相簿数
http://api.vc.bilibili.com/link_draw/v1/doc/upload_count?uid=53456
```json
{
"code":0,
"msg":"success",
"message":"success",
"data":{
"all_count":92,
"draw_count":5,
"photo_count":0,
"daily_count":87
}
}
```

32
video/info.md
View File

@ -34,7 +34,7 @@
| tid | num | 分区ID | |
| tname | str | 子分区名称 | |
| copyright | num | 版权标志 | 1：自制<br />2：转载 |
| pic | str | 视频封面图片url | jpg gif |
| pic | str | 视频封面图片url | |
| title | str | 视频标题 | |
| pubdate | num | 视频上传时间 | 时间戳 |
| ctime | num | 视频审核通过时间 | 时间戳 |
@ -74,11 +74,11 @@
`data`中的`owner`对象：
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | -------- | ------- |
| mid | num | UP主UID | |
| name | str | UP主昵称 | |
| face | str | UP主头像 | jpg gif |
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | -------- | ---- |
| mid | num | UP主UID | |
| name | str | UP主昵称 | |
| face | str | UP主头像 | |
`data`中的`stat`对象：
@ -160,7 +160,7 @@
| mid | num | 字幕上传者UID | |
| name | str | 字幕上传者昵称 | |
| sex | str | 字幕上传者性别 | 男 女 保密 |
| face | str | 字幕上传者头像url | jpg gif |
| face | str | 字幕上传者头像url | |
| sign | str | 字幕上传者签名 | |
| rank | num | 10000 | 作用尚不明确 |
| birthday | num | 0 | 作用尚不明确 |
@ -177,15 +177,15 @@
数组`staff`中的对象：
| 字段 | 类型 | 内容 | 备注 |
| -------- | ---- | -------------- | ------- |
| mid | num | 成员UID | |
| title | str | 成员名称 | |
| name | str | 成员昵称 | |
| face | str | 成员头像url | jpg gif |
| vip | obj | 成员大会员状态 | |
| official | obj | 成员认证信息 | |
| follower | num | 成员粉丝数 | |
| 字段 | 类型 | 内容 | 备注 |
| -------- | ---- | -------------- | ---- |
| mid | num | 成员UID | |
| title | str | 成员名称 | |
| name | str | 成员昵称 | |
| face | str | 成员头像url | |
| vip | obj | 成员大会员状态 | |
| official | obj | 成员认证信息 | |
| follower | num | 成员粉丝数 | |
数组`staff`中的对象中的`vip`对象：

8
video/like_coin_fav.md
View File

@ -25,7 +25,7 @@
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功 <br />-400：请求错误<br />10003：不存在该稿件<br />-111：csrf校验失败<br />-101：账号未登录<br />65006：已赞过<br />65004：取消点赞失败 |
| code | num | 返回值 | 0：成功 <br />-101：账号未登录<br />-111：csrf校验失败<br />-400：请求错误<br />10003：不存在该稿件<br />65006：已赞过<br />65004：取消点赞失败 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | 作用尚不明确 |
@ -69,7 +69,7 @@ curl -b "SESSDATA=xxx" -d "aid=79677524&like=1&csrf=xxx" "http://api.bilibili.co
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功<br />-400：请求错误<br />10003：不存在该稿件<br />-111：csrf校验失败<br />-101：账号未登录<br />34002：不能给自己投币<br />34003：非法的投币数量<br />34005：超过投币上限<br />-104：硬币不足 |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-102：账号被封停<br />-104：硬币不足<br />-111：csrf校验失败<br />-400：请求错误<br />10003：不存在该稿件<br />34002：不能给自己投币<br />34003：非法的投币数量<br />34005：超过投币上限 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | 作用尚不明确 |
| data | obj | 信息本体 | |
@ -125,7 +125,7 @@ curl -b "SESSDATA=xxx" -d "aid=90671873&select_like=1&multiply=2&csrf=xxx" "http
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功<br />-400：请求错误<br />-403：访问权限不足<br />10003：不存在该稿件<br />-111：csrf校验失败<br />-101：账号未登录<br />72010017：参数错误<br />11201：已经收藏过了<br />11202：已经取消收藏了 |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-111：csrf校验失败<br />-400：请求错误<br />-403：访问权限不足<br />10003：不存在该稿件<br />11201：已经收藏过了<br />11202：已经取消收藏了<br />72010017：参数错误 |
| message | str | 错误信息 | 正确为success |
| data | obj | 信息本体 | |
@ -175,7 +175,7 @@ curl --referer "http://www.bilibili.com" -b "SESSDATA=xxx" -d "rid=90671873&type
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功<br />-400：请求错误<br />10003：不存在该稿件<br />-111：csrf校验失败<br />-101：账号未登录 |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-111：csrf校验失败<br />-400：请求错误<br />10003：不存在该稿件 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | 作用尚不明确 |
| data | obj | 信息本体 | |

4
video/snapshot.md
View File

@ -44,7 +44,7 @@
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ----------------- | -------------------------- |
| 0 | str | 图片拼版1 url | jpg |
| 0 | str | 图片拼版1 url | |
| n | str | 图片拼版(n+1) url | 第一张拼版占满时延续第二张 |
| …… | str | …… | …… |
@ -119,7 +119,7 @@ http://api.bilibili.com/x/player/videoshot?aid=26273789&index=1
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ----------------- | -------------------------- |
| 0 | str | 图片拼版1 url | jpg |
| 0 | str | 图片拼版1 url | |
| n | str | 图片拼版(n+1) url | 第一张拼版占满时延续第二张 |
| …… | str | …… | …… |