From c3515d825eb4476010113f591afe1087eb848936 Mon Sep 17 00:00:00 2001 From: wuziqian211 <65224318+wuziqian211@users.noreply.github.com> Date: Thu, 19 Jan 2023 17:15:04 +0800 Subject: [PATCH] =?UTF-8?q?=E6=B7=BB=E5=8A=A0=E2=80=9C=E6=9F=A5=E8=AF=A2?= =?UTF-8?q?=E4=BA=92=E7=9B=B8=E5=85=B3=E6=B3=A8=E6=98=8E=E7=BB=86=E2=80=9D?= =?UTF-8?q?=E3=80=81=E2=80=9C=E6=9F=A5=E8=AF=A2=E5=8E=86=E5=8F=B2=E5=85=85?= =?UTF-8?q?=E7=94=B5=E6=95=B0=E6=8D=AE=E2=80=9DAPI=20(#587)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * Update relation.md * Update relation.md * Update info.md * Update relation.md * Update relation.md * Update charge_list.md * Update charge_list.md --- electric/charge_list.md | 104 ++++++++++++++++++++++++- user/info.md | 28 +++---- user/relation.md | 163 +++++++++++++++++++++++++++++++++++++++- 3 files changed, 280 insertions(+), 15 deletions(-) diff --git a/electric/charge_list.md b/electric/charge_list.md index fdc300e..dd46641 100644 --- a/electric/charge_list.md +++ b/electric/charge_list.md @@ -2,6 +2,8 @@ - [获取空间充电公示列表](#获取空间充电公示列表) - [获取视频充电鸣谢名单](#获取视频充电鸣谢名单) +- [查询我收到的充电列表](#查询我收到的充电列表) +- [查询历史充电数据](#查询历史充电数据) --- @@ -425,4 +427,104 @@ curl -L -X GET 'https://pay.bilibili.com/bk/brokerage/listForCustomerRechargeRec } ``` - \ No newline at end of file + + +## 查询历史充电数据 + +> 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' +``` + +
+查看响应示例： + +```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 + } + } +} +``` + +
diff --git a/user/info.md b/user/info.md index d563238..9fc0c90 100644 --- a/user/info.md +++ b/user/info.md @@ -560,9 +560,14 @@ https://i0.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png `data`对象： -| 字段 | 类型 | 内容 | 备注 | -| ---- | ----- | -------- | ---- | -| card | obj | 卡片信息 | | +| 字段 | 类型 | 内容 | 备注 | +| ------------- | ----- | -------------- | ------------------------------------------------------------ | +| card | obj | 卡片信息 | | +| following | bool | 是否关注此用户 | true：已关注
false：未关注
需要登录(Cookie)
未登录为false | +| archive_count | num | 用户稿件数 | | +| article_count | num | 0 | **作用尚不明确** | +| follower | num | 粉丝数 | | +| like_num | num | 点赞数 | | `data`中的`card`对象： @@ -591,10 +596,6 @@ https://i0.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png | official_verify | obj | 认证信息2 | | | vip | obj | 大会员状态 | | | space | obj | 主页头图 | | -| following | bool | 是否关注此用户 | true：已关注
false：未关注
需要登录(Cookie)
未登录为false | -| archive_count | num | 用户稿件数 | | -| article_count | num | 0 | **作用尚不明确** | -| follower | num | 粉丝数 | | `card`中的`level_info`对象： @@ -754,12 +755,13 @@ curl -G 'api.bilibili.com/x/web-interface/card' \ "space": { "s_img": "http://i1.hdslb.com/bfs/space/768cc4fd97618cf589d23c2711a1d1a729f42235.png", "l_img": "http://i1.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png" - }, - "following": true, - "archive_count": 37, - "article_count": 0, - "follower": 969999 - } + } + }, + "following": true, + "archive_count": 37, + "article_count": 0, + "follower": 969999, + "like_num": 3547978 } ``` diff --git a/user/relation.md b/user/relation.md index 291b59b..c616cfb 100644 --- a/user/relation.md +++ b/user/relation.md @@ -6,6 +6,7 @@ - [搜索关注明细](#搜索关注明细) - [查询共同关注明细](#查询共同关注明细) - [查询悄悄关注明细](#查询悄悄关注明细) +- [查询互相关注明细](#查询互相关注明细) - [查询黑名单明细](#查询黑名单明细) - [操作用户关系](#操作用户关系) - [批量操作用户关系](#批量操作用户关系) @@ -15,7 +16,7 @@ - [关注分组相关](#关注分组相关) - [查询关注分组列表](#查询关注分组列表) - [查询关注分组明细](#查询关注分组明细) - - [查询目标用户所在的分组](#查询目标用户所在的分组 ) + - [查询目标用户所在的分组](#查询目标用户所在的分组) - [查询所有特别关注的mid](#查询所有特别关注的mid) - [创建分组](#创建分组) - [重命名分组](#重命名分组) @@ -1027,6 +1028,166 @@ curl -G 'https://api.bilibili.com/x/relation/whispers' \ +## 查询互相关注明细 + + + +> https://api.bilibili.com/x/relation/friends + +*请求方式：GET* + +认证方式：Cookie(SESSDATA)或APP + +查询与自己互关的用户明细，可看全部 + +**url参数：** + +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| ---------- | ---- | ------------ | ----------- | -------- | +| access_key | str | APP登录Token | APP方式必要 | | + +**json回复：** + +根对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------- | ---- | -------- | ------------------------------------------------- | +| code | num | 返回值 | 0：成功
-101：账号未登录
-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 | 关注对方时间 | 时间戳
互关后刷新 | +| tag | 默认分组：null
存在至少一个分组：array | 分组id | | +| special | num | 特别关注标志 | 0：否
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：无
1：认证 | +| desc | str | 用户认证信息 | 无为空 | + +`list`中的对象中的`vip`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------------- | ---- | ------------ | ----------------------------------------------- | +| vipType | num | 会员类型 | 0：无
1：月度大会员
2：年度以上大会员 | +| vipDueDate | num | 会员到期时间 | 时间戳 毫秒 | +| dueRemark | str | 空 | 作用尚不明确 | +| accessStatus | num | 0 | 作用尚不明确 | +| vipStatus | num | 大会员状态 | 0：无
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' +``` + +
+查看响应示例： + + +```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 + } +} +``` + +
+ ## 查询黑名单明细 > https://api.bilibili.com/x/relation/blacks