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

添加“查询互相关注明细”、“查询历史充电数据”API (#587)

Browse Source 
* Update relation.md

* Update relation.md

* Update info.md

* Update relation.md

* Update relation.md

* Update charge_list.md

* Update charge_list.md
This commit is contained in:
wuziqian211 2023-01-19 17:15:04 +08:00 committed by GitHub
parent 7ff8325be6
commit c3515d825e
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
3 changed files with 280 additions and 15 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

104
electric/charge_list.md
View File

@ -2,6 +2,8 @@
- [获取空间充电公示列表](#获取空间充电公示列表) - [获取空间充电公示列表](#获取空间充电公示列表)
- [获取视频充电鸣谢名单](#获取视频充电鸣谢名单) - [获取视频充电鸣谢名单](#获取视频充电鸣谢名单)
- [查询我收到的充电列表](#查询我收到的充电列表)
- [查询历史充电数据](#查询历史充电数据)
--- ---
@ -425,4 +427,104 @@ curl -L -X GET 'https://pay.bilibili.com/bk/brokerage/listForCustomerRechargeRec
} }
``` ```
</details> </details>
## 查询历史充电数据
> https://member.bilibili.com/x/h5/elec/rank/recent
*请求方式：GET*
认证方式：Cookie（SESSDATA）
**url参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| -------- | ---- | -------- | ------ | -------------------------------- |
| pn | num | 页数 | 必要 | |
| ps | num | 分页大小 | 必要 | 取值范围[1,20] |
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------- |
| code | num | 返回值 | 0：成功 |
| message | str | 错误信息 | |
| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data`对象：
| 字段 | 类型 | 内容 | 备注 |
| ----- | ----- | ------------ | ---- |
| list | array | 充电信息本体 | |
| pager | obj | 分页信息 | |
`list`数组中的对象：
| 字段 | 类型 | 内容 | 备注 |
| -------- | ---- | ---------- | ------------------- |
| aid | num | 0 | |
| bvid | str | 空 | |
| elec_num | num | 充电电池数 | |
| title | str | 空 | |
| uname | str | 空 | |
| avatar | str | 空 | |
| ctime | str | 充电时间 | yyyy-MM-dd HH:mm:ss |
`pager`对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | ------------ | ---- |
| current | num | 当前页数 | |
| size | num | 当前分页大小 | |
| total | num | 记录总数 | |
**示例：**
```shell
curl -L -X GET 'https://member.bilibili.com/x/h5/elec/rank/recent' \
-H 'Cookie: SESSDATA=xxx'
```
<details>
<summary>查看响应示例：</summary>
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"list": [
{
"aid": 0,
"bvid": "",
"elec_num": 50,
"title": "",
"uname": "",
"avatar": "",
"ctime": "2020-04-02 03:12:22"
},
{
"aid": 0,
"bvid": "",
"elec_num": 20,
"title": "",
"uname": "",
"avatar": "",
"ctime": "2020-04-02 03:12:00"
}
],
"pager": {
"current": 1,
"size": 20,
"total": 38
}
}
}
```
</details>

28
user/info.md
View File

@ -560,9 +560,14 @@ https://i0.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png
`data`对象： `data`对象：
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ---- | ----- | -------- | ---- | | ------------- | ----- | -------------- | ------------------------------------------------------------ |
| card | obj | 卡片信息 | | | card | obj | 卡片信息 | |
| following | bool | 是否关注此用户 | true：已关注<br />false：未关注<br />需要登录(Cookie)<br />未登录为false |
| archive_count | num | 用户稿件数 | |
| article_count | num | 0 | **作用尚不明确** |
| follower | num | 粉丝数 | |
| like_num | num | 点赞数 | |
`data`中的`card`对象： `data`中的`card`对象：
@ -591,10 +596,6 @@ https://i0.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png
| official_verify | obj | 认证信息2 | | | official_verify | obj | 认证信息2 | |
| vip | obj | 大会员状态 | | | vip | obj | 大会员状态 | |
| space | obj | 主页头图 | | | space | obj | 主页头图 | |
| following | bool | 是否关注此用户 | true：已关注<br />false：未关注<br />需要登录(Cookie) <br />未登录为false |
| archive_count | num | 用户稿件数 | |
| article_count | num | 0 | **作用尚不明确** |
| follower | num | 粉丝数 | |
`card`中的`level_info`对象： `card`中的`level_info`对象：
@ -754,12 +755,13 @@ curl -G 'api.bilibili.com/x/web-interface/card' \
"space": { "space": {
"s_img": "http://i1.hdslb.com/bfs/space/768cc4fd97618cf589d23c2711a1d1a729f42235.png", "s_img": "http://i1.hdslb.com/bfs/space/768cc4fd97618cf589d23c2711a1d1a729f42235.png",
"l_img": "http://i1.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png" "l_img": "http://i1.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png"
}, }
"following": true, },
"archive_count": 37, "following": true,
"article_count": 0, "archive_count": 37,
"follower": 969999 "article_count": 0,
} "follower": 969999,
"like_num": 3547978
} }
``` ```

163
user/relation.md
View File

@ -6,6 +6,7 @@
- [搜索关注明细](#搜索关注明细) - [搜索关注明细](#搜索关注明细)
- [查询共同关注明细](#查询共同关注明细) - [查询共同关注明细](#查询共同关注明细)
- [查询悄悄关注明细](#查询悄悄关注明细) - [查询悄悄关注明细](#查询悄悄关注明细)
- [查询互相关注明细](#查询互相关注明细)
- [查询黑名单明细](#查询黑名单明细) - [查询黑名单明细](#查询黑名单明细)
- [操作用户关系](#操作用户关系) - [操作用户关系](#操作用户关系)
- [批量操作用户关系](#批量操作用户关系) - [批量操作用户关系](#批量操作用户关系)
@ -15,7 +16,7 @@
- [关注分组相关](#关注分组相关) - [关注分组相关](#关注分组相关)
- [查询关注分组列表](#查询关注分组列表) - [查询关注分组列表](#查询关注分组列表)
- [查询关注分组明细](#查询关注分组明细) - [查询关注分组明细](#查询关注分组明细)
- [查询目标用户所在的分组](#查询目标用户所在的分组 ) - [查询目标用户所在的分组](#查询目标用户所在的分组)
- [查询所有特别关注的mid](#查询所有特别关注的mid) - [查询所有特别关注的mid](#查询所有特别关注的mid)
- [创建分组](#创建分组) - [创建分组](#创建分组)
- [重命名分组](#重命名分组) - [重命名分组](#重命名分组)
@ -1027,6 +1028,166 @@ curl -G 'https://api.bilibili.com/x/relation/whispers' \
</details> </details>
## 查询互相关注明细
<img src="/imgs/relation.svg" width="100" height="100" />
> https://api.bilibili.com/x/relation/friends
*请求方式：GET*
认证方式：Cookie(SESSDATA)或APP
查询与自己互关的用户明细，可看全部
**url参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------ | ----------- | -------- |
| access_key | str | APP登录Token | APP方式必要 | |
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------- |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-400：请求错误 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | obj | 信息本体 | |
data 对象：
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ----- | -------- | ------------ |
| list | array | 明细列表 | |
| re_version | num | ？？？ | 作用尚不明确 |
`data`中的`list`数组：
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | --------- | ---------------- |
| 0 | obj | 互关1 | |
| n | obj | 互关(n+1) | 按照关注顺序排列 |
| …… | obj | …… | …… |
数组`list`中的对象：
| 字段 | 类型 | 内容 | 备注 |
| --------------- | ------------------------------------------- | ------------ | --------------------------------------- |
| mid | num | 用户mid | |
| attribute | num | 关注属性 | 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 | 空 | 作用尚不明确 |
**示例：**
获取互相关注明细
```shell
curl -G 'https://api.bilibili.com/x/relation/friends' \
-b 'SESSDATA=xxx'
```
<details>
<summary>查看响应示例：</summary>
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"list": [
{
"mid": 293793435,
"attribute": 6,
"mtime": 1583817598,
"tag": [-10],
"special": 1,
"uname": "社会易姐QwQ",
"face": "https://i0.hdslb.com/bfs/face/aebb2639a0d47f2ce1fec0631f412eaf53d4a0be.jpg",
"sign": "BAC项目负责人 | 带砖技术宅 | MC 编程 电子 | 车万众\u0026术术人 | 粉丝群1136462265 博客shakaianee.top",
"face_nft": 0,
"official_verify": {
"type": -1,
"desc": ""
},
"vip": {
"vipType": 2,
"vipDueDate": 1675872000000,
"dueRemark": "",
"accessStatus" :0,
"vipStatus": 1,
"vipStatusWarn": "",
"themeType": 0,
"label": {
"path": "",
"text": "年度大会员",
"label_theme": "annual_vip",
"text_color": "#FFFFFF",
"bg_style": 1,
"bg_color": "#FB7299",
"border_color": ""
},
"avatar_subscript": 1,
"nickname_color": "#FB7299",
"avatar_subscript_url": ""
},
"nft_icon": "",
"rec_reason": "",
"track_id": ""
}
],
"re_version": 0
}
}
```
</details>
## 查询黑名单明细 ## 查询黑名单明细
> https://api.bilibili.com/x/relation/blacks > https://api.bilibili.com/x/relation/blacks