github-repos/bilibili-API-collect
1
0
Fork 0
mirror of https://github.com/SocialSisterYi/bilibili-API-collect.git synced 2025-01-06 09:50:07 +08:00
Code Issues Packages Projects Releases Wiki Activity
f9b0e5ff74
bilibili-API-collect/user/relation.md

2109 lines
76 KiB
Markdown
Raw Normal View History

例行更新
2020-03-17 11:05:26 +08:00
# 用户关系相关
所有文档添加索引目录
2020-11-20 20:13:12 +08:00
- [查询用户粉丝明细](#查询用户粉丝明细)
- [查询用户关注明细](#查询用户关注明细)
更新【readme】中的声明 修复【评论区】接口 添加大量【appkey】 添加【客户端信息】接口 添加【纪念账号】相关字段 添加【搜索关注】接口
2021-02-08 00:34:54 +08:00
- [搜索关注明细](#搜索关注明细)
所有文档添加索引目录
2020-11-20 20:13:12 +08:00
- [查询共同关注明细](#查询共同关注明细)
添加【黑名单列表】与【悄悄关注列表】接口 并勘误
2020-11-21 23:56:44 +08:00
- [查询悄悄关注明细](#查询悄悄关注明细)
- [查询黑名单明细](#查询黑名单明细)
添加【视频在线人数】api，更新视频分区信息，并勘误
2021-08-20 19:54:13 +08:00
- [操作用户关系](#操作用户关系)
- [批量操作用户关系](#批量操作用户关系)
- [查询用户与自己关系_仅查关注](#查询用户与自己关系_仅查关注)
- [查询用户与自己关系_互相](#查询用户与自己关系_互相)
所有文档添加索引目录
2020-11-20 20:13:12 +08:00
- [批量查询用户与自己关系](#批量查询用户与自己关系)
- [关注分组相关](#关注分组相关)
- [查询关注分组列表](#查询关注分组列表)
- [查询关注分组明细](#查询关注分组明细)
- [查询目标用户所在的分组](#查询目标用户所在的分组 )
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
- [查询所有特别关注的mid](#查询所有特别关注的mid)
所有文档添加索引目录
2020-11-20 20:13:12 +08:00
- [创建分组](#创建分组)
- [重命名分组](#重命名分组)
- [删除分组](#删除分组)
添加【视频在线人数】api，更新视频分区信息，并勘误
2021-08-20 19:54:13 +08:00
- [修改分组成员](#修改分组成员)
所有文档添加索引目录
2020-11-20 20:13:12 +08:00
- [复制关注到分组](#复制关注到分组)
- [移动关注到分组](#移动关注到分组)
---
添加【查询登录记录】接口 修改若干【评论区】接口 添加【批量修改关系】和【批量查询关系】接口
2020-10-03 00:53:53 +08:00
## 查询用户粉丝明细
例行更新
2020-03-17 11:05:26 +08:00
优化格式&添加图标
2020-03-21 14:37:55 +08:00
<img src="/imgs/relation.svg" width="100" height="100" />
例行更新
2020-03-17 11:05:26 +08:00
添加bvID相关和POST参数类型
2020-03-23 16:46:13 +08:00
> http://api.bilibili.com/x/relation/followers
例行更新
2020-03-17 11:05:26 +08:00
优化文档格式
2020-07-14 18:44:44 +08:00
*请求方式：GET*
例行更新
2020-03-17 11:05:26 +08:00
添加【视频在线人数】api，更新视频分区信息，并勘误
2021-08-20 19:54:13 +08:00
认证方式：Cookie(SESSDATA)或APP
添加【查询登录记录】接口 修改若干【评论区】接口 添加【批量修改关系】和【批量查询关系】接口
2020-10-03 00:53:53 +08:00
完善note下所有api，包括列表以及内容查询 (#142) * 增加笔记列表（note/list.md） 链接加了，但是现在是打×的，如果确认没问题就改成√ * Update list.md * note最后一环施工 note\info.md (55%) user\relation.md 纠错 * 更新 note\action.md (补充) note\info.md (65%) * 修改纠错 感谢线程（bushi）程序撕裂者 @ProgramRipper * 更新info.md 更新note\info.md (75%) * note最后更新 note\info.md 完成 note系列存疑： http://api.bilibili.com/x/note/is_gray * 修改【视频笔记】相关api * 漏写了一个对号，加上(QAQ) Co-authored-by: SocialSisterYi <45892418+SocialSisterYi@users.noreply.github.com>
2021-02-03 00:26:27 +08:00
登录可看自己前1000名，其他用户仅可查看前100名
优化格式&添加图标
2020-03-21 14:37:55 +08:00
优化文档格式
2020-06-08 23:06:53 +08:00
**url参数：**
例行更新
2020-03-17 11:05:26 +08:00
添加【查询登录记录】接口 修改若干【评论区】接口 添加【批量修改关系】和【批量查询关系】接口
2020-10-03 00:53:53 +08:00
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------ | ----------- | ---------------------------------- |
| access_key | str | APP登录Token | APP方式必要 | |
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
| vmid | num | 目标用户mid | 必要 | |
添加【查询登录记录】接口 修改若干【评论区】接口 添加【批量修改关系】和【批量查询关系】接口
2020-10-03 00:53:53 +08:00
| ps | num | 每页项数 | 非必要 | 默认为50 |
| pn | num | 页码 | 非必要 | 默认为1<br />其他用户仅可查看前5页 |
例行更新
2020-03-17 11:05:26 +08:00
**json回复：**
优化文档格式
2020-04-16 18:47:19 +08:00
根对象：
添加微信&支付宝方式充电api
2020-03-25 12:05:53 +08:00
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | --------------------------------------------------- |
| code | num | 返回值 | 0：成功<br />-400：请求错误<br />22007：访问超过5页 |
| message | str | 错误信息 | 默认为0 |
继续修改文档格式 并添加频道相关
2020-07-17 23:50:28 +08:00
| ttl | num | 1 | |
添加微信&支付宝方式充电api
2020-03-25 12:05:53 +08:00
| data | obj | 信息本体 | |
例行更新
2020-03-17 11:05:26 +08:00
优化格式&添加图标
2020-03-21 14:37:55 +08:00
`data`对象：
例行更新
2020-03-17 11:05:26 +08:00
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ----- | -------- | ------------ |
| list | array | 明细列表 | |
| re_version | num | ？？？ | 作用尚不明确 |
| total | num | 粉丝总数 | |
优化格式&添加图标
2020-03-21 14:37:55 +08:00
`data`中的`list`数组：
例行更新
2020-03-17 11:05:26 +08:00
添加【视频在线人数】api，更新视频分区信息，并勘误
2021-08-20 19:54:13 +08:00
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | --------- | ---------------- |
| 0 | obj | 粉丝1 | |
| n | obj | 粉丝(n+1) | 按照关注顺序排列 |
| …… | obj | …… | …… |
例行更新
2020-03-17 11:05:26 +08:00
添加【黑名单列表】与【悄悄关注列表】接口 并勘误
2020-11-21 23:56:44 +08:00
`list`中的对象：
例行更新
2020-03-17 11:05:26 +08:00
添加微信&支付宝方式充电api
2020-03-25 12:05:53 +08:00
| 字段 | 类型 | 内容 | 备注 |
| --------------- | ---- | ------------ | --------------------------------------- |
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
| mid | num | 用户mid | |
添加微信&支付宝方式充电api
2020-03-25 12:05:53 +08:00
| attribute | num | 关注属性 | 0：未关注<br />2：已关注<br />6：已互粉 |
添加查询用户公告 追番 个人TAG以及直播间信息的4个api 并勘误
2020-04-08 16:20:28 +08:00
| mtime | num | 成为粉丝时间 | 时间戳<br />互关后刷新 |
添加【黑名单列表】与【悄悄关注列表】接口 并勘误
2020-11-21 23:56:44 +08:00
| tag | null | | |
| special | num | 0 | |
添加微信&支付宝方式充电api
2020-03-25 12:05:53 +08:00
| uname | str | 用户昵称 | |
增加了若干个人空间的api
2020-04-10 11:17:32 +08:00
| face | str | 用户头像url | |
添加微信&支付宝方式充电api
2020-03-25 12:05:53 +08:00
| sign | str | 用户签名 | |
| official_verify | obj | 认证信息 | |
| vip | obj | 会员信息 | |
例行更新
2020-03-17 11:05:26 +08:00
添加【黑名单列表】与【悄悄关注列表】接口 并勘误
2020-11-21 23:56:44 +08:00
`list`中的对象中的`official_verify`对象：
例行更新
2020-03-17 11:05:26 +08:00
添加微信&支付宝方式充电api
2020-03-25 12:05:53 +08:00
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ------------ | ------------------- |
Update relation.md (#215)
2021-07-12 00:28:43 +08:00
| type | num | 用户认证类型 | -1：无<br />0：个人认证<br />1：机构认证 |
添加微信&支付宝方式充电api
2020-03-25 12:05:53 +08:00
| desc | str | 用户认证信息 | 无为空 |
例行更新
2020-03-17 11:05:26 +08:00
添加【黑名单列表】与【悄悄关注列表】接口 并勘误
2020-11-21 23:56:44 +08:00
`list`中的对象中的`vip`对象：
例行更新
2020-03-17 11:05:26 +08:00
添加【黑名单列表】与【悄悄关注列表】接口 并勘误
2020-11-21 23:56:44 +08:00
| 字段 | 类型 | 内容 | 备注 |
| ------------- | ---- | ------------ | ----------------------------------------------- |
| 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 | ？？？ | 作用尚不明确 |
例行更新
2020-03-17 11:05:26 +08:00
优化格式&添加图标
2020-03-21 14:37:55 +08:00
`vip`中的`label`对象：
例行更新
2020-03-17 11:05:26 +08:00
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ------------ |
| path | str | 空 | 作用尚不明确 |
优化文档格式
2020-04-16 18:47:19 +08:00
**示例：**
例行更新
2020-03-17 11:05:26 +08:00
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
获取用户`mid=293793435`的粉丝明细
添加bvID相关和POST参数类型
2020-03-23 16:46:13 +08:00
优化文档格式
2020-07-14 18:44:44 +08:00
```shell
大量勘误 添加【指定用户的最近投币列表】接口
2020-10-16 19:31:41 +08:00
curl -G 'http://api.bilibili.com/x/relation/followers' \
--data-urlencode 'vmid=293793435' \
--data-urlencode 'ps=2' \
--data-urlencode 'pn=1' \
优化文档格式
2020-07-14 18:44:44 +08:00
-b 'SESSDATA=xxx'
```
例行更新
2020-03-17 11:05:26 +08:00
格式化
2020-08-31 16:37:38 +08:00
<details>
<summary>查看响应示例：</summary>
例行更新
2020-03-17 11:05:26 +08:00
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"list": [{
"mid": 387195656,
"attribute": 0,
"mtime": 1583839793,
"tag": null,
"special": 0,
"uname": "L_E_M_O_H_E",
"face": "http://i1.hdslb.com/bfs/face/8ec537db75eeb292faa8dc85a9ff8aba83148c86.jpg",
"sign": "暂时断更。。Back later",
"official_verify": {
"type": -1,
"desc": ""
},
"vip": {
"vipType": 0,
"vipDueDate": 0,
"dueRemark": "",
"accessStatus": 0,
"vipStatus": 0,
"vipStatusWarn": "",
"themeType": 0,
"label": {
"path": ""
}
}
}, {
"mid": 175989424,
"attribute": 0,
"mtime": 1583822019,
"tag": null,
"special": 0,
"uname": "哥本哈根iii",
"face": "http://i1.hdslb.com/bfs/face/e53c0fe9315176d48bd294b1f381f0da70131cd7.jpg",
"sign": "",
"official_verify": {
"type": -1,
"desc": ""
},
"vip": {
"vipType": 0,
"vipDueDate": 0,
"dueRemark": "",
"accessStatus": 0,
"vipStatus": 0,
"vipStatusWarn": "",
"themeType": 0,
"label": {
"path": ""
}
}
}],
"re_version": 3857745402,
"total": 365
}
}
```
格式化
2020-08-31 16:37:38 +08:00
</details>
添加【查询登录记录】接口 修改若干【评论区】接口 添加【批量修改关系】和【批量查询关系】接口
2020-10-03 00:53:53 +08:00
## 查询用户关注明细
例行更新
2020-03-17 11:05:26 +08:00
优化格式&添加图标
2020-03-21 14:37:55 +08:00
<img src="/imgs/relation.svg" width="100" height="100" />
例行更新
2020-03-17 11:05:26 +08:00
添加bvID相关和POST参数类型
2020-03-23 16:46:13 +08:00
> http://api.bilibili.com/x/relation/followings
例行更新
2020-03-17 11:05:26 +08:00
优化文档格式
2020-07-14 18:44:44 +08:00
*请求方式：GET*
例行更新
2020-03-17 11:05:26 +08:00
添加【视频在线人数】api，更新视频分区信息，并勘误
2021-08-20 19:54:13 +08:00
认证方式：Cookie(SESSDATA)或APP
添加【查询登录记录】接口 修改若干【评论区】接口 添加【批量修改关系】和【批量查询关系】接口
2020-10-03 00:53:53 +08:00
登录可看自己全部，其他用户仅可查看前5页
优化格式&添加图标
2020-03-21 14:37:55 +08:00
优化文档格式
2020-06-08 23:06:53 +08:00
**url参数：**
例行更新
2020-03-17 11:05:26 +08:00
添加【关注列表】排序参数 添加【互动弹幕获取】相关接口
2020-10-04 23:46:02 +08:00
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------ | ----------- | ------------------------------------------------------- |
| access_key | str | APP登录Token | APP方式必要 | |
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
| vmid | num | 目标用户mid | 必要 | |
添加【关注列表】排序参数 添加【互动弹幕获取】相关接口
2020-10-04 23:46:02 +08:00
| order_type | str | 排序方式 | 非必要 | 按照关注顺序排列：留空<br />按照最常访问排列：attention |
| ps | num | 每页项数 | 非必要 | 默认为50 |
| pn | num | 页码 | 非必要 | 默认为1<br />其他用户仅可查看前5页 |
例行更新
2020-03-17 11:05:26 +08:00
**json回复：**
优化文档格式
2020-04-16 18:47:19 +08:00
根对象：
添加微信&支付宝方式充电api
2020-03-25 12:05:53 +08:00
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | --------------------------------------------------- |
| code | num | 返回值 | 0：成功<br />-400：请求错误<br />22007：访问超过5页 |
| message | str | 错误信息 | 默认为0 |
继续修改文档格式 并添加频道相关
2020-07-17 23:50:28 +08:00
| ttl | num | 1 | |
添加微信&支付宝方式充电api
2020-03-25 12:05:53 +08:00
| data | obj | 信息本体 | |
例行更新
2020-03-17 11:05:26 +08:00
data 对象：
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ----- | -------- | ------------ |
| list | array | 明细列表 | |
| re_version | num | ？？？ | 作用尚不明确 |
| total | num | 关注总数 | |
优化格式&添加图标
2020-03-21 14:37:55 +08:00
`data`中的`list`数组：
例行更新
2020-03-17 11:05:26 +08:00
添加【视频在线人数】api，更新视频分区信息，并勘误
2021-08-20 19:54:13 +08:00
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | --------- | ---------------- |
| 0 | obj | 关注1 | |
| n | obj | 关注(n+1) | 按照关注顺序排列 |
| …… | obj | …… | …… |
例行更新
2020-03-17 11:05:26 +08:00
优化格式&添加图标
2020-03-21 14:37:55 +08:00
数组`list`中的对象：
例行更新
2020-03-17 11:05:26 +08:00
添加微信&支付宝方式充电api
2020-03-25 12:05:53 +08:00
| 字段 | 类型 | 内容 | 备注 |
| --------------- | ---------------------------------------- | ------------ | --------------------------------------- |
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
| mid | num | 用户mid | |
添加微信&支付宝方式充电api
2020-03-25 12:05:53 +08:00
| attribute | num | 关注属性 | 0：未关注<br />2：已关注<br />6：已互粉 |
添加查询用户公告 追番 个人TAG以及直播间信息的4个api 并勘误
2020-04-08 16:20:28 +08:00
| mtime | num | 关注对方时间 | 时间戳<br />互关后刷新 |
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
| tag | 默认分组：null<br />存在至少一个分组：array | 分组id | |
添加微信&支付宝方式充电api
2020-03-25 12:05:53 +08:00
| special | num | 特别关注标志 | 0：否<br />1：是 |
| uname | str | 用户昵称 | |
增加了若干个人空间的api
2020-04-10 11:17:32 +08:00
| face | str | 用户头像url | |
添加微信&支付宝方式充电api
2020-03-25 12:05:53 +08:00
| sign | str | 用户签名 | |
| official_verify | obj | 认证信息 | |
| vip | obj | 会员信息 | |
例行更新
2020-03-17 11:05:26 +08:00
优化格式&添加图标
2020-03-21 14:37:55 +08:00
数组`list`中的对象中的`tag`数组：
例行更新
2020-03-17 11:05:26 +08:00
添加【视频在线人数】api，更新视频分区信息，并勘误
2021-08-20 19:54:13 +08:00
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | --------------------- | ---- |
| 0 | num | 位于分组1的分组id | |
| n | num | 位于分组(n+1)的分组id | |
| …… | num | …… | …… |
例行更新
2020-03-17 11:05:26 +08:00
添加【黑名单列表】与【悄悄关注列表】接口 并勘误
2020-11-21 23:56:44 +08:00
`list`中的对象中的`official_verify`对象：
例行更新
2020-03-17 11:05:26 +08:00
添加微信&支付宝方式充电api
2020-03-25 12:05:53 +08:00
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ------------ | ------------------- |
添加【黑名单列表】与【悄悄关注列表】接口 并勘误
2020-11-21 23:56:44 +08:00
| type | num | 用户认证类型 | -1：无<br />1：认证 |
添加微信&支付宝方式充电api
2020-03-25 12:05:53 +08:00
| desc | str | 用户认证信息 | 无为空 |
例行更新
2020-03-17 11:05:26 +08:00
添加【黑名单列表】与【悄悄关注列表】接口 并勘误
2020-11-21 23:56:44 +08:00
`list`中的对象中的`vip`对象：
例行更新
2020-03-17 11:05:26 +08:00
添加【黑名单列表】与【悄悄关注列表】接口 并勘误
2020-11-21 23:56:44 +08:00
| 字段 | 类型 | 内容 | 备注 |
| ------------- | ---- | ------------ | ----------------------------------------------- |
| 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 | ？？？ | 作用尚不明确 |
例行更新
2020-03-17 11:05:26 +08:00
优化格式&添加图标
2020-03-21 14:37:55 +08:00
`vip`中的`label`对象：
例行更新
2020-03-17 11:05:26 +08:00
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ------------ |
| path | str | 空 | 作用尚不明确 |
优化文档格式
2020-04-16 18:47:19 +08:00
**示例：**
例行更新
2020-03-17 11:05:26 +08:00
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
获取用户`mid=293793435`的关注明细，按照关注顺序
添加bvID相关和POST参数类型
2020-03-23 16:46:13 +08:00
优化文档格式
2020-07-14 18:44:44 +08:00
```shell
修改命令中的拼写错误 (#287)
2021-12-10 17:57:54 +08:00
curl -G 'http://api.bilibili.com/x/relation/followings' \
大量勘误 添加【指定用户的最近投币列表】接口
2020-10-16 19:31:41 +08:00
--data-urlencode 'vmid=293793435' \
--data-urlencode 'order_type=' \
--data-urlencode 'ps=2' \
--data-urlencode 'pn=1' \
优化文档格式
2020-07-14 18:44:44 +08:00
-b 'SESSDATA=xxx'
```
例行更新
2020-03-17 11:05:26 +08:00
格式化
2020-08-31 16:37:38 +08:00
<details>
<summary>查看响应示例：</summary>
例行更新
2020-03-17 11:05:26 +08:00
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"list": [{
"mid": 14082,
"attribute": 2,
"mtime": 1584271945,
"tag": null,
"special": 0,
"uname": "山新",
"face": "http://i0.hdslb.com/bfs/face/74c82caee6d9eb623e56161ea8ed6d68afabfeae.jpg",
"sign": "都说了是天依爹地，不是妈咪。\r私信有点多回复不过来～商业合作啥的请移步Weibo私信@山新 哦哦哦～",
"official_verify": {
"type": 0,
"desc": "配音演员、声优。洛天依声源提供者。"
},
"vip": {
"vipType": 2,
"vipDueDate": 1601654400000,
"dueRemark": "",
"accessStatus": 0,
"vipStatus": 1,
"vipStatusWarn": "",
"themeType": 0,
"label": {
"path": ""
}
}
}, {
"mid": 420831218,
"attribute": 2,
"mtime": 1584208169,
"tag": [207542],
"special": 0,
"uname": "支付宝Alipay",
"face": "http://i2.hdslb.com/bfs/face/aaf18aeb2d9822e28a590bd8d878572ca8c59e04.jpg",
"sign": "阿支来了，关注点赞转发投币四连走起！",
"official_verify": {
"type": 1,
"desc": "支付宝官方账号"
},
"vip": {
"vipType": 1,
"vipDueDate": 1585065600000,
"dueRemark": "",
"accessStatus": 0,
"vipStatus": 1,
"vipStatusWarn": "",
"themeType": 0,
"label": {
"path": ""
}
}
}],
"re_version": 3228575555,
"total": 699
}
}
```
格式化
2020-08-31 16:37:38 +08:00
</details>
更新【readme】中的声明 修复【评论区】接口 添加大量【appkey】 添加【客户端信息】接口 添加【纪念账号】相关字段 添加【搜索关注】接口
2021-02-08 00:34:54 +08:00
## 搜索关注明细
<img src="/imgs/relation.svg" width="100" height="100" />
> http://api.bilibili.com/x/relation/followings/search
*请求方式：GET*
添加【视频在线人数】api，更新视频分区信息，并勘误
2021-08-20 19:54:13 +08:00
认证方式：Cookie(SESSDATA)或APP
更新【readme】中的声明 修复【评论区】接口 添加大量【appkey】 添加【客户端信息】接口 添加【纪念账号】相关字段 添加【搜索关注】接口
2021-02-08 00:34:54 +08:00
**url参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------ | ----------- | -------- |
| access_key | str | APP登录Token | APP方式必要 | |
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
| vmid | str | 目标用户mid | 必要 | |
更新【readme】中的声明 修复【评论区】接口 添加大量【appkey】 添加【客户端信息】接口 添加【纪念账号】相关字段 添加【搜索关注】接口
2021-02-08 00:34:54 +08:00
| name | str | 搜索关键词 | 必要 | |
| ps | num | 每页项数 | 非必要 | 默认为50 |
| pn | num | 页码 | 非必要 | 默认为1 |
data 对象：
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ----- | -------- | ------------ |
| list | array | 明细列表 | |
| re_version | num | ？？？ | 作用尚不明确 |
| total | num | 关注总数 | |
`data`中的`list`数组：
添加【视频在线人数】api，更新视频分区信息，并勘误
2021-08-20 19:54:13 +08:00
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ------------- | ---------------- |
| 0 | obj | 共同关注1 | |
| n | obj | 共同关注(n+1) | 按照关注顺序排列 |
| …… | obj | …… | …… |
更新【readme】中的声明 修复【评论区】接口 添加大量【appkey】 添加【客户端信息】接口 添加【纪念账号】相关字段 添加【搜索关注】接口
2021-02-08 00:34:54 +08:00
数组`list`中的对象：
| 字段 | 类型 | 内容 | 备注 |
| --------------- | ------------------------------------------- | ------------ | --------------------------------------- |
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
| mid | num | 用户mid | |
更新【readme】中的声明 修复【评论区】接口 添加大量【appkey】 添加【客户端信息】接口 添加【纪念账号】相关字段 添加【搜索关注】接口
2021-02-08 00:34:54 +08:00
| attribute | num | 关注属性 | 0：未关注<br />2：已关注<br />6：已互粉 |
| mtime | num | 关注对方时间 | 时间戳<br />互关后刷新 |
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
| tag | 默认分组：null<br />存在至少一个分组：array | 分组id | |
更新【readme】中的声明 修复【评论区】接口 添加大量【appkey】 添加【客户端信息】接口 添加【纪念账号】相关字段 添加【搜索关注】接口
2021-02-08 00:34:54 +08:00
| special | num | 特别关注标志 | 0：否<br />1：是 |
| uname | str | 用户昵称 | |
| face | str | 用户头像url | |
| sign | str | 用户签名 | |
| official_verify | obj | 认证信息 | |
| vip | obj | 会员信息 | |
数组`list`中的对象中的`tag`数组：
添加【视频在线人数】api，更新视频分区信息，并勘误
2021-08-20 19:54:13 +08:00
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | --------------------- | ---- |
| 0 | num | 位于分组1的分组id | |
| n | num | 位于分组(n+1)的分组id | |
| …… | num | …… | …… |
更新【readme】中的声明 修复【评论区】接口 添加大量【appkey】 添加【客户端信息】接口 添加【纪念账号】相关字段 添加【搜索关注】接口
2021-02-08 00:34:54 +08:00
`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>
添加【查询登录记录】接口 修改若干【评论区】接口 添加【批量修改关系】和【批量查询关系】接口
2020-10-03 00:53:53 +08:00
## 查询共同关注明细
<img src="/imgs/relation.svg" width="100" height="100" />
> http://api.bilibili.com/x/relation/same/followings
*请求方式：GET*
添加【视频在线人数】api，更新视频分区信息，并勘误
2021-08-20 19:54:13 +08:00
认证方式：Cookie(SESSDATA)或APP
添加【查询登录记录】接口 修改若干【评论区】接口 添加【批量修改关系】和【批量查询关系】接口
2020-10-03 00:53:53 +08:00
**url参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------ | ----------- | -------- |
| access_key | str | APP登录Token | APP方式必要 | |
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
| vmid | num | 目标用户mid | 必要 | |
添加【查询登录记录】接口 修改若干【评论区】接口 添加【批量修改关系】和【批量查询关系】接口
2020-10-03 00:53:53 +08:00
| ps | num | 每页项数 | 非必要 | 默认为50 |
| pn | num | 页码 | 非必要 | 默认为1 |
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------- |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-400：请求错误 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | obj | 信息本体 | |
data 对象：
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ----- | -------- | ------------ |
| list | array | 明细列表 | |
| re_version | num | ？？？ | 作用尚不明确 |
| total | num | 关注总数 | |
`data`中的`list`数组：
添加【视频在线人数】api，更新视频分区信息，并勘误
2021-08-20 19:54:13 +08:00
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ------------- | ---------------- |
| 0 | obj | 共同关注1 | |
| n | obj | 共同关注(n+1) | 按照关注顺序排列 |
| …… | obj | …… | …… |
添加【查询登录记录】接口 修改若干【评论区】接口 添加【批量修改关系】和【批量查询关系】接口
2020-10-03 00:53:53 +08:00
数组`list`中的对象：
添加【黑名单列表】与【悄悄关注列表】接口 并勘误
2020-11-21 23:56:44 +08:00
| 字段 | 类型 | 内容 | 备注 |
| --------------- | ------------------------------------------- | ------------ | --------------------------------------- |
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
| mid | num | 用户mid | |
添加【黑名单列表】与【悄悄关注列表】接口 并勘误
2020-11-21 23:56:44 +08:00
| attribute | num | 关注属性 | 0：未关注<br />2：已关注<br />6：已互粉 |
| mtime | num | 关注对方时间 | 时间戳<br />互关后刷新 |
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
| tag | 默认分组：null<br />存在至少一个分组：array | 分组id | |
添加【黑名单列表】与【悄悄关注列表】接口 并勘误
2020-11-21 23:56:44 +08:00
| special | num | 特别关注标志 | 0：否<br />1：是 |
| uname | str | 用户昵称 | |
| face | str | 用户头像url | |
| sign | str | 用户签名 | |
| official_verify | obj | 认证信息 | |
| vip | obj | 会员信息 | |
添加【查询登录记录】接口 修改若干【评论区】接口 添加【批量修改关系】和【批量查询关系】接口
2020-10-03 00:53:53 +08:00
数组`list`中的对象中的`tag`数组：
添加【视频在线人数】api，更新视频分区信息，并勘误
2021-08-20 19:54:13 +08:00
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | --------------------- | ---- |
| 0 | num | 位于分组1的分组id | |
| n | num | 位于分组(n+1)的分组id | |
| …… | num | …… | …… |
添加【查询登录记录】接口 修改若干【评论区】接口 添加【批量修改关系】和【批量查询关系】接口
2020-10-03 00:53:53 +08:00
添加【黑名单列表】与【悄悄关注列表】接口 并勘误
2020-11-21 23:56:44 +08:00
`list`中的对象中的`official_verify`对象：
添加【查询登录记录】接口 修改若干【评论区】接口 添加【批量修改关系】和【批量查询关系】接口
2020-10-03 00:53:53 +08:00
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ------------ | ------------------- |
添加【黑名单列表】与【悄悄关注列表】接口 并勘误
2020-11-21 23:56:44 +08:00
| type | num | 用户认证类型 | -1：无<br />1：认证 |
添加【查询登录记录】接口 修改若干【评论区】接口 添加【批量修改关系】和【批量查询关系】接口
2020-10-03 00:53:53 +08:00
| desc | str | 用户认证信息 | 无为空 |
添加【黑名单列表】与【悄悄关注列表】接口 并勘误
2020-11-21 23:56:44 +08:00
`list`中的对象中的`vip`对象：
添加【查询登录记录】接口 修改若干【评论区】接口 添加【批量修改关系】和【批量查询关系】接口
2020-10-03 00:53:53 +08:00
添加【黑名单列表】与【悄悄关注列表】接口 并勘误
2020-11-21 23:56:44 +08:00
| 字段 | 类型 | 内容 | 备注 |
| ------------- | ---- | ------------ | ----------------------------------------------- |
| 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 | ？？？ | 作用尚不明确 |
添加【查询登录记录】接口 修改若干【评论区】接口 添加【批量修改关系】和【批量查询关系】接口
2020-10-03 00:53:53 +08:00
`vip`中的`label`对象：
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ------------ |
| path | str | 空 | 作用尚不明确 |
**示例：**
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
获取自己与用户`mid=2`的共同关注明细
添加【查询登录记录】接口 修改若干【评论区】接口 添加【批量修改关系】和【批量查询关系】接口
2020-10-03 00:53:53 +08:00
```shell
大量勘误 添加【指定用户的最近投币列表】接口
2020-10-16 19:31:41 +08:00
curl -G 'http://api.bilibili.com/x/relation/same/followings' \
--data-urlencode 'vmid=2' \
--data-urlencode 'ps=2' \
--data-urlencode 'pn=1' \
添加【查询登录记录】接口 修改若干【评论区】接口 添加【批量修改关系】和【批量查询关系】接口
2020-10-03 00:53:53 +08:00
-b 'SESSDATA=xxx'
```
<details>
<summary>查看响应示例：</summary>
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"list": [
{
"mid": 116683,
"attribute": 2,
"mtime": 1564627532,
"tag": null,
"special": 0,
"uname": "=咬人猫=",
"face": "http://i0.hdslb.com/bfs/face/8fad84a4470f3d894d8f0dc95555ab8f2cb10a83.jpg",
"sign": "面瘫女仆酱~小粗腿~事业线什么的！！吐槽你就输了！喵~",
"official_verify": {
"type": 0,
"desc": "bilibili 2019百大UP主、高能联盟成员"
},
"vip": {
"vipType": 2,
"vipDueDate": 1618934400000,
"dueRemark": "",
"accessStatus": 0,
"vipStatus": 1,
"vipStatusWarn": "",
"themeType": 0,
"label": {
"path": ""
}
}
},
{
"mid": 517717593,
"attribute": 2,
"mtime": 1592126052,
"tag": [
207542
],
"special": 0,
"uname": "上海爱丽丝幻乐团",
"face": "http://i0.hdslb.com/bfs/face/851a9191cbe93e66304d7577c0f6f83834e52109.jpg",
"sign": "日本同人社团 上海爱丽丝幻乐团",
"official_verify": {
"type": 0,
"desc": "上海爱丽丝幻乐团官方账号"
},
"vip": {
"vipType": 1,
"vipDueDate": 1593792000000,
"dueRemark": "",
"accessStatus": 0,
"vipStatus": 0,
"vipStatusWarn": "",
"themeType": 0,
"label": {
"path": ""
}
}
}
],
"re_version": 2498273968,
"total": 38
}
}
```
</details>
添加【黑名单列表】与【悄悄关注列表】接口 并勘误
2020-11-21 23:56:44 +08:00
## 查询悄悄关注明细
<img src="/imgs/relation.svg" width="100" height="100" />
> http://api.bilibili.com/x/relation/whispers
*请求方式：GET*
添加【视频在线人数】api，更新视频分区信息，并勘误
2021-08-20 19:54:13 +08:00
认证方式：Cookie(SESSDATA)或APP
添加【黑名单列表】与【悄悄关注列表】接口 并勘误
2020-11-21 23:56:44 +08:00
**url参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------ | ----------- | -------- |
| access_key | str | APP登录Token | APP方式必要 | |
| ps | num | 每页项数 | 非必要 | 默认为50 |
| pn | num | 页码 | 非必要 | 默认为1 |
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------- |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-400：请求错误 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | obj | 信息本体 | |
data 对象：
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ----- | -------- | ------------ |
| list | array | 明细列表 | |
| re_version | num | ？？？ | 作用尚不明确 |
`data`中的`list`数组：
添加【视频在线人数】api，更新视频分区信息，并勘误
2021-08-20 19:54:13 +08:00
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | --------- | ---------------- |
| 0 | obj | 关注1 | |
| n | obj | 关注(n+1) | 按照关注顺序排列 |
| …… | obj | …… | …… |
添加【黑名单列表】与【悄悄关注列表】接口 并勘误
2020-11-21 23:56:44 +08:00
数组`list`中的对象：
| 字段 | 类型 | 内容 | 备注 |
| --------------- | ------------------------------------------- | ------------ | --------------------------------------- |
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
| mid | num | 用户mid | |
添加【黑名单列表】与【悄悄关注列表】接口 并勘误
2020-11-21 23:56:44 +08:00
| attribute | num | 关注属性 | 0：未关注<br />2：已关注<br />6：已互粉 |
| mtime | num | 关注对方时间 | 时间戳<br />互关后刷新 |
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
| tag | 默认分组：null<br />存在至少一个分组：array | 分组id | |
添加【黑名单列表】与【悄悄关注列表】接口 并勘误
2020-11-21 23:56:44 +08:00
| special | num | 特别关注标志 | 0：否<br />1：是 |
| uname | str | 用户昵称 | |
| face | str | 用户头像url | |
| sign | str | 用户签名 | |
| official_verify | obj | 认证信息 | |
| vip | obj | 会员信息 | |
数组`list`中的对象中的`tag`数组：
添加【视频在线人数】api，更新视频分区信息，并勘误
2021-08-20 19:54:13 +08:00
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | --------------------- | ---- |
| 0 | num | 位于分组1的分组id | |
| n | num | 位于分组(n+1)的分组id | |
| …… | num | …… | …… |
添加【黑名单列表】与【悄悄关注列表】接口 并勘误
2020-11-21 23:56:44 +08:00
`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 | 空 | 作用尚不明确 |
**示例：**
获取悄悄关注明细
```shell
curl -G 'http://api.bilibili.com/x/relation/whispers' \
--data-urlencode 'ps=2' \
--data-urlencode 'pn=1' \
-b 'SESSDATA=xxx'
```
<details>
<summary>查看响应示例：</summary>
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"list": [
{
"mid": 178429408,
"attribute": 1,
"mtime": 1605972105,
"tag": null,
"special": 0,
"uname": "老弟一号",
"face": "http://i2.hdslb.com/bfs/face/21426275f3d3149b96b88783275205ba574c09e3.jpg",
"sign": "萌新硬件玩家，前垃圾佬～(◦˙▽˙◦某宝店 老弟一号 粉丝群679540094商务合作V13869651328",
"official_verify": {
"type": 0,
"desc": "知识领域优质UP主"
},
"vip": {
"vipType": 2,
"vipDueDate": 1632499200000,
"dueRemark": "",
"accessStatus": 0,
"vipStatus": 1,
"vipStatusWarn": "",
"themeType": 0,
"label": {
"path": ""
}
}
}
],
"re_version": 2137574562
}
}
```
</details>
## 查询黑名单明细
> http://api.bilibili.com/x/relation/blacks
*请求方式：GET*
添加【视频在线人数】api，更新视频分区信息，并勘误
2021-08-20 19:54:13 +08:00
认证方式：Cookie(SESSDATA)或APP
添加【黑名单列表】与【悄悄关注列表】接口 并勘误
2020-11-21 23:56:44 +08:00
**url参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------ | ----------- | -------- |
| access_key | str | APP登录Token | APP方式必要 | |
| ps | num | 每页项数 | 非必要 | 默认为50 |
| pn | num | 页码 | 非必要 | 默认为1 |
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------- |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-400：请求错误 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | obj | 信息本体 | |
data 对象：
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ----- | ------------ | ------------ |
| list | array | 明细列表 | |
| re_version | num | ？？？ | 作用尚不明确 |
| total | num | 黑名单总计数 | |
`data`中的`list`数组：
添加【视频在线人数】api，更新视频分区信息，并勘误
2021-08-20 19:54:13 +08:00
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | --------- | ---------------- |
| 0 | obj | 关注1 | |
| n | obj | 关注(n+1) | 按照关注顺序排列 |
| …… | obj | …… | …… |
添加【黑名单列表】与【悄悄关注列表】接口 并勘误
2020-11-21 23:56:44 +08:00
数组`list`中的对象：
| 字段 | 类型 | 内容 | 备注 |
| --------------- | ---- | ------------ | ---------------------- |
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
| mid | num | 用户mid | |
添加【黑名单列表】与【悄悄关注列表】接口 并勘误
2020-11-21 23:56:44 +08:00
| attribute | num | 关注属性 | 128：已拉黑 |
| mtime | num | 关注对方时间 | 时间戳<br />互关后刷新 |
| tag | null | | |
| special | num | 0 | |
| uname | str | 用户昵称 | |
| face | str | 用户头像url | |
| sign | str | 用户签名 | |
| official_verify | obj | 认证信息 | |
| vip | obj | 会员信息 | |
`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 | 空 | 作用尚不明确 |
**示例：**
获取黑名单明细
```shell
curl -G 'http://api.bilibili.com/x/relation/blacks' \
--data-urlencode 'ps=2' \
--data-urlencode 'pn=1' \
-b 'SESSDATA=xxx'
```
<details>
<summary>查看响应示例：</summary>
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"list": [
{
"mid": 22179720,
"attribute": 128,
"mtime": 1603032789,
"tag": null,
"special": 0,
"uname": "咩2016",
"face": "http://i0.hdslb.com/bfs/face/41fe435a7e62eae605a5908652f32f3afff2ae74.jpg",
"sign": "",
"official_verify": {
"type": 0,
"desc": ""
},
"vip": {
"vipType": 0,
"vipDueDate": 0,
"dueRemark": "",
"accessStatus": 0,
"vipStatus": 0,
"vipStatusWarn": "",
"themeType": 0,
"label": {
"path": ""
}
}
},
{
"mid": 16174624,
"attribute": 128,
"mtime": 1603026420,
"tag": null,
"special": 0,
"uname": "其实死亡没有那么痛",
"face": "http://i2.hdslb.com/bfs/face/79257f5a2e7194a71337ccca5927afba7706d316.jpg",
"sign": "等我，我马上就来",
"official_verify": {
"type": 0,
"desc": ""
},
"vip": {
"vipType": 0,
"vipDueDate": 0,
"dueRemark": "",
"accessStatus": 0,
"vipStatus": 0,
"vipStatusWarn": "",
"themeType": 0,
"label": {
"path": ""
}
}
}
],
"re_version": 897205356,
"total": 2
}
}
```
</details>
添加【视频在线人数】api，更新视频分区信息，并勘误
2021-08-20 19:54:13 +08:00
## 操作用户关系
例行更新
2020-03-17 11:05:26 +08:00
优化格式&添加图标
2020-03-21 14:37:55 +08:00
<img src="/imgs/follow.svg" width="200" height="100" />
例行更新
2020-03-17 11:05:26 +08:00
添加bvID相关和POST参数类型
2020-03-23 16:46:13 +08:00
> http://api.bilibili.com/x/relation/modify
例行更新
2020-03-17 11:05:26 +08:00
优化文档格式
2020-07-14 18:44:44 +08:00
*请求方式：POST*
例行更新
2020-03-17 11:05:26 +08:00
添加【视频在线人数】api，更新视频分区信息，并勘误
2021-08-20 19:54:13 +08:00
认证方式：Cookie(SESSDATA)或APP
优化格式&添加图标
2020-03-21 14:37:55 +08:00
添加【视频在线人数】api，更新视频分区信息，并勘误
2021-08-20 19:54:13 +08:00
**正文参数( application/x-www-form-urlencoded )：**
例行更新
2020-03-17 11:05:26 +08:00
添加【视频在线人数】api，更新视频分区信息，并勘误
2021-08-20 19:54:13 +08:00
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ---------------------- | -------------- | -------------------------------------------------------- |
| access_key | str | APP登录Token | APP方式必要 | |
| fid | num | 目标用户mid | 必要 | |
| act | num | 操作代码 | 必要 | **操作代码见下表** |
| re_src | num | 关注来源代码 | 必要 | 空间：11<br />视频：14<br />文章：115<br />活动页面：222 |
| csrf | str | CSRF Token(位于cookie) | Cookie方式必要 | |
例行更新
2020-03-17 11:05:26 +08:00
优化文档格式
2020-04-16 18:47:19 +08:00
操作代码`act`：
例行更新
2020-03-17 11:05:26 +08:00
| 代码 | 含义 |
| ---- | ------------ |
| 1 | 关注 |
| 2 | 取关 |
| 3 | 悄悄关注 |
| 4 | 取消悄悄关注 |
| 5 | 拉黑 |
| 6 | 取消拉黑 |
| 7 | 踢出粉丝 |
**json回复：**
优化文档格式
2020-04-16 18:47:19 +08:00
根对象：
例行更新
2020-03-17 11:05:26 +08:00
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
Update relation.md (#192) fix a typo; add a return code
2021-06-08 23:23:32 +08:00
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-102：账号被封停<br />-111：csrf校验失败<br />-400：请求错误<br />22001：不能对自己进行此操作<br />22003：用户位于黑名单 |
例行更新
2020-03-17 11:05:26 +08:00
| message | str | 错误信息 | 默认为0 |
继续修改文档格式 并添加频道相关
2020-07-17 23:50:28 +08:00
| ttl | num | 1 | |
例行更新
2020-03-17 11:05:26 +08:00
优化文档格式
2020-04-16 18:47:19 +08:00
**示例：**
例行更新
2020-03-17 11:05:26 +08:00
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
关注`mid=14082`的用户
添加bvID相关和POST参数类型
2020-03-23 16:46:13 +08:00
优化文档格式
2020-07-14 18:44:44 +08:00
```shell
Update relation.md (#192) fix a typo; add a return code
2021-06-08 23:23:32 +08:00
curl 'http://api.bilibili.com/x/relation/modify' \
大量勘误 添加【指定用户的最近投币列表】接口
2020-10-16 19:31:41 +08:00
--data-urlencode 'fid=14082' \
--data-urlencode 'act=1' \
--data-urlencode 're_src=11' \
--data-urlencode 'csrf=xxx' \
优化文档格式
2020-07-14 18:44:44 +08:00
-b 'SESSDATA=xxx'
```
例行更新
2020-03-17 11:05:26 +08:00
格式化
2020-08-31 16:37:38 +08:00
<details>
<summary>查看响应示例：</summary>
例行更新
2020-03-17 11:05:26 +08:00
```json
{
"code": 0,
"message": "0",
"ttl": 1
}
```
格式化
2020-08-31 16:37:38 +08:00
</details>
添加【视频在线人数】api，更新视频分区信息，并勘误
2021-08-20 19:54:13 +08:00
## 批量操作用户关系
添加【查询登录记录】接口 修改若干【评论区】接口 添加【批量修改关系】和【批量查询关系】接口
2020-10-03 00:53:53 +08:00
> http://api.bilibili.com/x/relation/batch/modify
*请求方式：POST*
添加【视频在线人数】api，更新视频分区信息，并勘误
2021-08-20 19:54:13 +08:00
认证方式：Cookie(SESSDATA)或APP
添加【查询登录记录】接口 修改若干【评论区】接口 添加【批量修改关系】和【批量查询关系】接口
2020-10-03 00:53:53 +08:00
添加【视频在线人数】api，更新视频分区信息，并勘误
2021-08-20 19:54:13 +08:00
此接口只支持关注和拉黑操作
添加【查询登录记录】接口 修改若干【评论区】接口 添加【批量修改关系】和【批量查询关系】接口
2020-10-03 00:53:53 +08:00
添加【视频在线人数】api，更新视频分区信息，并勘误
2021-08-20 19:54:13 +08:00
**正文参数( application/x-www-form-urlencoded )：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ---------------------- | -------------- | ---------------------------------------------- |
| access_key | str | APP登录Token | APP方式必要 | |
| fids | nums | 目标用户mid | 必要 | 每个之间用`,`间隔 |
| act | num | 操作代码 | 必要 | 同上<br />仅可为1或5，故只能进行批量关注和拉黑 |
| re_src | num | 关注来源代码 | 必要 | 同上 |
| csrf | str | CSRF Token(位于cookie) | Cookie方式必要 | |
添加【查询登录记录】接口 修改若干【评论区】接口 添加【批量修改关系】和【批量查询关系】接口
2020-10-03 00:53:53 +08:00
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-102：账号被封停<br />-111：csrf校验失败<br />-400：请求错误<br />22003：用户位于黑名单 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | obj | 数据本体 | |
`data`对象：
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ----- | ------------- | ---- |
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
| failed_fids | array | 操作失败的mid | |
添加【查询登录记录】接口 修改若干【评论区】接口 添加【批量修改关系】和【批量查询关系】接口
2020-10-03 00:53:53 +08:00
`data`中的`failed_fids`数组：
添加【视频在线人数】api，更新视频分区信息，并勘误
2021-08-20 19:54:13 +08:00
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ------------------ | ---- |
| 0 | num | 操作失败的mid 1 | |
| n | num | 操作失败的mid(n+1) | |
| …… | num | …… | …… |
添加【查询登录记录】接口 修改若干【评论区】接口 添加【批量修改关系】和【批量查询关系】接口
2020-10-03 00:53:53 +08:00
**示例：**
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
批量关注`mid=1,2,3,4,5`的用户
添加【查询登录记录】接口 修改若干【评论区】接口 添加【批量修改关系】和【批量查询关系】接口
2020-10-03 00:53:53 +08:00
```shell
大量勘误 添加【指定用户的最近投币列表】接口
2020-10-16 19:31:41 +08:00
curl 'http://http://api.bilibili.com/x/relation/batch/modify' \
--data-urlencode 'fid=1,2,3,4,5' \
--data-urlencode 'act=1' \
--data-urlencode 're_src=11' \
--data-urlencode 'csrf=xxx' \
添加【查询登录记录】接口 修改若干【评论区】接口 添加【批量修改关系】和【批量查询关系】接口
2020-10-03 00:53:53 +08:00
-b 'SESSDATA=xxx'
```
<details>
<summary>查看响应示例：</summary>
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"failed_fids": []
}
}
```
</details>
添加【视频在线人数】api，更新视频分区信息，并勘误
2021-08-20 19:54:13 +08:00
## 查询用户与自己关系_仅查关注
例行更新
2020-03-17 11:05:26 +08:00
添加bvID相关和POST参数类型
2020-03-23 16:46:13 +08:00
> http://api.bilibili.com/x/relation
例行更新
2020-03-17 11:05:26 +08:00
优化文档格式
2020-07-14 18:44:44 +08:00
*请求方式：GET*
例行更新
2020-03-17 11:05:26 +08:00
添加【视频在线人数】api，更新视频分区信息，并勘误
2021-08-20 19:54:13 +08:00
认证方式：Cookie(SESSDATA)或APP
优化格式&添加图标
2020-03-21 14:37:55 +08:00
优化文档格式
2020-06-08 23:06:53 +08:00
**url参数：**
例行更新
2020-03-17 11:05:26 +08:00
添加【查询登录记录】接口 修改若干【评论区】接口 添加【批量修改关系】和【批量查询关系】接口
2020-10-03 00:53:53 +08:00
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------ | ----------- | ---- |
| access_key | str | APP登录Token | APP方式必要 | |
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
| fid | num | 目标用户mid | 必要 | |
例行更新
2020-03-17 11:05:26 +08:00
**json回复：**
优化文档格式
2020-04-16 18:47:19 +08:00
根对象：
添加微信&支付宝方式充电api
2020-03-25 12:05:53 +08:00
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------- |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-400：请求错误 |
| message | str | 错误信息 | 默认为0 |
继续修改文档格式 并添加频道相关
2020-07-17 23:50:28 +08:00
| ttl | num | 1 | |
添加微信&支付宝方式充电api
2020-03-25 12:05:53 +08:00
| data | obj | 信息本体 | |
例行更新
2020-03-17 11:05:26 +08:00
优化格式&添加图标
2020-03-21 14:37:55 +08:00
`data`对象：
例行更新
2020-03-17 11:05:26 +08:00
添加微信&支付宝方式充电api
2020-03-25 12:05:53 +08:00
| 字段 | 类型 | 内容 | 备注 |
| --------- | ---------------------------------------- | ------------ | --------------------------------------- |
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
| mid | num | 目标用户mid | |
添加【查询登录记录】接口 修改若干【评论区】接口 添加【批量修改关系】和【批量查询关系】接口
2020-10-03 00:53:53 +08:00
| attribute | num | 关注属性 | 0：未关注<br />2：已关注<br />6：已互粉<br />128：拉黑 |
添加微信&支付宝方式充电api
2020-03-25 12:05:53 +08:00
| mtime | num | 关注对方时间 | 时间戳<br />未关注为0 |
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
| tag | null默认分组<br />array存在至少一个分组 | 分组id | |
添加微信&支付宝方式充电api
2020-03-25 12:05:53 +08:00
| special | num | 特别关注标志 | 0：否<br />1：是 |
例行更新
2020-03-17 11:05:26 +08:00
优化格式&添加图标
2020-03-21 14:37:55 +08:00
`tag`数组：
例行更新
2020-03-17 11:05:26 +08:00
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ----------------------- | ---- |
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
| 0 | num | 位于分组1的分组 | |
添加【视频在线人数】api，更新视频分区信息，并勘误
2021-08-20 19:54:13 +08:00
| n | num | 位于分组(n+1)的分组 | |
例行更新
2020-03-17 11:05:26 +08:00
| …… | num | …… | …… |
优化文档格式
2020-04-16 18:47:19 +08:00
**示例：**
例行更新
2020-03-17 11:05:26 +08:00
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
可得对于`mid=258150656`的用户，在`2018/10/28 0:51:41`时关注，且设为特别关注，并位于为`-10`分组中
添加bvID相关和POST参数类型
2020-03-23 16:46:13 +08:00
优化文档格式
2020-07-14 18:44:44 +08:00
```shell
大量勘误 添加【指定用户的最近投币列表】接口
2020-10-16 19:31:41 +08:00
curl -G 'http://http://api.bilibili.com/x/relation' \
--data-urlencode 'fid=258150656' \
优化文档格式
2020-07-14 18:44:44 +08:00
-b 'SESSDATA=xxx'
```
例行更新
2020-03-17 11:05:26 +08:00
格式化
2020-08-31 16:37:38 +08:00
<details>
<summary>查看响应示例：</summary>
例行更新
2020-03-17 11:05:26 +08:00
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"mid": 258150656,
"attribute": 2,
"mtime": 1540659101,
"tag": [-10],
"special": 1
}
}
```
格式化
2020-08-31 16:37:38 +08:00
</details>
添加【视频在线人数】api，更新视频分区信息，并勘误
2021-08-20 19:54:13 +08:00
## 查询用户与自己关系_互相
例行更新
2020-03-17 11:05:26 +08:00
添加bvID相关和POST参数类型
2020-03-23 16:46:13 +08:00
> http://api.bilibili.com/x/space/acc/relation
例行更新
2020-03-17 11:05:26 +08:00
优化文档格式
2020-07-14 18:44:44 +08:00
*请求方式：GET*
例行更新
2020-03-17 11:05:26 +08:00
添加【视频在线人数】api，更新视频分区信息，并勘误
2021-08-20 19:54:13 +08:00
认证方式：Cookie(SESSDATA)或APP
优化格式&添加图标
2020-03-21 14:37:55 +08:00
优化文档格式
2020-06-08 23:06:53 +08:00
**url参数：**
例行更新
2020-03-17 11:05:26 +08:00
添加【查询登录记录】接口 修改若干【评论区】接口 添加【批量修改关系】和【批量查询关系】接口
2020-10-03 00:53:53 +08:00
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------ | ----------- | ---- |
| access_key | str | APP登录Token | APP方式必要 | |
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
| mid | num | 目标用户mid | 必要 | |
例行更新
2020-03-17 11:05:26 +08:00
**json回复：**
优化文档格式
2020-04-16 18:47:19 +08:00
根对象：
添加微信&支付宝方式充电api
2020-03-25 12:05:53 +08:00
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------- |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-400：请求错误 |
| message | str | 错误信息 | 默认为0 |
继续修改文档格式 并添加频道相关
2020-07-17 23:50:28 +08:00
| ttl | num | 1 | |
添加微信&支付宝方式充电api
2020-03-25 12:05:53 +08:00
| data | obj | 信息本体 | |
例行更新
2020-03-17 11:05:26 +08:00
优化格式&添加图标
2020-03-21 14:37:55 +08:00
`data`对象：
例行更新
2020-03-17 11:05:26 +08:00
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | ------------------------ | ---- |
| relation | obj | 目标用户对于本用户的属性 | |
| be_relation | obj | 本用户对于目标用户的属性 | |
优化格式&添加图标
2020-03-21 14:37:55 +08:00
`data`中的`relation`对象：
例行更新
2020-03-17 11:05:26 +08:00
| 字段 | 类型 | 内容 | 备注 |
| --------- | ---------------------------------------- | ------------ | -------------- |
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
| mid | num | 对方用户mid | |
添加【查询登录记录】接口 修改若干【评论区】接口 添加【批量修改关系】和【批量查询关系】接口
2020-10-03 00:53:53 +08:00
| attribute | num | 关注属性 | 0：未关注<br />1：悄悄关注<br />2：已关注<br />6：已互粉<br />128：拉黑 |
例行更新
2020-03-17 11:05:26 +08:00
| mtime | num | 关注对方时间 | 互关后刷新时间 |
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
| tag | null默认分组<br />array存在至少一个分组 | 分组id | |
添加【查询登录记录】接口 修改若干【评论区】接口 添加【批量修改关系】和【批量查询关系】接口
2020-10-03 00:53:53 +08:00
| special | num | 特别关注标志 | 0：否<br />1：是 |
例行更新
2020-03-17 11:05:26 +08:00
优化格式&添加图标
2020-03-21 14:37:55 +08:00
`data`中的`be_relation`对象：
例行更新
2020-03-17 11:05:26 +08:00
| 字段 | 类型 | 内容 | 备注 |
| --------- | ---------------------------------------- | ------------ | -------------- |
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
| mid | num | 自己的mid | |
添加【查询登录记录】接口 修改若干【评论区】接口 添加【批量修改关系】和【批量查询关系】接口
2020-10-03 00:53:53 +08:00
| attribute | num | 关注属性 | 0：未关注<br />1：悄悄关注<br />2：已关注<br />6：已互粉<br />128：拉黑 |
例行更新
2020-03-17 11:05:26 +08:00
| mtime | num | 成为粉丝时间 | 互关后刷新时间 |
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
| tag | null默认分组<br />array存在至少一个分组 | 分组id | |
添加【查询登录记录】接口 修改若干【评论区】接口 添加【批量修改关系】和【批量查询关系】接口
2020-10-03 00:53:53 +08:00
| special | num | 特别关注标志 | 0：否<br />1：是 |
例行更新
2020-03-17 11:05:26 +08:00
优化格式&添加图标
2020-03-21 14:37:55 +08:00
`be_relation`与`relation`中的`tag`数组：
例行更新
2020-03-17 11:05:26 +08:00
添加【视频在线人数】api，更新视频分区信息，并勘误
2021-08-20 19:54:13 +08:00
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | --------------------- | ---- |
| 0 | num | 位于分组1的分组id | |
| n | num | 位于分组(n+1)的分组id | |
| …… | num | …… | …… |
例行更新
2020-03-17 11:05:26 +08:00
优化文档格式
2020-04-16 18:47:19 +08:00
**示例：**
例行更新
2020-03-17 11:05:26 +08:00
添加【视频在线人数】api，更新视频分区信息，并勘误
2021-08-20 19:54:13 +08:00
可得对于`mid=15858903`的用户，在`2019/1/24 14:24:19`时关注了对方，且互相关注，自己将对方特别关注，并同时位于为`-10`和`194110`的分组中，对方也将自己设为特别关注，并同时位于为`-10`和`56502`的分组中(虽然我看不到)
添加bvID相关和POST参数类型
2020-03-23 16:46:13 +08:00
优化文档格式
2020-07-14 18:44:44 +08:00
```shell
大量勘误 添加【指定用户的最近投币列表】接口
2020-10-16 19:31:41 +08:00
curl -G 'http://api.bilibili.com/x/space/acc/relation' \
--data-urlencode 'mid=15858903' \
优化文档格式
2020-07-14 18:44:44 +08:00
-b 'SESSDATA=xxx'
```
例行更新
2020-03-17 11:05:26 +08:00
格式化
2020-08-31 16:37:38 +08:00
<details>
<summary>查看响应示例：</summary>
例行更新
2020-03-17 11:05:26 +08:00
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"relation": {
"mid": 15858903,
"attribute": 6,
"mtime": 1548311059,
"tag": [-10, 194110],
"special": 1,
"is_followed": false
},
"be_relation": {
"mid": 293793435,
"attribute": 6,
"mtime": 1548311059,
"tag": [56502, -10],
"special": 1,
"is_followed": false
}
}
}
```
格式化
2020-08-31 16:37:38 +08:00
</details>
添加【查询登录记录】接口 修改若干【评论区】接口 添加【批量修改关系】和【批量查询关系】接口
2020-10-03 00:53:53 +08:00
## 批量查询用户与自己关系
> http://api.bilibili.com/x/relation/relations
*请求方式：GET*
添加【视频在线人数】api，更新视频分区信息，并勘误
2021-08-20 19:54:13 +08:00
认证方式：Cookie(SESSDATA)或APP
添加【查询登录记录】接口 修改若干【评论区】接口 添加【批量修改关系】和【批量查询关系】接口
2020-10-03 00:53:53 +08:00
**url参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------ | ----------- | ------------------- |
| access_key | str | APP登录Token | APP方式必要 | |
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
| fids | nums | 目标用户mid | 必要 | 每个之间用`,`间隔 |
添加【查询登录记录】接口 修改若干【评论区】接口 添加【批量修改关系】和【批量查询关系】接口
2020-10-03 00:53:53 +08:00
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------- |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-400：请求错误 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data`对象：
| 字段 | 类型 | 内容 | 备注 |
| --------- | ---- | ---------- | ---- |
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
| {用户mid} | obj | 关注的用户 | 下同 |
添加【查询登录记录】接口 修改若干【评论区】接口 添加【批量修改关系】和【批量查询关系】接口
2020-10-03 00:53:53 +08:00
| …… | obj | …… | |
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
`{用户mid}`对象：
添加【查询登录记录】接口 修改若干【评论区】接口 添加【批量修改关系】和【批量查询关系】接口
2020-10-03 00:53:53 +08:00
| 字段 | 类型 | 内容 | 备注 |
| --------- | --------------------------------------- | ------------ | ------------------------------------------------------------ |
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
| mid | num | 目标用户mid | |
添加【查询登录记录】接口 修改若干【评论区】接口 添加【批量修改关系】和【批量查询关系】接口
2020-10-03 00:53:53 +08:00
| attribute | num | 关注属性 | 0：未关注<br />1：悄悄关注<br />2：已关注<br />6：已互粉<br />128：拉黑 |
| mtime | num | 关注对方时间 | 时间戳<br />未关注为0 |
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
| tag | null默认分组<br />array存在至少一个分组 | 分组id | |
添加【查询登录记录】接口 修改若干【评论区】接口 添加【批量修改关系】和【批量查询关系】接口
2020-10-03 00:53:53 +08:00
| special | num | 特别关注标志 | 0：否<br />1：是 |
`tag`数组：
添加【视频在线人数】api，更新视频分区信息，并勘误
2021-08-20 19:54:13 +08:00
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | --------------------- | ---- |
| 0 | num | 位于分组1的分组id | |
| n | num | 位于分组(n+1)的分组id | |
| …… | num | …… | …… |
添加【查询登录记录】接口 修改若干【评论区】接口 添加【批量修改关系】和【批量查询关系】接口
2020-10-03 00:53:53 +08:00
**示例：**
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
批量查询`mid=1,2,3,4,5`的关系
添加【查询登录记录】接口 修改若干【评论区】接口 添加【批量修改关系】和【批量查询关系】接口
2020-10-03 00:53:53 +08:00
```shell
大量勘误 添加【指定用户的最近投币列表】接口
2020-10-16 19:31:41 +08:00
curl -G 'http://http://api.bilibili.com/x/relation/relations' \
--data-urlencode 'fid=258150656' \
添加【查询登录记录】接口 修改若干【评论区】接口 添加【批量修改关系】和【批量查询关系】接口
2020-10-03 00:53:53 +08:00
-b 'SESSDATA=xxx'
```
<details>
<summary>查看响应示例：</summary>
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"1": {
"mid": 1,
"attribute": 2,
"mtime": 1601654227,
"tag": null,
"special": 0
},
"2": {
"mid": 2,
"attribute": 2,
"mtime": 1601654225,
"tag": null,
"special": 0
}
}
}
```
</details>
例行更新
2020-03-17 11:05:26 +08:00
## 关注分组相关
### 查询关注分组列表
添加bvID相关和POST参数类型
2020-03-23 16:46:13 +08:00
> http://api.bilibili.com/x/relation/tags
例行更新
2020-03-17 11:05:26 +08:00
优化文档格式
2020-07-14 18:44:44 +08:00
*请求方式：GET*
例行更新
2020-03-17 11:05:26 +08:00
添加【视频在线人数】api，更新视频分区信息，并勘误
2021-08-20 19:54:13 +08:00
认证方式：Cookie(SESSDATA)或APP
添加【查询登录记录】接口 修改若干【评论区】接口 添加【批量修改关系】和【批量查询关系】接口
2020-10-03 00:53:53 +08:00
**url参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------ | ----------- | ---- |
| access_key | str | APP登录Token | APP方式必要 | |
优化格式&添加图标
2020-03-21 14:37:55 +08:00
例行更新
2020-03-17 11:05:26 +08:00
**json回复：**
优化文档格式
2020-04-16 18:47:19 +08:00
根对象：
添加微信&支付宝方式充电api
2020-03-25 12:05:53 +08:00
| 字段 | 类型 | 内容 | 备注 |
| ------- | ------ | -------- | ----------------------------- |
| code | num | 返回值 | 0：成功<br />-101：账号未登录 |
| message | str | 错误信息 | 默认为0 |
继续修改文档格式 并添加频道相关
2020-07-17 23:50:28 +08:00
| ttl | num | 1 | |
添加评论区明细以及用户最近的游戏
2020-06-12 14:10:21 +08:00
| data | array | 分组列表 | |
例行更新
2020-03-17 11:05:26 +08:00
优化格式&添加图标
2020-03-21 14:37:55 +08:00
`data`数组：
例行更新
2020-03-17 11:05:26 +08:00
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ------------ | ---- |
| 0 | obj | 特别关注分组 | |
| 1 | obj | 默认分组 | |
| n | obj | 其他分组 | |
| …… | num | …… | …… |
优化格式&添加图标
2020-03-21 14:37:55 +08:00
数组`data`中的对象：
例行更新
2020-03-17 11:05:26 +08:00
| 字段 | 类型 | 内容 | 备注 |
| ----- | ---- | ---------- | ---------------------------------- |
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
| tagid | num | 分组id | 特别关注恒为-10<br />默认分组恒为0 |
例行更新
2020-03-17 11:05:26 +08:00
| name | str | 分组名称 | |
| count | num | 分组成员数 | |
优化文档格式
2020-04-16 18:47:19 +08:00
**示例：**
例行更新
2020-03-17 11:05:26 +08:00
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
查询所有的分组的名字以及id
添加bvID相关和POST参数类型
2020-03-23 16:46:13 +08:00
优化文档格式
2020-07-14 18:44:44 +08:00
```shell
大量勘误 添加【指定用户的最近投币列表】接口
2020-10-16 19:31:41 +08:00
curl 'http://api.bilibili.com/x/relation/tags' \
优化文档格式
2020-07-14 18:44:44 +08:00
-b 'SESSDATA=xxx'
```
例行更新
2020-03-17 11:05:26 +08:00
格式化
2020-08-31 16:37:38 +08:00
<details>
<summary>查看响应示例：</summary>
例行更新
2020-03-17 11:05:26 +08:00
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": [{
"tagid": -10,
"name": "特别关注",
"count": 16
}, {
"tagid": 0,
"name": "默认分组",
"count": 536
},{
"tagid": 194111,
"name": "我的同学",
"count": 16
},
…………
]
}
```
格式化
2020-08-31 16:37:38 +08:00
</details>
例行更新
2020-03-17 11:05:26 +08:00
### 查询关注分组明细
添加bvID相关和POST参数类型
2020-03-23 16:46:13 +08:00
> http://api.bilibili.com/x/relation/tag
例行更新
2020-03-17 11:05:26 +08:00
优化文档格式
2020-07-14 18:44:44 +08:00
*请求方式：GET*
例行更新
2020-03-17 11:05:26 +08:00
添加【视频在线人数】api，更新视频分区信息，并勘误
2021-08-20 19:54:13 +08:00
认证方式：Cookie(SESSDATA)或APP
优化格式&添加图标
2020-03-21 14:37:55 +08:00
优化文档格式
2020-06-08 23:06:53 +08:00
**url参数：**
例行更新
2020-03-17 11:05:26 +08:00
添加【关注列表】排序参数 添加【互动弹幕获取】相关接口
2020-10-04 23:46:02 +08:00
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------ | ----------- | ------------------------------------------------------- |
| access_key | str | APP登录Token | APP方式必要 | |
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
| tagid | num | 分组id | 必要 | 特别关注恒为-10<br />默认分组恒为0 |
添加【关注列表】排序参数 添加【互动弹幕获取】相关接口
2020-10-04 23:46:02 +08:00
| order_type | str | 排序方式 | 非必要 | 按照关注顺序排列：留空<br />按照最常访问排列：attention |
| ps | num | 每页项数 | 非必要 | 默认为50 |
| pn | num | 页数 | 非必要 | 默认为1 |
例行更新
2020-03-17 11:05:26 +08:00
**json回复：**
优化文档格式
2020-04-16 18:47:19 +08:00
根对象：
例行更新
2020-03-17 11:05:26 +08:00
| 字段 | 类型 | 内容 | 备注 |
| ------- | ------ | -------- | ------------------------------------------------------------ |
修改并补全搜索相关
2020-07-03 19:36:02 +08:00
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-400：请求错误<br />22104：该分组不存在 |
例行更新
2020-03-17 11:05:26 +08:00
| message | str | 错误信息 | 默认为0 |
继续修改文档格式 并添加频道相关
2020-07-17 23:50:28 +08:00
| ttl | num | 1 | |
添加评论区明细以及用户最近的游戏
2020-06-12 14:10:21 +08:00
| data | array | 成员列表 | |
例行更新
2020-03-17 11:05:26 +08:00
优化格式&添加图标
2020-03-21 14:37:55 +08:00
`data`数组：
例行更新
2020-03-17 11:05:26 +08:00
添加【视频在线人数】api，更新视频分区信息，并勘误
2021-08-20 19:54:13 +08:00
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ------------- | ---------------- |
| 0 | obj | 成员信息1 | |
| n | obj | 成员信息(n+1) | 按照添加顺序排序 |
| …… | obj | …… | …… |
例行更新
2020-03-17 11:05:26 +08:00
优化格式&添加图标
2020-03-21 14:37:55 +08:00
数组`data`中的对象：
例行更新
2020-03-17 11:05:26 +08:00
增加了若干个人空间的api
2020-04-10 11:17:32 +08:00
| 字段 | 类型 | 内容 | 备注 |
| --------------- | ---- | ----------- | ---- |
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
| mid | num | 用户mid | |
增加了若干个人空间的api
2020-04-10 11:17:32 +08:00
| uname | str | 用户昵称 | |
| face | str | 用户头像url | |
| sign | str | 用户签名 | |
| official_verify | obj | 认证信息 | |
| vip | obj | 会员信息 | |
例行更新
2020-03-17 11:05:26 +08:00
优化格式&添加图标
2020-03-21 14:37:55 +08:00
数组`data`中的对象中的`official_verify`对象：
例行更新
2020-03-17 11:05:26 +08:00
添加微信&支付宝方式充电api
2020-03-25 12:05:53 +08:00
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ------------ | ------------------- |
| type | num | 用户认证类型 | -1：无<br />1：认证 |
| desc | str | 用户认证信息 | 无为空 |
例行更新
2020-03-17 11:05:26 +08:00
优化格式&添加图标
2020-03-21 14:37:55 +08:00
数组`data`中的对象中的`vip`对象：
例行更新
2020-03-17 11:05:26 +08:00
添加微信&支付宝方式充电api
2020-03-25 12:05:53 +08:00
| 字段 | 类型 | 内容 | 备注 |
| ------------- | ---- | ------------ | ----------------------------------- |
| 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 | ？？？ | 作用尚不明确 |
例行更新
2020-03-17 11:05:26 +08:00
优化格式&添加图标
2020-03-21 14:37:55 +08:00
数组`data`中的对象中的`label`对象：
例行更新
2020-03-17 11:05:26 +08:00
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ------------ |
| path | str | 空 | 作用尚不明确 |
优化文档格式
2020-04-16 18:47:19 +08:00
**示例：**
例行更新
2020-03-17 11:05:26 +08:00
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
以每页2项的方式获取了id为`207542`分组的第1页的粉丝明细，按照关注顺序
添加bvID相关和POST参数类型
2020-03-23 16:46:13 +08:00
优化文档格式
2020-07-14 18:44:44 +08:00
```shell
大量勘误 添加【指定用户的最近投币列表】接口
2020-10-16 19:31:41 +08:00
curl -G 'http://api.bilibili.com/x/relation/tag' \
--data-urlencode 'tagid=207542' \
--data-urlencode 'order_type=' \
--data-urlencode 'ps=2' \
--data-urlencode 'pn=1' \
优化文档格式
2020-07-14 18:44:44 +08:00
-b 'SESSDATA=xxx'
```
例行更新
2020-03-17 11:05:26 +08:00
格式化
2020-08-31 16:37:38 +08:00
<details>
<summary>查看响应示例：</summary>
例行更新
2020-03-17 11:05:26 +08:00
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": [{
"mid": 420831218,
"uname": "支付宝Alipay",
"face": "http://i2.hdslb.com/bfs/face/aaf18aeb2d9822e28a590bd8d878572ca8c59e04.jpg",
"sign": "阿支来了，关注点赞转发投币四连走起！",
"official_verify": {
"type": 1,
"desc": "支付宝官方账号"
},
"vip": {
"vipType": 1,
"vipDueDate": 1585065600000,
"dueRemark": "",
"accessStatus": 0,
"vipStatus": 1,
"vipStatusWarn": "",
"themeType": 0,
"label": {
"path": ""
}
}
}, {
"mid": 125086406,
"uname": "MSI微星科技",
"face": "http://i1.hdslb.com/bfs/face/a844760e4e491677615b39399bc761e74c579bb4.jpg",
"sign": "你好，这里是微星显卡官方！专注显卡三十年，欢迎私信咨询或提问MSI",
"official_verify": {
"type": 1,
"desc": "微星科技官方账号"
},
"vip": {
"vipType": 1,
"vipDueDate": 1540656000000,
"dueRemark": "",
"accessStatus": 0,
"vipStatus": 0,
"vipStatusWarn": "",
"themeType": 0,
"label": {
"path": ""
}
}
}]
}
```
格式化
2020-08-31 16:37:38 +08:00
</details>
例行更新
2020-03-17 11:05:26 +08:00
### 查询目标用户所在的分组
添加bvID相关和POST参数类型
2020-03-23 16:46:13 +08:00
> http://api.bilibili.com/x/relation/tag/user
例行更新
2020-03-17 11:05:26 +08:00
优化文档格式
2020-07-14 18:44:44 +08:00
*请求方式：GET*
例行更新
2020-03-17 11:05:26 +08:00
添加【视频在线人数】api，更新视频分区信息，并勘误
2021-08-20 19:54:13 +08:00
认证方式：Cookie(SESSDATA)或APP
优化格式&添加图标
2020-03-21 14:37:55 +08:00
修改并补全搜索相关
2020-07-03 19:36:02 +08:00
**url参数：**
例行更新
2020-03-17 11:05:26 +08:00
添加【查询登录记录】接口 修改若干【评论区】接口 添加【批量修改关系】和【批量查询关系】接口
2020-10-03 00:53:53 +08:00
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------ | ----------- | ---- |
| access_key | str | APP登录Token | APP方式必要 | |
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
| fid | num | 目标用户mid | 必要 | |
例行更新
2020-03-17 11:05:26 +08:00
**json回复：**
优化文档格式
2020-04-16 18:47:19 +08:00
根对象：
添加微信&支付宝方式充电api
2020-03-25 12:05:53 +08:00
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------- |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-400：请求错误 |
| message | str | 错误信息 | 默认为0 |
继续修改文档格式 并添加频道相关
2020-07-17 23:50:28 +08:00
| ttl | num | 1 | |
添加微信&支付宝方式充电api
2020-03-25 12:05:53 +08:00
| data | obj | 信息本体 | |
例行更新
2020-03-17 11:05:26 +08:00
优化格式&添加图标
2020-03-21 14:37:55 +08:00
`data`对象：
例行更新
2020-03-17 11:05:26 +08:00
| 字段 | 类型 | 内容 | 备注 |
| ------------------- | ---- | --------- | ---- |
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
| {加入的分组id 1} | str | 分组1名称 | |
| {加入的分组id n} | str | 分组n名称 | |
例行更新
2020-03-17 11:05:26 +08:00
| …… | str | …… | |
优化文档格式
2020-04-16 18:47:19 +08:00
**示例：**
例行更新
2020-03-17 11:05:26 +08:00
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
查询用户`mid=319214221`存在的所有分组和名称
添加bvID相关和POST参数类型
2020-03-23 16:46:13 +08:00
优化文档格式
2020-07-14 18:44:44 +08:00
```shell
大量勘误 添加【指定用户的最近投币列表】接口
2020-10-16 19:31:41 +08:00
curl -G 'http://api.bilibili.com/x/relation/tag/user' \
--data-urlencode 'fid=319214221' \
优化文档格式
2020-07-14 18:44:44 +08:00
-b 'SESSDATA=xxx'
```
例行更新
2020-03-17 11:05:26 +08:00
格式化
2020-08-31 16:37:38 +08:00
<details>
<summary>查看响应示例：</summary>
例行更新
2020-03-17 11:05:26 +08:00
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"-10": "特别关注",
"194111": "我的同学"
}
}
```
格式化
2020-08-31 16:37:38 +08:00
</details>
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
### 查询所有特别关注的mid
修改并补全搜索相关
2020-07-03 19:36:02 +08:00
> http://api.bilibili.com/x/relation/tag/special
优化文档格式
2020-07-14 18:44:44 +08:00
*请求方式：GET*
添加【视频在线人数】api，更新视频分区信息，并勘误
2021-08-20 19:54:13 +08:00
认证方式：Cookie(SESSDATA)或APP
添加【查询登录记录】接口 修改若干【评论区】接口 添加【批量修改关系】和【批量查询关系】接口
2020-10-03 00:53:53 +08:00
**url参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------ | ----------- | ---- |
| access_key | str | APP登录Token | APP方式必要 | |
修改并补全搜索相关
2020-07-03 19:36:02 +08:00
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ----- | -------- | ----------------------------- |
| code | num | 返回值 | 0：成功<br />-101：账号未登录 |
| message | str | 错误信息 | 默认为0 |
继续修改文档格式 并添加频道相关
2020-07-17 23:50:28 +08:00
| ttl | num | 1 | |
修改并补全搜索相关
2020-07-03 19:36:02 +08:00
| data | array | 成员列表 | |
`data`数组：
添加【视频在线人数】api，更新视频分区信息，并勘误
2021-08-20 19:54:13 +08:00
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ------------ | ---- |
| 0 | num | 成员1mid | |
| n | num | 成员(n+1)mid | |
| …… | num | …… | …… |
修改并补全搜索相关
2020-07-03 19:36:02 +08:00
**示例：**
优化文档格式
2020-07-14 18:44:44 +08:00
```shell
大量勘误 添加【指定用户的最近投币列表】接口
2020-10-16 19:31:41 +08:00
curl 'http://api.bilibili.com/x/relation/tag/special' \
优化文档格式
2020-07-14 18:44:44 +08:00
-b 'SESSDATA=xxx'
```
修改并补全搜索相关
2020-07-03 19:36:02 +08:00
格式化
2020-08-31 16:37:38 +08:00
<details>
<summary>查看响应示例：</summary>
修改并补全搜索相关
2020-07-03 19:36:02 +08:00
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": [
500716647,
32832243,
53456,
25944552,
301839556,
427494870,
319214221,
31949159,
382666849,
258318451,
15858903,
54992199,
3379951,
392279807,
23215368,
258150656,
20165629,
22179720
]
}
```
格式化
2020-08-31 16:37:38 +08:00
</details>
优化文档格式
2020-07-14 18:44:44 +08:00
### 创建分组
例行更新
2020-03-17 11:05:26 +08:00
优化格式&添加图标
2020-03-21 14:37:55 +08:00
<img src="/imgs/add.svg" width="100" height="100" />
例行更新
2020-03-17 11:05:26 +08:00
添加bvID相关和POST参数类型
2020-03-23 16:46:13 +08:00
> http://api.bilibili.com/x/relation/tag/create
例行更新
2020-03-17 11:05:26 +08:00
优化文档格式
2020-07-14 18:44:44 +08:00
*请求方式：POST*
例行更新
2020-03-17 11:05:26 +08:00
添加【视频在线人数】api，更新视频分区信息，并勘误
2021-08-20 19:54:13 +08:00
认证方式：Cookie(SESSDATA)或APP
优化格式&添加图标
2020-03-21 14:37:55 +08:00
添加【视频在线人数】api，更新视频分区信息，并勘误
2021-08-20 19:54:13 +08:00
**正文参数( application/x-www-form-urlencoded )：**
例行更新
2020-03-17 11:05:26 +08:00
添加【视频在线人数】api，更新视频分区信息，并勘误
2021-08-20 19:54:13 +08:00
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ---------------------- | -------------- | ---------- |
| access_key | str | APP登录Token | APP方式必要 | |
| tag | str | 分组名 | 必要 | 最长16字符 |
| csrf | str | CSRF Token(位于cookie) | Cookie方式必要 | |
例行更新
2020-03-17 11:05:26 +08:00
**json回复：**
优化文档格式
2020-04-16 18:47:19 +08:00
根对象：
例行更新
2020-03-17 11:05:26 +08:00
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
添加微信&支付宝方式充电api
2020-03-25 12:05:53 +08:00
| code | num | 返回值 | 0：成功<br />-111：csrf校验失败<br />-101：账号未登录<br />-400：请求错误<br />22106：该分组已经存在<br />22103：分组名过长 |
例行更新
2020-03-17 11:05:26 +08:00
| message | str | 错误信息 | 默认为0 |
继续修改文档格式 并添加频道相关
2020-07-17 23:50:28 +08:00
| ttl | num | 1 | |
例行更新
2020-03-17 11:05:26 +08:00
| data | obj | 信息本体 | |
优化格式&添加图标
2020-03-21 14:37:55 +08:00
`data`对象：
例行更新
2020-03-17 11:05:26 +08:00
| 字段 | 类型 | 内容 | 备注 |
| ----- | ---- | -------------- | ---- |
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
| tagid | num | 创建的分组的id | |
例行更新
2020-03-17 11:05:26 +08:00
优化文档格式
2020-04-16 18:47:19 +08:00
**示例：**
例行更新
2020-03-17 11:05:26 +08:00
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
创建了名为`测试`的分组，得到id为`216677`
添加bvID相关和POST参数类型
2020-03-23 16:46:13 +08:00
优化文档格式
2020-07-14 18:44:44 +08:00
```shell
大量勘误 添加【指定用户的最近投币列表】接口
2020-10-16 19:31:41 +08:00
curl 'http://api.bilibili.com/x/relation/tag/create' \
--data-urlencode 'tag=测试' \
--data-urlencode 'csrf=xxx' \
优化文档格式
2020-07-14 18:44:44 +08:00
-b 'SESSDATA=xxx'
```
例行更新
2020-03-17 11:05:26 +08:00
格式化
2020-08-31 16:37:38 +08:00
<details>
<summary>查看响应示例：</summary>
例行更新
2020-03-17 11:05:26 +08:00
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"tagid": 216677
}
}
```
格式化
2020-08-31 16:37:38 +08:00
</details>
优化文档格式
2020-07-14 18:44:44 +08:00
### 重命名分组
例行更新
2020-03-17 11:05:26 +08:00
添加bvID相关和POST参数类型
2020-03-23 16:46:13 +08:00
> http://api.bilibili.com/x/relation/tag/update
例行更新
2020-03-17 11:05:26 +08:00
优化文档格式
2020-07-14 18:44:44 +08:00
*请求方式：POST*
例行更新
2020-03-17 11:05:26 +08:00
添加【视频在线人数】api，更新视频分区信息，并勘误
2021-08-20 19:54:13 +08:00
认证方式：Cookie(SESSDATA)或APP
优化格式&添加图标
2020-03-21 14:37:55 +08:00
添加【视频在线人数】api，更新视频分区信息，并勘误
2021-08-20 19:54:13 +08:00
**正文参数( application/x-www-form-urlencoded )：**
例行更新
2020-03-17 11:05:26 +08:00
添加【视频在线人数】api，更新视频分区信息，并勘误
2021-08-20 19:54:13 +08:00
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ---------------------- | -------------- | ---------- |
| access_key | str | APP登录Token | APP方式必要 | |
| tagid | num | 分组id | 必要 | |
| name | str | 新名称 | 必要 | 最长16字符 |
| csrf | str | CSRF Token(位于cookie) | Cookie方式必要 | |
例行更新
2020-03-17 11:05:26 +08:00
**json回复：**
优化文档格式
2020-04-16 18:47:19 +08:00
根对象：
例行更新
2020-03-17 11:05:26 +08:00
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
添加微信&支付宝方式充电api
2020-03-25 12:05:53 +08:00
| code | num | 返回值 | 0：成功<br />-111：csrf校验失败<br />-101：账号未登录<br />-400：请求错误<br />22103：分组名过长<br />22104：该分组不存在 |
例行更新
2020-03-17 11:05:26 +08:00
| message | str | 错误信息 | 默认为0 |
继续修改文档格式 并添加频道相关
2020-07-17 23:50:28 +08:00
| ttl | num | 1 | |
例行更新
2020-03-17 11:05:26 +08:00
优化文档格式
2020-04-16 18:47:19 +08:00
**示例：**
例行更新
2020-03-17 11:05:26 +08:00
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
把id为`194112`的分组更名为`膜法师`
添加bvID相关和POST参数类型
2020-03-23 16:46:13 +08:00
优化文档格式
2020-07-14 18:44:44 +08:00
```shell
大量勘误 添加【指定用户的最近投币列表】接口
2020-10-16 19:31:41 +08:00
curl 'http://api.bilibili.com/x/relation/tag/update' \
--data-urlencode 'tagid=194112' \
--data-urlencode 'name=膜法师' \
--data-urlencode 'csrf=xxx' \
优化文档格式
2020-07-14 18:44:44 +08:00
-b 'SESSDATA=xxx'
```
例行更新
2020-03-17 11:05:26 +08:00
格式化
2020-08-31 16:37:38 +08:00
<details>
<summary>查看响应示例：</summary>
例行更新
2020-03-17 11:05:26 +08:00
```json
{
"code": 0,
"message": "0",
"ttl": 1
}
```
格式化
2020-08-31 16:37:38 +08:00
</details>
优化文档格式
2020-07-14 18:44:44 +08:00
### 删除分组
例行更新
2020-03-17 11:05:26 +08:00
优化格式&添加图标
2020-03-21 14:37:55 +08:00
<img src="/imgs/delete.svg" width="100" height="100" />
例行更新
2020-03-17 11:05:26 +08:00
添加bvID相关和POST参数类型
2020-03-23 16:46:13 +08:00
> http://api.bilibili.com/x/relation/tag/del
例行更新
2020-03-17 11:05:26 +08:00
优化文档格式
2020-07-14 18:44:44 +08:00
*请求方式：POST*
例行更新
2020-03-17 11:05:26 +08:00
添加【视频在线人数】api，更新视频分区信息，并勘误
2021-08-20 19:54:13 +08:00
认证方式：Cookie(SESSDATA)或APP
优化格式&添加图标
2020-03-21 14:37:55 +08:00
添加【视频在线人数】api，更新视频分区信息，并勘误
2021-08-20 19:54:13 +08:00
**正文参数( application/x-www-form-urlencoded )：**
例行更新
2020-03-17 11:05:26 +08:00
添加【视频在线人数】api，更新视频分区信息，并勘误
2021-08-20 19:54:13 +08:00
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ---------------------- | -------------- | ---- |
| access_key | str | APP登录Token | APP方式必要 | |
| tagid | num | 分组id | 必要 | |
| csrf | str | CSRF Token(位于cookie) | Cookie方式必要 | |
例行更新
2020-03-17 11:05:26 +08:00
**json回复：**
优化文档格式
2020-04-16 18:47:19 +08:00
根对象：
例行更新
2020-03-17 11:05:26 +08:00
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
添加微信&支付宝方式充电api
2020-03-25 12:05:53 +08:00
| code | num | 返回值 | 0：成功<br />-111：csrf校验失败<br />-101：账号未登录<br />-400：请求错误 |
例行更新
2020-03-17 11:05:26 +08:00
| message | str | 错误信息 | 默认为0 |
继续修改文档格式 并添加频道相关
2020-07-17 23:50:28 +08:00
| ttl | num | 1 | |
例行更新
2020-03-17 11:05:26 +08:00
示例：
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
删除分组id为`216699`的分组
添加bvID相关和POST参数类型
2020-03-23 16:46:13 +08:00
优化文档格式
2020-07-14 18:44:44 +08:00
```shell
大量勘误 添加【指定用户的最近投币列表】接口
2020-10-16 19:31:41 +08:00
curl 'http://api.bilibili.com/x/relation/tag/del' \
--data-urlencode 'tagid=216699' \
--data-urlencode 'csrf=xxx' \
优化文档格式
2020-07-14 18:44:44 +08:00
-b 'SESSDATA=xxx'
```
例行更新
2020-03-17 11:05:26 +08:00
格式化
2020-08-31 16:37:38 +08:00
<details>
<summary>查看响应示例：</summary>
例行更新
2020-03-17 11:05:26 +08:00
```json
{
"code": 0,
"message": "0",
"ttl": 1
}
```
格式化
2020-08-31 16:37:38 +08:00
</details>
添加【视频在线人数】api，更新视频分区信息，并勘误
2021-08-20 19:54:13 +08:00
### 修改分组成员
例行更新
2020-03-17 11:05:26 +08:00
优化格式&添加图标
2020-03-21 14:37:55 +08:00
<img src="/imgs/add.svg" width="100" height="100" />
例行更新
2020-03-17 11:05:26 +08:00
添加bvID相关和POST参数类型
2020-03-23 16:46:13 +08:00
> http://api.bilibili.com/x/relation/tags/addUsers
例行更新
2020-03-17 11:05:26 +08:00
优化文档格式
2020-07-14 18:44:44 +08:00
*请求方式：POST*
例行更新
2020-03-17 11:05:26 +08:00
添加【视频在线人数】api，更新视频分区信息，并勘误
2021-08-20 19:54:13 +08:00
认证方式：Cookie(SESSDATA)或APP
如需删除分组中的成员，请将`tagids`设为0，即移动至默认分组，而不是取关
优化格式&添加图标
2020-03-21 14:37:55 +08:00
添加【视频在线人数】api，更新视频分区信息，并勘误
2021-08-20 19:54:13 +08:00
**正文参数( application/x-www-form-urlencoded )：**
例行更新
2020-03-17 11:05:26 +08:00
添加【查询登录记录】接口 修改若干【评论区】接口 添加【批量修改关系】和【批量查询关系】接口
2020-10-03 00:53:53 +08:00
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------------------ | -------------- | ------------------- |
| access_key | str | APP登录Token | APP方式必要 | |
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
| fids | nums | 目标用户mid | 必要 | 每个之间用`,`间隔 |
| tagids | nums | 分组id | 必要 | 每个之间用`,`间隔 |
添加【视频在线人数】api，更新视频分区信息，并勘误
2021-08-20 19:54:13 +08:00
| csrf | str | CSRF Token(位于cookie) | Cookie方式必要 | |
例行更新
2020-03-17 11:05:26 +08:00
**json回复：**
优化文档格式
2020-04-16 18:47:19 +08:00
根对象：
例行更新
2020-03-17 11:05:26 +08:00
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
增加了若干个人空间的api
2020-04-10 11:17:32 +08:00
| code | num | 返回值 | 0：成功<br />-111：csrf校验失败<br />-101：账号未登录<br />-400：请求错误<br />22104：无权限<br />22105：未关注 |
例行更新
2020-03-17 11:05:26 +08:00
| message | str | 错误信息 | 默认为0 |
继续修改文档格式 并添加频道相关
2020-07-17 23:50:28 +08:00
| ttl | num | 1 | |
例行更新
2020-03-17 11:05:26 +08:00
优化文档格式
2020-04-16 18:47:19 +08:00
**示例：**
例行更新
2020-03-17 11:05:26 +08:00
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
把关注用户`mid=205631797`同时添加分组关系到id为`-10`和`207542`的分组中
添加bvID相关和POST参数类型
2020-03-23 16:46:13 +08:00
优化文档格式
2020-07-14 18:44:44 +08:00
```shell
大量勘误 添加【指定用户的最近投币列表】接口
2020-10-16 19:31:41 +08:00
curl 'http://api.bilibili.com/x/relation/tags/addUsers' \
--data-urlencode 'fids=205631797' \
--data-urlencode 'tagids=-10,207542' \
--data-urlencode 'csrf=xxx' \
优化文档格式
2020-07-14 18:44:44 +08:00
-b 'SESSDATA=xxx'
```
例行更新
2020-03-17 11:05:26 +08:00
格式化
2020-08-31 16:37:38 +08:00
<details>
<summary>查看响应示例：</summary>
例行更新
2020-03-17 11:05:26 +08:00
```json
{
"code": 0,
"message": "0",
"ttl": 1
}
```
格式化
2020-08-31 16:37:38 +08:00
</details>
优化文档格式
2020-07-14 18:44:44 +08:00
### 复制关注到分组
增加了若干个人空间的api
2020-04-10 11:17:32 +08:00
> http://api.bilibili.com/x/relation/tags/copyUsers
优化文档格式
2020-07-14 18:44:44 +08:00
*请求方式：POST*
增加了若干个人空间的api
2020-04-10 11:17:32 +08:00
添加【视频在线人数】api，更新视频分区信息，并勘误
2021-08-20 19:54:13 +08:00
认证方式：Cookie(SESSDATA)或APP
增加了若干个人空间的api
2020-04-10 11:17:32 +08:00
添加【视频在线人数】api，更新视频分区信息，并勘误
2021-08-20 19:54:13 +08:00
**正文参数( application/x-www-form-urlencoded )：**
增加了若干个人空间的api
2020-04-10 11:17:32 +08:00
添加【查询登录记录】接口 修改若干【评论区】接口 添加【批量修改关系】和【批量查询关系】接口
2020-10-03 00:53:53 +08:00
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------------------ | -------------- | ------------------- |
| access_key | str | APP登录Token | APP方式必要 | |
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
| fids | nums | 待复制的用户mid | 必要 | 每个之间用`,`间隔 |
| tagids | nums | 目标分组id | 必要 | 每个之间用`,`间隔 |
添加【视频在线人数】api，更新视频分区信息，并勘误
2021-08-20 19:54:13 +08:00
| csrf | str | CSRF Token(位于cookie) | Cookie方式必要 | |
增加了若干个人空间的api
2020-04-10 11:17:32 +08:00
**json回复：**
优化文档格式
2020-04-16 18:47:19 +08:00
根对象：
增加了若干个人空间的api
2020-04-10 11:17:32 +08:00
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功<br />-111：csrf校验失败<br />-101：账号未登录<br />-400：请求错误<br />22104：无权限<br />22105：未关注 |
| message | str | 错误信息 | 默认为0 |
继续修改文档格式 并添加频道相关
2020-07-17 23:50:28 +08:00
| ttl | num | 1 | |
增加了若干个人空间的api
2020-04-10 11:17:32 +08:00
优化文档格式
2020-04-16 18:47:19 +08:00
**示例：**
增加了若干个人空间的api
2020-04-10 11:17:32 +08:00
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
把关注用户`mid=4856007`和`mid=326499679`同时复制到为`231305`的分组id中
增加了若干个人空间的api
2020-04-10 11:17:32 +08:00
优化文档格式
2020-07-14 18:44:44 +08:00
```shell
大量勘误 添加【指定用户的最近投币列表】接口
2020-10-16 19:31:41 +08:00
curl 'http://api.bilibili.com/x/relation/tags/copyUsers' \
--data-urlencode 'fids=4856007,326499679' \
--data-urlencode 'tagids=231305' \
--data-urlencode 'csrf=xxx' \
优化文档格式
2020-07-14 18:44:44 +08:00
-b 'SESSDATA=xxx'
```
增加了若干个人空间的api
2020-04-10 11:17:32 +08:00
格式化
2020-08-31 16:37:38 +08:00
<details>
<summary>查看响应示例：</summary>
增加了若干个人空间的api
2020-04-10 11:17:32 +08:00
```json
{
"code":0,
"message":"0",
"ttl":1
}
```
格式化
2020-08-31 16:37:38 +08:00
</details>
优化文档格式
2020-07-14 18:44:44 +08:00
### 移动关注到分组
增加了若干个人空间的api
2020-04-10 11:17:32 +08:00
> http://api.bilibili.com/x/relation/tags/moveUsers
优化文档格式
2020-07-14 18:44:44 +08:00
*请求方式：POST*
增加了若干个人空间的api
2020-04-10 11:17:32 +08:00
添加【视频在线人数】api，更新视频分区信息，并勘误
2021-08-20 19:54:13 +08:00
认证方式：Cookie(SESSDATA)或APP
增加了若干个人空间的api
2020-04-10 11:17:32 +08:00
添加【视频在线人数】api，更新视频分区信息，并勘误
2021-08-20 19:54:13 +08:00
**正文参数( application/x-www-form-urlencoded )：**
增加了若干个人空间的api
2020-04-10 11:17:32 +08:00
添加【查询登录记录】接口 修改若干【评论区】接口 添加【批量修改关系】和【批量查询关系】接口
2020-10-03 00:53:53 +08:00
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------------ | ---- | ------------------------ | -------------- | ------------------- |
| access_key | str | APP登录Token | APP方式必要 | |
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
| beforeTagids | nums | 原分组id | 必要 | 每个之间用`,`间隔 |
| afterTagids | nums | 新分组id | 必要 | 每个之间用`,`间隔 |
| fids | nums | 待移动的用户mid | 必要 | 每个之间用`,`间隔 |
添加【视频在线人数】api，更新视频分区信息，并勘误
2021-08-20 19:54:13 +08:00
| csrf | str | CSRF Token(位于cookie) | Cookie方式必要 | |
增加了若干个人空间的api
2020-04-10 11:17:32 +08:00
**json回复：**
优化文档格式
2020-04-16 18:47:19 +08:00
根对象：
增加了若干个人空间的api
2020-04-10 11:17:32 +08:00
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功<br />-111：csrf校验失败<br />-101：账号未登录<br />-400：请求错误<br />22104：无权限<br />22105：未关注 |
| message | str | 错误信息 | 默认为0 |
继续修改文档格式 并添加频道相关
2020-07-17 23:50:28 +08:00
| ttl | num | 1 | |
增加了若干个人空间的api
2020-04-10 11:17:32 +08:00
优化文档格式
2020-04-16 18:47:19 +08:00
**示例：**
统一“id”为小写，并将“UID”改为“mid”，调整【视频属性数据】文档
2021-07-12 21:31:27 +08:00
把关注用户`mid=321173469`和`mid=327086920`同时从id为`207542`的分组移动到为`231305`的分组中
增加了若干个人空间的api
2020-04-10 11:17:32 +08:00
优化文档格式
2020-07-14 18:44:44 +08:00
```shell
大量勘误 添加【指定用户的最近投币列表】接口
2020-10-16 19:31:41 +08:00
curl 'http://api.bilibili.com/x/relation/tags/moveUsers' \
--data-urlencode 'beforeTagids=207542' \
--data-urlencode 'afterTagids=23130' \
--data-urlencode 'fids=321173469,327086920' \
--data-urlencode 'csrf=xxx' \
优化文档格式
2020-07-14 18:44:44 +08:00
-b 'SESSDATA=xxx'
```
增加了若干个人空间的api
2020-04-10 11:17:32 +08:00
格式化
2020-08-31 16:37:38 +08:00
<details>
<summary>查看响应示例：</summary>
增加了若干个人空间的api
2020-04-10 11:17:32 +08:00
```json
{
"code":0,
"message":"0",
"ttl":1
}
```
格式化
2020-08-31 16:37:38 +08:00
</details>
Reference in New Issue Copy Permalink