更新【readme】中的声明 修复【评论区】接口 添加大量【appkey】 添加【客户端信息】接口 添加【纪念账号】相关字段 添加【搜索关注】接口

This commit is contained in:
SocialSisterYi 2021-02-08 00:34:54 +08:00
parent c454b3a409
commit ff24146971
10 changed files with 600 additions and 274 deletions

View File

@ -30,6 +30,16 @@ PS所有http协议地址均可使用https文档中为了统一写作`http`
---
**声明**
1. 本项目遵守CC-BY-4.0协议如需转载请标明作者ID
2. **请勿滥用,本项目仅用于学习和测试!请勿滥用,本项目仅用于学习和测试!请勿滥用,本项目仅用于学习和测试!**
3. 由于使用本项目提供的接口、文档等造成的不良影响和后果与本人无关
4. 由于本项目的特殊性,可能随时停止开发或删档
5. 本项目为开源项目,不接受任何的催单和索取行为
---
计划整理分类&目录√代表已完成x代表正在施工...)二级目录正在建设中.....
- [API认证与鉴权APP与Cookie方式](other/API_auth.md)×
@ -169,8 +179,10 @@ PS所有http协议地址均可使用https文档中为了统一写作`http`
- 哔哩哔哩漫画
- 哔哩哔哩游戏
- 轻视频
- [终端网络查询](clientinfo)
- [基于ip的地理位置查询](clientinfo/ip.md)√
- [终端信息查询](clientinfo/client_info.md)√
- [其他](other)
- [基于ip的地理位置查询](other/ip.md)√
- [获取当前时间戳](other/time_stamp.md)√
- [web端组件](web_widget)
- [分区当日投稿数](web_widget/zone_upload.md)√
@ -182,14 +194,6 @@ PS所有http协议地址均可使用https文档中为了统一写作`http`
B站专栏同步推出[《B站api研究记》](https://www.bilibili.com/read/readlist/rl207146)系列(更新状态:咕咕......~~欢迎关注~~
**注意:请勿滥用,仅用于学习和测试!**
**注意:请勿滥用,仅用于学习和测试!**
**注意:请勿滥用,仅用于学习和测试!**
(重要的话说三遍,本人不承担任何责任)
**--Project_by [社会易姐QwQ](https://space.bilibili.com/293793435)**
# 相关协议基础
@ -218,7 +222,7 @@ B站空间https://space.bilibili.com/293793435
~~请可爱的易姐喝杯奶茶~~
<img src="sponsorQR.jpg" width="500" height="500">
<img src="imgs/sponsorQR.jpg" width="300" height="300">
# 相关项目:
@ -255,4 +259,3 @@ B站空间https://space.bilibili.com/293793435
## 其他:
- [kuresaru/geetest-validator](https://github.com/kuresaru/geetest-validator):geetest调试器
- [SocialSisterYi/bv2av_convert](https://github.com/SocialSisterYi/bv2av_convert):C语言算法av号与bv号互转器

95
clientinfo/client_info.md Normal file
View File

@ -0,0 +1,95 @@
# 终端信息查询
- [终端信息查询](#终端信息查询)
---
## 终端信息查询
> http://api.bilibili.com/client_info
*请求方式:任意*
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------- |
| code | num | 返回值 | 0成功 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data`对象:
| 字段 | 类型 | 内容 | 备注 |
| -------- | -------- | ------------------- | ------------ |
| country | str | 国家/地区名 | |
| ip | str | 公网IP地址 | |
| province | str | 省/州 | 非必须存在项 |
| city | str | 城市 | 非必须存在项 |
| district | district | | |
| isp | str | 运营商名 | |
| dns | str | dns服务器ip | |
| dns_isp | str | dns服务器ip运营商名 | |
| headers | obj | 头部字段 | |
`data`中的`headers`对象:
| 字段 | 类型 | 内容 | 备注 |
| --------------------------------- | ---- | ----------------- | ---- |
| HTTP_ACCEPT_ENCODING | str | | |
| HTTP_X_CACHE_SERVER | str | CDN服务器名 | |
| HTTP_X_CACHE_SERVER_ADDR | str | CDN服务器ip | |
| HTTP_X_BACKEND_BILI_REAL_IP | str | 真实服务器ip | |
| HTTP_X_BACKEND_BILI_REAL_IPPORT | str | 真实服务器端口 | |
| HTTP_X_BACKEND_BILI_REAL_IP_CHAIN | str | 真实服务器ip+端口 | |
| HTTP_X_SCHEME | str | 访问协议 | |
| HTTP_HOST | str | 访问域名 | |
| HTTP_USER_AGENT | str | 客户端UA | |
| HTTP_ACCEPT | str | | |
| HTTP_CACHE_CONTROL | str | | |
**示例:**
```shell
curl 'http://api.bilibili.com/client_info'
```
<details>
<summary>查看响应示例:</summary>
```json
{
"code": 0,
"message": "ok",
"data": {
"country": "中国",
"ip": "36.40.120.140",
"province": "陕西",
"city": "渭南",
"district": null,
"isp": "电信",
"dns": null,
"dns_isp": null,
"headers": {
"HTTP_ACCEPT_ENCODING": "gzip",
"HTTP_X_CACHE_SERVER": "ks-bj-webcdn-07",
"HTTP_X_CACHE_SERVER_ADDR": "10.33.2.170",
"HTTP_X_BACKEND_BILI_REAL_IP": "36.40.120.140",
"HTTP_X_BACKEND_BILI_REAL_IPPORT": "22058",
"HTTP_X_BACKEND_BILI_REAL_IP_CHAIN": "36.40.120.140:22058",
"HTTP_X_SCHEME": "https",
"HTTP_HOST": "api.bilibili.com",
"HTTP_USER_AGENT": "PostmanRuntime/7.26.8",
"HTTP_ACCEPT": "*/*",
"HTTP_CACHE_CONTROL": "no-cache"
}
}
}
```
</details>

View File

@ -45,19 +45,19 @@
| 字段 | 类型 | 内容 | 备注 |
| ------------ | -------------------------------- | -------- | ---------------- |
| page | obj | 页信息 | |
| config | obj | 属性信息 | |
| replies | 禁用时null<br />正常时array | 评论列表 | |
| hots | 禁用时null<br />正常时array | 热评列表 | |
| config | obj | 评论区显示控制 | |
| replies | 禁用时null<br />正常时array | 评论列表 | |
| hots | 禁用时null<br />正常时array | 热评列表 | |
| upper | obj | 置顶评论 | |
| top | null | - | **作用尚不明确** |
| notice | 无效时null<br />有效时obj | 评论区公告信息 | |
| vote | num | 0 | **作用尚不明确** |
| blacklist | num | 0 | **作用尚不明确** |
| assist | num | 0 | **作用尚不明确** |
| mode | num | 3 | **作用尚不明确** |
| support_mode | array | | **作用尚不明确** |
| folder | obj | ??? | **作用尚不明确** |
| lottery_card | null | - | **作用尚不明确** |
| mode | num | 评论区类型id | |
| support_mode | array | 评论区支持的类型id | |
| folder | obj | 折叠相关信息 | |
| lottery_card | null | - | **作用尚不明确** |
| show_bvid | bool | true | **作用尚不明确** |
| control | obj | 评论区输入属性 | |
@ -72,15 +72,15 @@
`data`中的`config`对象:
| 字段 | 类型 | 内容 | 备注 |
| ------------ | ---- | ----- | ---------------- |
| showadmin | num | 1 | **作用尚不明确** |
| showentry | num | 1 | **作用尚不明确** |
| showfloor | num | 0 | **作用尚不明确** |
| showtopic | num | 1 | **作用尚不明确** |
| show_up_flag | bool | true | **作用尚不明确** |
| read_only | bool | false | **作用尚不明确** |
| show_del_log | bool | false | **作用尚不明确** |
| 字段 | 类型 | 内容 | 备注 |
| ------------ | ---- | ------------------------ | ---- |
| showadmin | num | 是否显示管理置顶 | |
| showentry | num | | |
| showfloor | num | 是否显示楼层号 | |
| showtopic | num | 是否显示话题 | |
| show_up_flag | bool | 是否显示“UP觉得很赞”标志 | |
| read_only | bool | 是否只读评论区 | |
| show_del_log | bool | 是否显示删除记录 | |
`data`中的`replies`数组:
@ -100,11 +100,11 @@
`data`中的`upper`对象:
| 字段 | 类型 | 内容 | 备注 |
| ---- | ----------------------------- | -------- | -------------------------------------- |
| mid | num | UP主UID | |
| top | 有效时obj<br />无效时null | 置顶条目 | [对象定义见表](readme.md#评论条目对象) |
| vote | null | - | |
| 字段 | 类型 | 内容 | 备注 |
| ---- | ----------------------------- | ---------- | -------------------------------------- |
| mid | num | UP主UID | |
| top | 有效时obj<br />无效时null | 置顶条目 | [对象定义见表](readme.md#评论条目对象) |
| vote | 有效时obj<br />无效时null | 投票评论? | |
`data`中的`notice`对象:
@ -125,11 +125,11 @@
`data`中的`folder`对象:
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ---- | ------ | ---------------- |
| has_folded | bool | false | **作用尚不明确** |
| is_folded | bool | false | **作用尚不明确** |
| rule | str | | **作用尚不明确** |
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ---- | ---------------------- | ---------------- |
| has_folded | bool | 评论区是否存在折叠评论 | |
| is_folded | bool | false | **作用尚不明确** |
| rule | str | 相关规则页面url | |
`data`中的`control`对象:
@ -2362,21 +2362,21 @@ curl -G 'http://api.bilibili.com/x/v2/reply' \
| 字段 | 类型 | 内容 | 备注 |
| ------------ | -------------------------------- | -------- | ---------------- |
| cursor | obj | 页信息 | |
| hots | 禁用时null<br />正常时array | 热评列表 | |
| cursor | obj | 游标信息 | |
| hots | 禁用时null<br />正常时array | 热评列表 | |
| notice | 无效时null<br />有效时obj | 评论区公告信息 | |
| replies | 禁用时null<br />正常时array | 评论列表 | |
| replies | 禁用时null<br />正常时array | 评论列表 | |
| top | obj | 置顶评论 | |
| lottery_card | null | - | **作用尚不明确** |
| folder | obj | ??? | **作用尚不明确** |
| lottery_card | null | 抽奖评论 | |
| folder | obj | 评论折叠信息 | |
| assist | num | 0 | **作用尚不明确** |
| blacklist | num | 0 | **作用尚不明确** |
| vote | num | 0 | **作用尚不明确** |
| lottery | num | 0 | **作用尚不明确** |
| config | obj | 属性信息 | |
| config | obj | 评论区显示控制 | |
| upper | obj | UP主信息 | |
| mode | num | 3 | **作用尚不明确** |
| support_mode | array | | **作用尚不明确** |
| mode | num | 评论区类型id | |
| support_mode | array | 评论区支持的类型id | |
| show_bvid | bool | true | **作用尚不明确** |
| control | obj | 评论区输入属性 | |
@ -2404,23 +2404,23 @@ curl -G 'http://api.bilibili.com/x/v2/reply' \
`data`中的`top`对象:
| 字段 | 类型 | 内容 | 备注 |
| ----- | ----------------------------- | -------- | -------------------------------------- |
| admin | null | - | |
| upper | 有效时obj<br />无效时null | 置顶条目 | [对象定义见表](readme.md#评论条目对象) |
| vote | null | - | |
| 字段 | 类型 | 内容 | 备注 |
| ----- | ----------------------------- | -------------- | -------------------------------------- |
| admin | 有效时obj<br />无效时null | 管理员置顶条目 | [对象定义见表](readme.md#评论条目对象) |
| upper | 有效时obj<br />无效时null | UP主置顶条目 | [对象定义见表](readme.md#评论条目对象) |
| vote | 有效时obj<br />无效时null | 投票置顶条目 | [对象定义见表](readme.md#评论条目对象) |
`data`中的`config`对象:
| 字段 | 类型 | 内容 | 备注 |
| ------------ | ---- | ----- | ---------------- |
| showadmin | num | 1 | **作用尚不明确** |
| showentry | num | 1 | **作用尚不明确** |
| showfloor | num | 0 | **作用尚不明确** |
| showtopic | num | 1 | **作用尚不明确** |
| show_up_flag | bool | true | **作用尚不明确** |
| read_only | bool | false | **作用尚不明确** |
| show_del_log | bool | false | **作用尚不明确** |
| 字段 | 类型 | 内容 | 备注 |
| ------------ | ---- | ------------------------ | ---- |
| showadmin | num | 是否显示管理置顶 | |
| showentry | num | | |
| showfloor | num | 是否显示楼层号 | |
| showtopic | num | 是否显示话题 | |
| show_up_flag | bool | 是否显示“UP觉得很赞”标志 | |
| read_only | bool | 是否只读评论区 | |
| show_del_log | bool | 是否显示删除记录 | |
`data`中的`replies`数组:
@ -4744,7 +4744,7 @@ curl -G 'http://api.bilibili.com/x/v2/reply/main' \
| 字段 | 类型 | 内容 | 备注 |
| ------------ | -------------------------------- | -------- | ---------------- |
| config | obj | 属性信息 | |
| config | obj | 评论区显示控制 | |
| control | obj | 评论区输入属性 | |
| page | obj | 页信息 | |
| replies | array | 二级评论列表 | |
@ -4763,15 +4763,15 @@ curl -G 'http://api.bilibili.com/x/v2/reply/main' \
`data`中的`config`对象:
| 字段 | 类型 | 内容 | 备注 |
| ------------ | ---- | ----- | ---------------- |
| showadmin | num | 0 | **作用尚不明确** |
| showentry | num | 0 | **作用尚不明确** |
| showfloor | num | 0 | **作用尚不明确** |
| showtopic | num | 0 | **作用尚不明确** |
| show_up_flag | bool | false | **作用尚不明确** |
| read_only | bool | false | **作用尚不明确** |
| show_del_log | bool | false | **作用尚不明确** |
| 字段 | 类型 | 内容 | 备注 |
| ------------ | ---- | ------------------------ | ---- |
| showadmin | num | 是否显示管理置顶 | |
| showentry | num | | |
| showfloor | num | 是否显示楼层号 | |
| showtopic | num | 是否显示话题 | |
| show_up_flag | bool | 是否显示“UP觉得很赞”标志 | |
| read_only | bool | 是否只读评论区 | |
| show_del_log | bool | 是否显示删除记录 | |
`data`中的`replies`数组:
@ -5487,7 +5487,7 @@ curl -G 'http://api.bilibili.com/x/v2/reply/reply' \
| blacklist | num | 0 | **作用尚不明确** |
| vote | num | 0 | **作用尚不明确** |
| lottery | num | 0 | **作用尚不明确** |
| config | obj | 属性信息 | |
| config | obj | 评论区显示控制 | |
| upper | obj | UP主UID | |
| show_bvid | bool | true | **作用尚不明确** |
| control | obj | 评论区输入属性 | |
@ -5505,15 +5505,15 @@ curl -G 'http://api.bilibili.com/x/v2/reply/reply' \
`data`中的`config`对象:
| 字段 | 类型 | 内容 | 备注 |
| ------------ | ---- | ----- | ---------------- |
| showadmin | num | 1 | **作用尚不明确** |
| showentry | num | 1 | **作用尚不明确** |
| showfloor | num | 0 | **作用尚不明确** |
| showtopic | num | 1 | **作用尚不明确** |
| show_up_flag | bool | true | **作用尚不明确** |
| read_only | bool | false | **作用尚不明确** |
| show_del_log | bool | false | **作用尚不明确** |
| 字段 | 类型 | 内容 | 备注 |
| ------------ | ---- | ------------------------ | ---- |
| showadmin | num | 是否显示管理置顶 | |
| showentry | num | | |
| showfloor | num | 是否显示楼层号 | |
| showtopic | num | 是否显示话题 | |
| show_up_flag | bool | 是否显示“UP觉得很赞”标志 | |
| read_only | bool | 是否只读评论区 | |
| show_del_log | bool | 是否显示删除记录 | |
`data`中的`upper`对象:
@ -6246,7 +6246,7 @@ curl -G 'http://api.bilibili.com/x/v2/reply/detail' \
| blacklist | num | 0 | **作用尚不明确** |
| vote | num | 0 | **作用尚不明确** |
| lottery | num | 0 | **作用尚不明确** |
| config | obj | 属性信息 | |
| config | obj | 评论区显示控制 | |
| upper | obj | UP主UID | |
| show_bvid | bool | true | **作用尚不明确** |
| control | obj | 评论区输入属性 | |
@ -6276,15 +6276,15 @@ curl -G 'http://api.bilibili.com/x/v2/reply/detail' \
`data`中的`config`对象:
| 字段 | 类型 | 内容 | 备注 |
| ------------ | ---- | ----- | ---------------- |
| showadmin | num | 1 | **作用尚不明确** |
| showentry | num | 1 | **作用尚不明确** |
| showfloor | num | 0 | **作用尚不明确** |
| showtopic | num | 1 | **作用尚不明确** |
| show_up_flag | bool | true | **作用尚不明确** |
| read_only | bool | false | **作用尚不明确** |
| show_del_log | bool | false | **作用尚不明确** |
| 字段 | 类型 | 内容 | 备注 |
| ------------ | ---- | ------------------------ | ---- |
| showadmin | num | 是否显示管理置顶 | |
| showentry | num | | |
| showfloor | num | 是否显示楼层号 | |
| showtopic | num | 是否显示话题 | |
| show_up_flag | bool | 是否显示“UP觉得很赞”标志 | |
| read_only | bool | 是否只读评论区 | |
| show_del_log | bool | 是否显示删除记录 | |
`data`中的`upper`对象:

View File

@ -2,7 +2,11 @@
<img src="/imgs/comment.svg" width="100" height="100"/>
评论区接口分为**查询**与**操作**两大类
评论系统为全站通用且APP与web端接口共用以type标明对象类型以oid指向响应的对象id
---
**继续查看:**
- [查询类](list.md)
- [操作类](action.md)
@ -41,24 +45,24 @@
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ------------------------------- | ---------------- | ------------------------------------------------------------ |
| rpid | num | 评论rpID | |
| oid | num | 目标评论区rpID | |
| oid | num | 评论区对象id | |
| type | num | 评论区类型代码 | **类型代码见上表** |
| mid | num | 评论发送者UID | |
| mid | num | 发送者UID | |
| root | num | 根评论rpID | 若为一级评论则为0<br />大于一级评论则为根评论ID |
| parent | num | 回复父评论rpID | 若为一级评论则为0<br />若为二级评论则为根评论rpID<br />大于二级评论为上一级评论rpID |
| dialog | num | 回复对方rpID | 若为一级评论则为0<br />若为二级评论则为该评论rpID<br />大于二级评论为上一级评论rpID |
| count | num | 评论回复条数 | |
| rcount | num | 评论回复条数 | |
| floor | num | 评论楼层号 | **重要:若不支持楼层则无此项** |
| count | num | 二级评论条数 | |
| rcount | num | 回复评论条数 | |
| floor | num | 评论楼层号 | **注:若不支持楼层则无此项** |
| state | num | 0 | **作用尚不明确** |
| fansgrade | num | 是否具有粉丝标签 | 0<br />1有 |
| attr | num | | **作用尚不明确** |
| attr | num | 某属性位? | **作用尚不明确** |
| ctime | num | 评论发送时间 | 时间戳 |
| rpid_str | str | 评论rpID | 字串格式 |
| root_str | str | 根评论rpID | 字串格式 |
| parent_str | str | 回复父评论rpID | 字串格式 |
| like | num | 评论获赞数 | |
| action | num | 当前用户操作状态 | 需要登录(SESSDATA) <br />否则恒为0<br />0<br />1已点赞<br />2已点踩 |
| action | num | 当前用户操作状态 | 需要登录(Cookie或APP) <br />否则恒为0<br />0<br />1已点赞<br />2已点踩 |
| member | obj | 评论发送者信息 | |
| content | obj | 评论信息 | |
| replies | 无效时null<br />有效时array | 评论回复条目预览 | **仅嵌套一层**<br />否则为null |
@ -84,9 +88,10 @@
| official_verify | obj | 发送者认证信息 | |
| vip | obj | 发送者会员信息 | |
| fans_detail | 无效时null<br />有效时obj | 发送者粉丝标签 | |
| following | num | 是否关注该用户 | 需要登录(SESSDATA) <br />否则恒为0<br />0未关注<br />1已关注 |
| is_followed | num | 是否被该用户关注 | 需要登录(SESSDATA) <br />否则恒为0<br />0未关注<br />1已关注 |
| following | num | 是否关注该用户 | 需要登录(Cookie或APP) <br />否则恒为0<br />0未关注<br />1已关注 |
| is_followed | num | 是否被该用户关注 | 需要登录(Cookie或APP) <br />否则恒为0<br />0未关注<br />1已关注 |
| user_sailing | obj | 发送者评论条目装扮信息 | |
| is_contractor | bool | 是否为合作用户? | |
`member`中的`level_info`对象:
@ -120,31 +125,31 @@
`member`中的`official_verify`对象:
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | -------- | ------------------- |
| type | num | 是否认证 | -1<br />0认证 |
| desc | str | 认证信息 | 无为空 |
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | -------- | ---------------------------------------- |
| type | num | 是否认证 | -1<br />0个人认证<br />1机构认证 |
| desc | str | 认证信息 | 无为空 |
`member`中的`vip`对象:
| 字段 | 类型 | 内容 | 备注 |
| ------------- | ---- | -------------- | ----------------------------------- |
| vipType | num | 大会员类型 | 0<br />1月会员<br />2年会员 |
| vipDueDate | num | 大会员到期时间 | 毫秒 时间戳 |
| dueRemark | str | 空 | **作用尚不明确** |
| accessStatus | num | 0 | **作用尚不明确** |
| vipStatus | num | 大会员状态 | 0<br />1有 |
| vipStatusWarn | str | 空 | **作用尚不明确** |
| theme_type | num | 0 | **作用尚不明确** |
| label | obj | | |
| 字段 | 类型 | 内容 | 备注 |
| ------------- | ---- | -------------- | --------------------------------------- |
| vipType | num | 大会员类型 | 0<br />1月会员<br />2以上会员 |
| vipDueDate | num | 大会员到期时间 | 毫秒 时间戳 |
| dueRemark | str | 空 | **作用尚不明确** |
| accessStatus | num | 0 | **作用尚不明确** |
| vipStatus | num | 大会员状态 | 0<br />1 |
| vipStatusWarn | str | 空 | **作用尚不明确** |
| theme_type | num | 会员样式id | |
| label | obj | 会员铭牌样式 | |
`vip`中的`label`对象:
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | ------------ | ---------------- |
| path | str | 空 | **作用尚不明确** |
| text | str | 会员类型信息 | |
| label_theme | str | 会员类型 | |
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | ------------ | ------------------------------------------------------------ |
| path | str | 空 | **作用尚不明确** |
| text | str | 会员类型文案 | |
| label_theme | str | 会员类型 | vip大会员<br />annual_vip年度大会员<br />ten_annual_vip十年大会员<br />hundred_annual_vip百年大会员 |
`member`中的`fans_detail`对象:
@ -164,7 +169,7 @@
| 字段 | 类型 | 内容 | 备注 |
| ----------------- | ----------------------------- | ------------ | ---------------- |
| pendant | 无效时null<br />有效时obj | 头像框信息 | |
| cardbg | 无效时null<br />有效时obj | 评论条目装扮 | |
| cardbg | 无效时null<br />有效时obj | 评论卡片装扮 | |
| cardbg_with_focus | null | - | **作用尚不明确** |
`user_sailing`中的`pendant`对象:
@ -200,15 +205,15 @@
`评论条目`中的`content`对象:
| 字段 | 类型 | 内容 | 备注 |
| -------- | ----- | -------------------- | ------------------------------------------------------------ |
| message | str | 评论内容 | **重要** |
| plat | num | 评论发送平台 | 1web端<br />2安卓客户端<br />3ios客户端<br />4wp客户端 |
| device | str | 评论发送平台设备 | |
| members | array | 评论中at到的用户信息 | |
| emote | obj | 表情转义符信息 | 评论内容无表情则无此项 |
| jump_url | obj | 空 | **作用尚不明确** |
| max_line | num | 6 | **作用尚不明确** |
| 字段 | 类型 | 内容 | 备注 |
| -------- | ----- | ------------------ | ------------------------------------------------------------ |
| message | str | 评论内容 | **重要** |
| plat | num | 评论发送 | 1web端<br />2安卓客户端<br />3ios客户端<br />4wp客户端 |
| device | str | 评论发送平台设备 | |
| members | array | at到的用户信息 | |
| emote | obj | 需要渲染的表情转义 | 评论内容无表情则无此项 |
| jump_url | obj | 需要高亮的超链转义 | |
| max_line | num | 6 | 收起最大行数 |
`content`中的`members`数组:
@ -246,21 +251,40 @@
| size | num | 表情尺寸信息 | 1<br />2大 |
| alias | str | 简写名 | 无则无此项 |
`content`中的`jump_url`对象:
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ---- | ------------- | -------- |
| {超链转义} | obj | 超链转义信息1 | |
| …… | obj | 超链转义信息n | 向下扩展 |
`jump_url`中的`{超链转义}`对象:
| 字段 | 类型 | 内容 | 备注 |
| -------------- | ---- | ------- | ---- |
| title | str | 标题 | |
| state | num | 图标url | |
| prefixIcon | str | | |
| appUrlSchema | str | | |
| appName | str | | |
| appPackageName | str | | |
| clickReport | str | 上报id | |
`评论条目`中的`replies`数组:
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | --------- | ------------------------------------------------------------ |
| 0 | obj | 回复条目1 | **为本对象的递归嵌套**<br />**仅嵌套一层**<br />按照热度顺序排列 |
| 0 | obj | 回复条目1 | **为本对象的递归嵌套**<br />**仅嵌套一层**<br />按照热度顺序排列 |
| 1 | obj | 回复条目2 | |
| 2 | obj | 回复条目3 | 最后一项 |
`评论条目`中的`folder`对象:
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ---- | ------ | ---------------- |
| has_folded | bool | false | **作用尚不明确** |
| is_folded | bool | false | **作用尚不明确** |
| rule | str | | **作用尚不明确** |
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ---- | ---------------------- | ---- |
| has_folded | bool | 是否有被折叠的二级评论 | |
| is_folded | bool | 评论是否被折叠 | |
| rule | str | 相关规则页面uel | |
`评论条目`中的`up_action`对象:

View File

Before

Width:  |  Height:  |  Size: 690 KiB

After

Width:  |  Height:  |  Size: 690 KiB

View File

@ -40,14 +40,19 @@ Token有效期为1月更改密码或过期失效
| appkey | appsecsign盐值 | 平台 | 应用 | 备注 |
| ---------------- | -------------------------------- | ---- | -------- | -------- |
| 07da50c9a0bf829f | 75d35aa5c06fb46e40059a6a5bf671a6 | 安卓 | 概念版 | |
| 07da50c9a0bf829f | 25bdede4e1581c836cab73a48790ca6e | 安卓 | 概念版 | |
| 1d8b6e7d45233436 | 560c52ccd288fed045859ed18bffd973 | 安卓 | 客户端 | 一般用途 |
| 178cf125136ca8ea | 34381a26236dd1171185c0beb042e1c6 | 安卓 | 概念版 | |
| 37207f2beaebf8d7 | e988e794d4d4b6dd43bc0e89d6e90c43 | 安卓 | biliLink | |
| 4409e2ce8ffd12b8 | 59b43e04ad6965f34319062b478f83dd | TV | 客户端 | |
| 57263273bc6b67f6 | a0488e488d1567960d3a765e8d129f90 | 安卓 | 客户端 | |
| 5dce947fe22167f9 | | 安卓 | 必剪 | |
| 7d336ec01856996b | a1ce6983bc89e20a36c37f40c4f1a0dd | 安卓 | 概念版 | |
| 85eb6835b0a1034e | 2ad42749773c441109bdc0191257a664 | | | |
| 8e16697a1b4f8121 | f5dd03b752426f2e623d7badb28d190a | 安卓 | 国际版 | |
| aae92bc66f3edfab | af125a0d5279fd576c1b4418a3e8276d | PC | 投稿工具 | |
| bb3101000e232e27 | 36efcfed79309338ced0380abd824ac1 | | | |
| ae57252b0c09105d | c75875c596a69eb55bd119e74b07cfe3 | 安卓 | 国际版 | |
| bb3101000e232e27 | 36efcfed79309338ced0380abd824ac1 | 安卓 | 国际版 | |
| bca7e84c2d947ac6 | 60698ba2f68e01ce44738920a0ffe768 | 安卓 | 客户端 | 登录专用 |
| cc578d267072c94d | | 安卓 | 轻视频 | |
| cc8617fd6961e070 | | 安卓 | 漫画 | |

View File

@ -57,7 +57,7 @@
| is_followed | bool | 是否关注此用户 | true已关注<br />false未关注<br />需要登录(Cookie) <br />未登录恒为false |
| top_photo | str | 主页头图链接 | |
| theme | obj | 空 | **作用尚不明确** |
| sys_notice | obj | 系统通知 | 无内容则为空 |
| sys_notice | obj | 系统通知 | 无内容则为空对象<br />主要用于展示如用户争议、纪念账号等等 |
| live_room | obj | 直播间信息 | |
`data`中的`official`对象:
@ -82,11 +82,11 @@
`vip`中的`label`对象:
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | -------- | ------------------------------------------------------------ |
| path | str | 空 | 作用尚不明确 |
| text | str | 会员名称 | |
| label_theme | str | 会员标签 | vip大会员<br />annual_vip年度大会员<br />ten_annual_vip十年大会员<br />hundred_annual_vip百年大会员 |
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | ------------ | ------------------------------------------------------------ |
| path | str | 空 | 作用尚不明确 |
| text | str | 会员类型文案 | |
| label_theme | str | 会员标签 | vip大会员<br />annual_vip年度大会员<br />ten_annual_vip十年大会员<br />hundred_annual_vip百年大会员 |
`data`中的`pendant`对象:
@ -110,11 +110,15 @@
`data`中的`sys_notice`对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | --------------- | -------------------- |
| id | num | 系统提示类型ID | **详细说明有待补充** |
| content | str | 提示信息 | |
| url | str | 提示信息链接url | |
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | --------------- | ------------------------------ |
| id | num | 系统提示类型ID | 20纪念账号 |
| content | str | 提示文案 | |
| url | str | 提示信息页面url | |
| notice_type | num | | 作用尚不明确<br />此字段非必须 |
| icon | str | 提示图标url | 此字段非必须 |
| text_color | str | 提示文字颜色 | 此字段非必须<br />颜色码 |
| bg_color | str | 提示背景颜色 | 此字段非必须<br />颜色码 |
`data`中的`live_room`对象:

View File

@ -2,6 +2,7 @@
- [查询用户粉丝明细](#查询用户粉丝明细)
- [查询用户关注明细](#查询用户关注明细)
- [搜索关注明细](#搜索关注明细)
- [查询共同关注明细](#查询共同关注明细)
- [查询悄悄关注明细](#查询悄悄关注明细)
- [查询黑名单明细](#查询黑名单明细)
@ -372,6 +373,151 @@ curl -G 'http://api.bilibili.com/x/relation/ollowings' \
</details>
## 搜索关注明细
<img src="/imgs/relation.svg" width="100" height="100" />
> http://api.bilibili.com/x/relation/followings/search
*请求方式GET*
认证方式CookieSESSDATA或APP
**url参数**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------ | ----------- | -------- |
| access_key | str | APP登录Token | APP方式必要 | |
| vmid | str | 目标用户UID | 必要 | |
| name | str | 搜索关键词 | 必要 | |
| ps | num | 每页项数 | 非必要 | 默认为50 |
| pn | num | 页码 | 非必要 | 默认为1 |
data 对象:
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ----- | -------- | ------------ |
| list | array | 明细列表 | |
| re_version | num | | 作用尚不明确 |
| total | num | 关注总数 | |
`data`中的`list`数组:
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | --------------- | ---------------- |
| 0 | obj | 共同关注1 | |
| n | obj | 共同关注n+1 | 按照关注顺序排列 |
| …… | obj | …… | …… |
数组`list`中的对象:
| 字段 | 类型 | 内容 | 备注 |
| --------------- | ------------------------------------------- | ------------ | --------------------------------------- |
| mid | num | 用户UID | |
| attribute | num | 关注属性 | 0未关注<br />2已关注<br />6已互粉 |
| mtime | num | 关注对方时间 | 时间戳<br />互关后刷新 |
| tag | 默认分组null<br />存在至少一个分组array | 分组ID | |
| special | num | 特别关注标志 | 0<br />1是 |
| uname | str | 用户昵称 | |
| face | str | 用户头像url | |
| sign | str | 用户签名 | |
| official_verify | obj | 认证信息 | |
| vip | obj | 会员信息 | |
数组`list`中的对象中的`tag`数组:
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ----------------------- | ---- |
| 0 | num | 位于分组1的分组ID | |
| n | num | 位于分组n+1的分组ID | |
| …… | num | …… | …… |
`list`中的对象中的`official_verify`对象:
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ------------ | ------------------- |
| type | num | 用户认证类型 | -1<br />1认证 |
| desc | str | 用户认证信息 | 无为空 |
`list`中的对象中的`vip`对象:
| 字段 | 类型 | 内容 | 备注 |
| ------------- | ---- | ------------ | ----------------------------------------------- |
| vipType | num | 会员类型 | 0<br />1月度大会员<br />2年度以上大会员 |
| vipDueDate | num | 会员到期时间 | 时间戳 毫秒 |
| dueRemark | str | 空 | 作用尚不明确 |
| accessStatus | num | 0 | 作用尚不明确 |
| vipStatus | num | 大会员状态 | 0<br />1有 |
| vipStatusWarn | str | 空 | 作用尚不明确 |
| themeType | num | 0 | 作用尚不明确 |
| label | obj | | 作用尚不明确 |
`vip`中的`label`对象:
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ------------ |
| path | str | 空 | 作用尚不明确 |
**示例:**
搜索我的关注列表中关键词`warma`
```shell
curl -G 'http://api.bilibili.com/x/relation/followings/search' \
--data-urlencode 'vmid=293793435' \
--data-urlencode 'name=warma' \
--data-urlencode 'ps=2' \
--data-urlencode 'pn=1' \
-b 'SESSDATA=xxx'
```
<details>
<summary>查看响应示例:</summary>
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"list": [
{
"mid": 53456,
"attribute": 2,
"mtime": 1586415053,
"tag": [
-10
],
"special": 1,
"uname": "Warma",
"face": "http://i2.hdslb.com/bfs/face/c1bbee6d255f1e7fc434e9930f0f288c8b24293a.jpg",
"sign": "我是沃玛,做点傻开心的视频。日常发在微博:@_warma_ ",
"official_verify": {
"type": 0,
"desc": "bilibili 知名UP主"
},
"vip": {
"vipType": 2,
"vipDueDate": 1637424000000,
"dueRemark": "",
"accessStatus": 0,
"vipStatus": 1,
"vipStatusWarn": "",
"themeType": 0,
"label": {
"path": ""
}
}
}
],
"total": 1
}
}
```
</details>
## 查询共同关注明细
<img src="/imgs/relation.svg" width="100" height="100" />

View File

@ -45,29 +45,31 @@
| videos | num | 稿件分P总数 | 默认为1 |
| tid | num | 分区tID | |
| tname | str | 子分区名称 | |
| copyright | num | 是否转载 | 1原创<br />2转载 |
| copyright | num | 视频类型 | 1原创<br />2转载 |
| pic | str | 稿件封面图片url | |
| title | str | 稿件标题 | |
| pubdate | num | 稿件发布时间 | 时间戳 |
| ctime | num | 用户提交稿件的时间 | 时间戳 |
| ctime | num | 用户投稿时间 | 时间戳 |
| desc | str | 视频简介 | |
| state | num | 视频状态 | PS以下部分内容来源不明有待验证<br />0开放浏览<br />1橙色通过<br />-1待审<br />-2被打回<br />-3网警锁定<br />-4被锁定<br />-5管理员锁定可浏览<br />-6修复待审<br />-7暂缓审核<br />-8补档待审<br />-9等待转码<br />-10延迟审核<br />-11视频源待修<br />-12转储失败<br />-13允许评论待审<br />-14临时回收站<br />-15分发中<br />-16转码失败<br />-20创建未提交<br />-30创建已提交<br />-40定时发布<br />-100用户删除 |
| ~~attribute~~(仅做历史性保留) | ~~num~~ | ~~稿件属性位配置~~ | 除互动视频外均已被删除且仅显示互动视频属性位 |
| state | num | 视频状态 | **详情见下表** |
| ~~attribute~~(仅做历史性保留) | ~~num~~ | ~~稿件属性位配置~~ | **详情见下表**<br />除互动视频外均已被删除且仅显示互动视频属性位 |
| duration | num | 稿件总时长所有分P | 单位为秒 |
| mission_id | num | 稿件参与的活动ID | 无为0 |
| redirect_url | str | 重定向url | 用于番剧及影视的av/bv->ep |
| forward | num | 撞车视频跳转avid | 仅撞车视频存在此字段 |
| mission_id | num | 稿件参与的活动ID | |
| redirect_url | str | 重定向url | 仅番剧或影视视频存在此字段<br />用于番剧&影视的av/bv->ep |
| rights | obj | 视频属性标志 | |
| owner | obj | 视频UP主信息 | |
| stat | obj | 视频状态数 | |
| dynamic | str | 视频同步发布的的动态的文字内容 | 无为空 |
| dynamic | str | 视频同步发布的的动态的文字内容 | |
| cid | num | 视频1P CID | |
| dimension | obj | 视频1P分辨率 | |
| no_cache | bool | true | 作用尚不明确 |
| pages | array | 视频分P列表 | |
| subtitle | obj | 视频CC字幕 | |
| subtitle | obj | 视频CC字幕信息 | |
| staff | array | 合作成员列表 | 非合作视频无此项 |
| user_garb | obj | 用户装扮信息 | |
`attribute`属性位二进制值表:
`attribute`字段属性位二进制值表:
PS以下部分内容来源不明有待验证下表只做历史保留无实际作用
@ -104,6 +106,35 @@
| 28 | | |
| 29 | 是否为互动视频 | 该属性还可以找到固定为536870912转二进制再判断 |
`state`字段值:
PS以下部分内容来源不明且部分值前端不可见有待验证
| 值 | 内容 | 备注 |
| ---- | ------------ | ---------- |
| 1 | 橙色通过 | |
| 0 | 开放浏览 | |
| -1 | 待审 | |
| -2 | 被打回 | |
| -3 | 网警锁定 | |
| -4 | 被锁定 | 视频撞车了 |
| -5 | 管理员锁定 | |
| -6 | 修复待审 | |
| -7 | 暂缓审核 | |
| -8 | 补档待审 | |
| -9 | 等待转码 | |
| -10 | 延迟审核 | |
| -11 | 视频源待修 | |
| -12 | 转储失败 | |
| -13 | 允许评论待审 | |
| -14 | 临时回收站 | |
| -15 | 分发中 | |
| -16 | 转码失败 | |
| -20 | 创建未提交 | |
| -30 | 创建已提交 | |
| -40 | 定时发布 | |
| -100 | 用户删除 | |
`data`中的`rights`对象:
| 字段 | 类型 | 内容 | 备注 |
@ -253,6 +284,14 @@
| desc | str | 成员认证备注 | 无为空 |
| type | num | 成员认证类型 | -1<br />0有 |
`data`中的`user_garb`对象:
| 字段 | 类型 | 内容 | 备注 |
| ----------------- | ---- | ------- | ---- |
| url_image_ani_cut | str | 某url | |
**示例:**
获取视频`av85440373`/`BV117411r7R1`的基本信息
@ -276,124 +315,134 @@ curl -G 'http://api.bilibili.com/x/web-interface/view' \
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"bvid": "BV117411r7R1",
"aid": 85440373,
"videos": 1,
"tid": 28,
"tname": "原创音乐",
"copyright": 1,
"pic": "http://i1.hdslb.com/bfs/archive/ea0dd34bf41e23a68175680a00e3358cd249105f.jpg",
"title": "当我给拜年祭的快板加了电音配乐…",
"pubdate": 1580377255,
"ctime": 1580212263,
"desc": "【CB想说的】看完拜年祭之后最爱的一个节目给有快板的部分简单加了一些不同风格的配乐hhh感谢沃玛画的我太可爱了哈哈哈哈哈哈哈\n【Warma想说的】我画了打碟的CB画风为了还原原版视频所以参考了四迹老师的画风四迹老师的画真的太可爱啦不过其实在画的过程中我遇到了一个问题CB的耳机……到底是戴在哪个耳朵上呢\n\n原版av78977080\n编曲配乐Crazy Bucket\n人声配音Warma/谢拉\n曲绘四迹/Warma\n动画四迹/Crazy Bucket\n剧本Mokurei-木灵君\n音频后期DMYoung/纳兰寻风/Crazy Bucket\n包装破晓天",
"state": 0,
"attribute": 16793984,
"duration": 486,
"mission_id": 11838,
"rights": {
"bp": 0,
"elec": 0,
"download": 1,
"movie": 0,
"pay": 0,
"hd5": 1,
"no_reprint": 1,
"autoplay": 1,
"ugc_pay": 0,
"is_cooperation": 1,
"ugc_pay_preview": 0,
"no_background": 0
},
"owner": {
"mid": 66606350,
"name": "Crazy_Bucket",
"face": "http://i2.hdslb.com/bfs/face/5387950a59be8038daaae3f66dfb5a85e20d5737.jpg"
},
"stat": {
"aid": 85440373,
"view": 1419319,
"danmaku": 9203,
"reply": 2519,
"favorite": 49031,
"coin": 57470,
"share": 8120,
"now_rank": 0,
"his_rank": 55,
"like": 118462,
"dislike": 0,
"evaluation": ""
},
"dynamic": "进来就出不去了!!!\n#全民音乐UP主##CB##warma##电音##快板##拜年祭##诸神的奥运##编曲##Remix#",
"cid": 146044693,
"dimension": {
"width": 1920,
"height": 1080,
"rotate": 0
},
"no_cache": false,
"pages": [{
"cid": 146044693,
"page": 1,
"from": "vupload",
"part": "建议改成:建议改成:诸 神 的 电 音 节(不是)",
"duration": 486,
"vid": "",
"weblink": "",
"dimension": {
"width": 1920,
"height": 1080,
"rotate": 0
}
}],
"subtitle": {
"allow_submit": false,
"list": []
},
"staff": [{
"mid": 66606350,
"title": "UP主",
"name": "Crazy_Bucket",
"face": "http://i2.hdslb.com/bfs/face/5387950a59be8038daaae3f66dfb5a85e20d5737.jpg",
"vip": {
"type": 2,
"status": 1,
"vip_pay_type": 0,
"theme_type": 0
},
"official": {
"role": 2,
"title": "bilibili 知名音乐UP主",
"desc": "",
"type": 0
},
"follower": 369687,
"label_style": 0
}, {
"mid": 53456,
"title": "曲绘",
"name": "Warma",
"face": "http://i0.hdslb.com/bfs/face/32a43710a69155a5a90441ebedb6c05b63d2fd98.jpg",
"vip": {
"type": 2,
"status": 1,
"vip_pay_type": 0,
"theme_type": 0
},
"official": {
"role": 1,
"title": "bilibili 知名UP主",
"desc": "",
"type": 0
},
"follower": 1452718,
"label_style": 0
}]
}
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"bvid": "BV117411r7R1",
"aid": 85440373,
"videos": 1,
"tid": 28,
"tname": "原创音乐",
"copyright": 1,
"pic": "http://i1.hdslb.com/bfs/archive/ea0dd34bf41e23a68175680a00e3358cd249105f.jpg",
"title": "当我给拜年祭的快板加了电音配乐…",
"pubdate": 1580377255,
"ctime": 1580212263,
"desc": "【CB想说的】看完拜年祭之后最爱的一个节目给有快板的部分简单加了一些不同风格的配乐hhh感谢沃玛画的我太可爱了哈哈哈哈哈哈哈\n【Warma想说的】我画了打碟的CB画风为了还原原版视频所以参考了四迹老师的画风四迹老师的画真的太可爱啦不过其实在画的过程中我遇到了一个问题CB的耳机……到底是戴在哪个耳朵上呢\n\n原版av78977080\n编曲配乐Crazy Bucket\n人声配音Warma/谢拉\n曲绘四迹/Warma\n动画四迹/Crazy Bucket\n剧本Mokurei-木灵君\n音频后期DMYoung/纳兰寻风/Crazy Bucket\n包装破晓天",
"state": 0,
"duration": 486,
"mission_id": 11838,
"rights": {
"bp": 0,
"elec": 0,
"download": 1,
"movie": 0,
"pay": 0,
"hd5": 1,
"no_reprint": 1,
"autoplay": 1,
"ugc_pay": 0,
"is_cooperation": 1,
"ugc_pay_preview": 0,
"no_background": 0,
"clean_mode": 0,
"is_stein_gate": 0
},
"owner": {
"mid": 66606350,
"name": "Crazy_Bucket",
"face": "http://i2.hdslb.com/bfs/face/c9af3b32cf74baec5a4b65af8ca18ae5ff571f77.jpg"
},
"stat": {
"aid": 85440373,
"view": 1933942,
"danmaku": 11184,
"reply": 2625,
"favorite": 56520,
"coin": 66822,
"share": 9031,
"now_rank": 0,
"his_rank": 55,
"like": 142339,
"dislike": 0,
"evaluation": "",
"argue_msg": ""
},
"dynamic": "进来就出不去了!!!\n#全民音乐UP主##CB##warma##电音##快板##拜年祭##诸神的奥运##编曲##Remix#",
"cid": 146044693,
"dimension": {
"width": 1920,
"height": 1080,
"rotate": 0
},
"no_cache": false,
"pages": [
{
"cid": 146044693,
"page": 1,
"from": "vupload",
"part": "建议改成:建议改成:诸 神 的 电 音 节(不是)",
"duration": 486,
"vid": "",
"weblink": "",
"dimension": {
"width": 1920,
"height": 1080,
"rotate": 0
}
}
],
"subtitle": {
"allow_submit": false,
"list": []
},
"staff": [
{
"mid": 66606350,
"title": "UP主",
"name": "Crazy_Bucket",
"face": "http://i2.hdslb.com/bfs/face/c9af3b32cf74baec5a4b65af8ca18ae5ff571f77.jpg",
"vip": {
"type": 2,
"status": 1,
"vip_pay_type": 0,
"theme_type": 0
},
"official": {
"role": 2,
"title": "bilibili 知名音乐UP主",
"desc": "",
"type": 0
},
"follower": 628314,
"label_style": 0
},
{
"mid": 53456,
"title": "曲绘",
"name": "Warma",
"face": "http://i2.hdslb.com/bfs/face/c1bbee6d255f1e7fc434e9930f0f288c8b24293a.jpg",
"vip": {
"type": 2,
"status": 1,
"vip_pay_type": 0,
"theme_type": 0
},
"official": {
"role": 1,
"title": "bilibili 知名UP主",
"desc": "",
"type": 0
},
"follower": 2265914,
"label_style": 0
}
],
"user_garb": {
"url_image_ani_cut": "http://i0.hdslb.com/bfs/garb/item/bc037f95d050ad3160246f4d90d219389851e78a.bin"
}
}
}
```