feat: 更新包月充电、获取用户信息、用户关系相关说明 (#981)

* Update charge_list.md

* Update charge_msg.md

* Update relation.md

* Update relation.md

* update

* Update monthly.md

* Update monthly.md

* update

* Update charge_list.md

* Update relation.md

* Update monthly.md

* Update README.md

* Update charge_list.md

* update

* Update relation.md

* Update relation.md

* Update relation.md

* Update info.md

* update
This commit is contained in:
wuziqian211 2024-03-10 18:53:43 +08:00 committed by GitHub
parent 4645c1ef9a
commit f9ee5c3b99
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
7 changed files with 450 additions and 367 deletions

View File

@ -187,9 +187,10 @@ B站 API 采用 C/S 结构,大多数接口为 REST API 和 gRPC少部分接
- [x] [实时广播(通讯协议)](docs/broadcast)
- [x] [视频内广播](docs/broadcast/video_room.md)
- [ ] [充电](docs/electric)
- [ ] [包月充电操作](docs/electric/monthly.md)
- [x] [自定义充电B币方式](docs/electric/Bcoin.md)
- [x] [自定义充电(微信 & 支付宝方式)](docs/electric/WeChat&Alipay.md)
- [ ] [包月充电](docs/electric/monthly.md)
- [ ] 自定义充电
- [x] [B币方式充电](docs/electric/Bcoin.md)
- [x] [微信 & 支付宝方式充电](docs/electric/WeChat&Alipay.md)
- [x] [充电留言](docs/electric/charge_msg.md)
- [x] [充电列表](docs/electric/charge_list.md)
- [ ] [动态](docs/dynamic)

View File

@ -25,13 +25,13 @@
`data`对象:
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ----- | ---------------- | ------------ |
| count | num | 本月充电人数 | |
| list | array | 本月充电用户列表 | |
| total_count | num | 总计充电次数 | |
| total | num | 总计充电次数 | 同 |
| special_day | num | 0 | 作用尚不明确 |
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ----- | ---------------- | --------------- |
| count | num | 本月充电人数 | |
| list | array | 本月充电用户列表 | |
| total_count | num | 总计充电次数 | |
| total | num | 总计充电次数 | 同`total_count` |
| special_day | num | 0 | 作用尚不明确 |
`data`中的`list`数组:
@ -69,8 +69,8 @@
查询用户`mid=53456`的充电公示列表
```shell
curl -G 'https://api.bilibili.com/x/ugcpay-rank/elec/month/up?up_mid=53456' \
--data-urlencode 'mid=53456'
curl -G 'https://api.bilibili.com/x/ugcpay-rank/elec/month/up' \
--data-urlencode 'up_mid=53456'
```
<details>
@ -166,14 +166,14 @@ curl -G 'https://api.bilibili.com/x/ugcpay-rank/elec/month/up?up_mid=53456' \
`data`对象:
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ------ | ---------------- | ------------ |
| show_info | obj | 展示选项 | |
| av_count | num | 目标视频充电人数 | |
| count | num | 本月充电人数 | |
| total_count | num | 总计充电人数 | |
| special_day | num | 0 | 作用尚不明确 |
| display_num | num | 0 | 作用尚不明确 |
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ----- | ---------------- | ------------ |
| show_info | obj | 展示选项 | |
| av_count | num | 目标视频充电人数 | |
| count | num | 本月充电人数 | |
| total_count | num | 总计充电人数 | |
| special_day | num | 0 | 作用尚不明确 |
| display_num | num | 0 | 作用尚不明确 |
| list | array | 本月充电用户列表 | |
`data`中的`show_info`对象:
@ -231,7 +231,7 @@ bvid方式
```shell
curl -G 'https://api.bilibili.com/x/web-interface/elec/show' \
--data-urlencode 'mid=53456' \
--data-urlencode 'bvid=BV1up4y1y77i '
--data-urlencode 'bvid=BV1up4y1y77i'
```
<details>
@ -301,13 +301,13 @@ curl -G 'https://api.bilibili.com/x/web-interface/elec/show' \
**url参数**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| -------- | ---- | -------- | ------ | -------------------------------- |
| currentPage | num | 页数 | 必要 | |
| pageSize | num | 分页大小 | 必要 | 取值范围[1,50] |
| customerId | num | (?) | 必要 | 目前为固定值10026 |
| beginTime | str | 开始日期 | | yyyy-MM-dd |
| endTime | str | 结束日期 | | yyyy-MM-dd |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ----------- | ---- | -------- | ------ | ------------------- |
| currentPage | num | 页数 | 必要 | |
| pageSize | num | 分页大小 | 必要 | 取值范围[1,50] |
| customerId | num | (?) | 必要 | 目前为固定值10026 |
| beginTime | str | 开始日期 | 非必要 | yyyy-MM-dd |
| endTime | str | 结束日期 | 非必要 | yyyy-MM-dd |
**json回复**
@ -315,59 +315,62 @@ curl -G 'https://api.bilibili.com/x/web-interface/elec/show' \
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | --------------------------- |
| code | num | 返回值 | 0成功<br />800501007user not login<br />800501008内部错误<br /> 800501011请求参数有误|
| errno | num | | |
| msg | str | | |
| showMsg | str | | |
| success | bool | | |
| code | num | 返回值 | 0成功<br />800501007user not login<br />800501008内部错误<br /> 800501011请求参数有误 |
| errno | num | | |
| msg | str | | |
| showMsg | str | | |
| success | bool | | |
| data | obj | 信息本体 | |
`data`对象:
| 字段 | 类型 | 内容 | 备注 |
| -------- | ----- | ------ | ---- |
| page | obj | 分页信息 | |
| 字段 | 类型 | 内容 | 备注 |
| ------ | ----- | ------------ | ---- |
| page | obj | 分页信息 | |
| result | array | 充电信息本体 | |
| config | array | (?) | |
| config | array | (?) | |
`page`对象:
| 字段 | 类型 | 内容 | 备注 |
| -------- | ----- | ------ | ---- |
| currentPage | num | 当前页数 | |
| pageSize | num | 当前分页大小 | |
| totalCount | num | 记录总数 | |
| totalPage | num | 总页数 | |
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | ------------ | ---- |
| currentPage | num | 当前页数 | |
| pageSize | num | 当前分页大小 | |
| totalCount | num | 记录总数 | |
| totalPage | num | 总页数 | |
`config`数组中的对象:
| 字段 | 类型 | 内容 | 备注 |
| -------- | ----- | ------ | ---- |
| mid | num | | 总是为null |
| name | str | | 总是为null |
| avatar | str | | 总是为null |
| originalThirdCoin | num | | 总是为null |
| brokerage | num | | 总是为null |
| remark | str | | 总是为null |
| ctime | str | | 总是为null |
| 字段 | 类型 | 内容 | 备注 |
| ----------------- | ---- | ---- | ---------- |
| mid | null | | 总是为null |
| name | null | | 总是为null |
| avatar | null | | 总是为null |
| originalThirdCoin | null | | 总是为null |
| brokerage | null | | 总是为null |
| remark | null | | 总是为null |
| ctime | null | | 总是为null |
`result`数组中的对象:
| 字段 | 类型 | 内容 | 备注 |
| -------- | ----- | ------ | ---- |
| mid | num | 充电人mid | |
| name | str | 充电人昵称 | |
| avatar | str | 充电人头像 | |
| originalThirdCoin | num | 原始B币数 | |
| brokerage | num | 实际收到的贝壳数 | |
| remark | str | 充电渠道 | Web/安卓/iOS |
| ctime | str | 充电时间 | yyyy-MM-dd HH:mm:ss |
| 字段 | 类型 | 内容 | 备注 |
| ----------------- | ---- | ---------------- | ------------------- |
| mid | num | 充电人mid | |
| name | str | 充电人昵称 | |
| avatar | str | 充电人头像 | |
| originalThirdCoin | num | 原始B币数 | |
| brokerage | num | 实际收到的贝壳数 | |
| remark | str | 充电渠道 | Web/安卓/iOS |
| ctime | str | 充电时间 | yyyy-MM-dd HH:mm:ss |
**示例:**
```shell
curl -L -X GET 'https://pay.bilibili.com/bk/brokerage/listForCustomerRechargeRecord?currentPage=1&pageSize=2&customerId=10026' \
-H 'Cookie: SESSDATA=xxx'
curl -G 'https://pay.bilibili.com/bk/brokerage/listForCustomerRechargeRecord' \
--data-urlencode 'currentPage=1' \
--data-urlencode 'pageSize=2' \
--data-urlencode 'customerId=10026' \
-b 'SESSDATA=xxx'
```
<details>
@ -480,8 +483,8 @@ curl -L -X GET 'https://pay.bilibili.com/bk/brokerage/listForCustomerRechargeRec
**示例:**
```shell
curl -L -X GET 'https://member.bilibili.com/x/h5/elec/rank/recent' \
-H 'Cookie: SESSDATA=xxx'
curl -G 'https://member.bilibili.com/x/h5/elec/rank/recent' \
-b 'SESSDATA=xxx'
```
<details>

View File

@ -2,6 +2,180 @@
<img src="../../assets/img/battery-100.png" width="100" height="100"/>
## 获取包月充电列表
> https://api.live.bilibili.com/xlive/revenue/v1/guard/getChargeRecord
*请求方式GET*
认证方式Cookie(SESSDATA)或APP
**url参数**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ------------------------ |
| page | num | 页码 | 必要 | |
| type | num | 充电状态 | 必要 | 1使用中<br />2已过期 |
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------------------- |
| code | num | 返回值 | 0成功<br />-101账号未登录<br />-400请求错误<br />25100004参数错误 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data`对象:
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ----- | ---------------- | ---------------- |
| list | 有内容时array<br />无内容时null | 包月充电UP主列表 | 最多10个 |
| page | num | 当前页数 | |
| page_size | num | 当前分页大小 | 一般为10 |
| total_page | num | 总页数 | |
| total_num | num | 用户总数 | |
| is_more | num | 是否有更多用户 | 0<br />1是 |
`data`中的`list`数组:
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | --------- | ---------------- |
| 0 | obj | 用户1 | |
| n | obj | 用户(n+1) | |
| …… | obj | …… | …… |
数组`list`中的对象:
| 字段 | 类型 | 内容 | 备注 |
| --------- | ----- | --------------- | ------ |
| up_uid | num | 充电UP主mid | |
| user_name | str | 充电UP主昵称 | |
| user_face | str | 充电UP主头像url | |
| item | array | 充电详情 | |
| start | num | 开始充电时间 | 时间戳 |
数组`list`中的对象中的`item`数组:
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | -------- | -------- |
| 0 | obj | 充电详情 | 套了个娃 |
数组`item`中的对象:
| 字段 | 类型 | 内容 | 备注 |
| -------------- | --------------------------------------------- | ---------------- | ---------------- |
| privilege_type | num | 10 | **作用尚不明确** |
| icon | str | 充电图标 | |
| name | str | `包月充电` | |
| expire_time | num | 充电过期时间 | 时间戳 |
| renew | 开启自动续费时obj<br />关闭自动续费时null | 充电自动续费详情 | |
数组`item`中的对象中的`renew`对象:
| 字段 | 类型 | 内容 | 备注 |
| ----------------- | ---- | ------------ | ------------------------------------------------- |
| uid | num | 自己的mid | |
| ruid | num | UP主的mid | |
| goods_id | num | 充电类型 | 172一个月<br />173连续包月<br />174连续包年 |
| status | num | 充电状态 | 1 |
| next_execute_time | num | 下次续费时间 | 时间戳 |
| signed_time | num | 签约时间 | 时间戳 |
| signed_price | num | 下次续费金额 | 单位为千分之一元人民币 |
| pay_channel | num | 签约平台 | 2微信支付<br />4支付宝 |
| period | num | 下次充电天数 | |
**示例:**
获取自己正在使用的包月充电的列表
```shell
curl 'https://api.live.bilibili.com/xlive/revenue/v1/guard/getChargeRecord' \
--data-urlencode 'page=1' \
--data-urlencode 'type=1' \
-b 'SESSDATA=xxx'
```
<details>
<summary>查看响应示例:</summary>
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"list": [
{
"up_uid": 2233,
"user_name": "2233",
"user_face": "https://i0.hdslb.com/bfs/face/noface.jpg",
"item": [
{
"privilege_type": 10,
"icon": "https://s1.hdslb.com/bfs/templar/york-static/lightning_icon@2x.png",
"name": "包月充电",
"expire_time": 1703519999,
"renew": {
"uid": 425503913,
"ruid": 2233,
"goods_id": 174,
"status": 1,
"next_execute_time": 1703174400,
"signed_time": 1671618921,
"signed_price": 36000,
"pay_channel": 2,
"period": 366
}
}
],
"start": 1669183804
},
{
"up_uid": 293793435,
"user_name": "社会易姐QwQ",
"user_face": "https://i0.hdslb.com/bfs/face/aebb2639a0d47f2ce1fec0631f412eaf53d4a0be.jpg",
"item": [
{
"privilege_type": 10,
"icon": "https://s1.hdslb.com/bfs/templar/york-static/lightning_icon@2x.png",
"name": "包月充电",
"expire_time": 1681401599,
"renew": {
"uid": 425503913,
"ruid": 293793435,
"goods_id": 173,
"status": 1,
"next_execute_time": 1680364800,
"signed_time": 1677760921,
"signed_price": 5000,
"pay_channel": 4,
"period": 31
}
}
],
"start": 1676033795
}
],
"page": 1,
"page_size": 10,
"total_page": 3,
"total_num": 22,
"is_more": 1
}
}
```
</details>
表示自己从2022-11-23 14:10:04开始给“2233”包月充电并且在2022-12-21 18:35:21在微信开通了连续包年充电在2023-12-22 00:00:00的时候会自动续费36元并继续充电366天
自己从2023-02-10 20:56:35开始给“社会易姐QwQ”包月充电并且在2023-03-02 20:42:01在支付宝开通了连续包月充电在2023-04-02 00:00:00的时候会自动续费5元并继续充电31天。
## UP主包月充电详情
> https://api.bilibili.com/x/upower/item/detail
@ -153,7 +327,7 @@ curl 'https://api.bilibili.com/x/upower/item/detail' \
| remain_days | num | 剩余天数 | 未处于包月充电状态为-1 |
| remain_less_1day | num | 剩余的天数小于1天 | 0<br />1<br />未处于包月充电状态为0 |
| upower_rank | obj | 充电详情 | |
| upower_icon | str | 充电图标url | |
| upower_icon | str | 充电图标url | 仅在处于包月充电状态时有内容 |
`data`中的`up_card`对象:
@ -246,12 +420,16 @@ curl 'https://api.bilibili.com/x/upower/charge/follow/info' \
</details>
表示自己已保持17天对“社会易姐QwQ”的包月充电剩余15天过期。
## 包月充电用户排名
> https://api.bilibili.com/x/upower/up/member/rank/v2
*请求方式GET*
认证方式Cookie(SESSDATA)或APP
**url参数**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
@ -300,25 +478,27 @@ curl 'https://api.bilibili.com/x/upower/charge/follow/info' \
数组`rank_info`中的对象:
| 字段 | 类型 | 内容 | 备注 |
| --------- | ---- | ---------------- | ----- |
| mid | num | 充电用户mid | |
| nickname | str | 充电用户昵称 | |
| avatar | str | 充电用户头像url | |
| rank | num | 充电用户排名 | |
| day | num | 包月充电天数 | |
| expire_at | num | 包月充电过期时间 | 恒为0 |
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | ---------------- | ----- |
| mid | num | 充电用户mid | |
| nickname | str | 充电用户昵称 | |
| avatar | str | 充电用户头像url | |
| rank | num | 充电用户排名 | |
| day | num | 包月充电天数 | |
| expire_at | num | 包月充电过期时间 | 恒为0 |
| remain_days | num | 剩余天数 | 恒为0 |
`data`中的`user_info`对象:
| 字段 | 类型 | 内容 | 备注 |
| --------- | ---- | ---------------- | --------------------------------- |
| mid | num | 用户mid | |
| nickname | str | 用户昵称 | |
| avatar | str | 用户头像url | |
| rank | num | 包月充电排名 | 不在包月充电用户列表里为-1 |
| day | num | 包月充电天数 | |
| expire_at | num | 包月充电过期时间 | 单位为秒若从未给UP主包月充电为0 |
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | ---------------- | ------------------------------- |
| mid | num | 用户mid | |
| nickname | str | 用户昵称 | |
| avatar | str | 用户头像url | |
| rank | num | 包月充电排名 | 不在包月充电用户列表里为-1 |
| day | num | 包月充电天数 | |
| expire_at | num | 包月充电过期时间 | 时间戳若从未给UP主包月充电为0 |
| remain_days | num | 未过期时:剩余天数<br />已过期且之前给UP主包月充电过自过期以来的天数 | |
**示例:**
@ -354,7 +534,8 @@ curl 'https://api.bilibili.com/x/upower/up/member/rank/v2' \
"avatar": "https://i2.hdslb.com/bfs/face/390f4b18b8b15c1f2ecdb6ee44e572aa18b9b2d0.png",
"rank": 1,
"day": 31,
"expire_at": 0
"expire_at": 0,
"remain_days": 0
}
],
"user_info": {
@ -363,7 +544,8 @@ curl 'https://api.bilibili.com/x/upower/up/member/rank/v2' \
"avatar": "https://i2.hdslb.com/bfs/face/390f4b18b8b15c1f2ecdb6ee44e572aa18b9b2d0.png",
"rank": 1,
"day": 31,
"expire_at": 1678723199
"expire_at": 1678723199,
"remain_days": 15
},
"member_total": 1
}

View File

@ -159,6 +159,7 @@
`data`中的`pendant`对象:
**普通头像框的`image`与`image_enhance`内容相同**
**动态头像框的`image`为png静态图片`image_enhance`为webp动态图片`image_enhance_frame`为png逐帧序列**
| 字段 | 类型 | 内容 | 备注 |
@ -540,7 +541,7 @@ curl -G 'https://api.bilibili.com/x/space/wbi/acc/info' \
| face | str | 用户头像链接 | |
| DisplayRank | str | 0 | **作用尚不明确** |
| regtime | num | 0 | **作用尚不明确** |
| spacesta | num | 0 | **作用尚不明确** |
| spacesta | num | 用户状态 | 0正常<br />-2被封禁 |
| birthday | str | 空 | **作用尚不明确** |
| place | str | 空 | **作用尚不明确** |
| description | str | 空 | **作用尚不明确** |
@ -563,7 +564,7 @@ curl -G 'https://api.bilibili.com/x/space/wbi/acc/info' \
| 字段 | 类型 | 内容 | 备注 |
| ------------- | ---- | -------- | ---------------- |
| current_level | num | 当前等级 | 0-6级 |
| current_min | num | 0 | 作用尚不明确 |
| current_min | num | 0 | **作用尚不明确** |
| current_exp | num | 0 | **作用尚不明确** |
| next_exp | num | 0 | **作用尚不明确** |
@ -589,19 +590,19 @@ curl -G 'https://api.bilibili.com/x/space/wbi/acc/info' \
`card`中的`Official`对象:
| 字段 | 类型 | 内容 | 备注 |
| ----- | ---- | -------- | ------------------------------------------------- |
| role | num | 认证类型 | 见[用户认证类型一览](official_role.md) |
| title | str | 认证信息 | 无为空 |
| desc | str | 认证备注 | 无为空 |
| type | num | 是否认证 | -1<br />0认证 |
| 字段 | 类型 | 内容 | 备注 |
| ----- | ---- | -------- | ---------------------------------------- |
| role | num | 认证类型 | 见[用户认证类型一览](official_role.md) |
| title | str | 认证信息 | 无为空 |
| desc | str | 认证备注 | 无为空 |
| type | num | 是否认证 | -1<br />0UP主认证<br />1机构认证 |
`card`中的`official_verify`对象:
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | -------- | ------------------- |
| type | num | 是否认证 | -1<br />0认证 |
| desc | str | 认证信息 | 无为空 |
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | -------- | ---------------------------------------- |
| type | num | 是否认证 | -1<br />0UP主认证<br />1机构认证 |
| desc | str | 认证信息 | 无为空 |
`card`中的`vip`对象:
@ -938,22 +939,24 @@ curl -G 'https://api.bilibili.com/x/space/myinfo' \
认证方式Cookie(SESSDATA)
本接口较其他接口相比,只会返回非常有限的信息,但可以同时获取较多的用户信息(据测试可以同时获取 40000 多个用户的信息)
**url参数**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------------- | ------ | --------------------------------- |
| uids | nums | 目标用户的UID列表 | 必要 | 每个成员间用`,`分隔最多50个成员 |
| uids | nums | 目标用户的UID列表 | 必要 | 每个成员间用`,`分隔 |
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ----- | -------- | ----------------------------------------------------------------- |
| code | num | 返回值 | 0成功<br />-400请求错误<br />600007超出批量获取用户信息限制 |
| msg | str | 错误信息 | 默认为空 |
| message | str | 错误信息 | 默认为空 |
| data | array | 信息本体 | |
| 字段 | 类型 | 内容 | 备注 |
| ------- | ----- | -------- | --------------------------- |
| code | num | 返回值 | 0成功<br />-400请求错误 |
| msg | str | 错误信息 | 默认为空 |
| message | str | 错误信息 | 默认为空 |
| data | array | 信息本体 | 用户信息随机排序 |
`data`数组:
@ -965,7 +968,16 @@ curl -G 'https://api.bilibili.com/x/space/myinfo' \
`data`数组中的对象:
基本同「[用户空间详细信息](#用户空间详细信息)」中的data对象
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | ------------ | -------------------- |
| mid | num | mid | |
| name | str | 昵称 | |
| sex | str | 性别 | 男/女/保密 |
| face | str | 头像链接 | |
| sign | str | 签名 | |
| rank | num | 用户权限等级 | |
| level | num | 当前等级 | 0-6 级 |
| silence | num | 封禁状态 | 0正常<br />1被封 |
**示例:**
@ -993,64 +1005,7 @@ curl -G 'https://api.vc.bilibili.com/account/v1/user/cards' \
"sign": "",
"rank": 10000,
"level": 4,
"silence": 0,
"vip": {
"type": 2,
"status": 1,
"due_date": 1754496000000,
"vip_pay_type": 1,
"theme_type": 0,
"label": {
"path": "",
"text": "年度大会员",
"label_theme": "annual_vip",
"text_color": "#FFFFFF",
"bg_style": 1,
"bg_color": "#FB7299",
"border_color": "",
"use_img_label": true,
"img_label_uri_hans": "",
"img_label_uri_hant": "",
"img_label_uri_hans_static": "https://i0.hdslb.com/bfs/vip/8d4f8bfc713826a5412a0a27eaaac4d6b9ede1d9.png",
"img_label_uri_hant_static": "https://i0.hdslb.com/bfs/activity-plat/static/20220614/e369244d0b14644f5e1a06431e22a4d5/VEW8fCC0hg.png"
},
"avatar_subscript": 1,
"nickname_color": "#FB7299",
"role": 3,
"avatar_subscript_url": "",
"tv_vip_status": 0,
"tv_vip_pay_type": 0,
"tv_due_date": 1633622400
},
"pendant": {
"pid": 0,
"name": "",
"image": "",
"expire": 0,
"image_enhance": "",
"image_enhance_frame": ""
},
"nameplate": {
"nid": 0,
"name": "",
"image": "",
"image_small": "",
"level": "",
"condition": ""
},
"official": {
"role": 0,
"title": "",
"desc": "",
"type": -1
},
"birthday": 622137600,
"is_fake_account": 0,
"is_deleted": 0,
"in_reg_audit": 0,
"face_nft": 0,
"face_nft_new": 0,
"is_senior_member": 0
"silence": 0
}, {
"mid": 2,
"name": "碧诗",
@ -1059,64 +1014,7 @@ curl -G 'https://api.vc.bilibili.com/account/v1/user/cards' \
"sign": "https://kami.im 直男过气网红 # av362830 “We Are Star Dust”",
"rank": 20000,
"level": 6,
"silence": 0,
"vip": {
"type": 2,
"status": 1,
"due_date": 3901881600000,
"vip_pay_type": 0,
"theme_type": 0,
"label": {
"path": "",
"text": "十年大会员",
"label_theme": "ten_annual_vip",
"text_color": "#FFFFFF",
"bg_style": 1,
"bg_color": "#FB7299",
"border_color": "",
"use_img_label": true,
"img_label_uri_hans": "",
"img_label_uri_hant": "",
"img_label_uri_hans_static": "https://i0.hdslb.com/bfs/vip/adb599797dd171e2d3d6d012f448b49679258344.png",
"img_label_uri_hant_static": "https://i0.hdslb.com/bfs/activity-plat/static/20220614/e369244d0b14644f5e1a06431e22a4d5/sGu57N6pgK.png"
},
"avatar_subscript": 1,
"nickname_color": "#FB7299",
"role": 7,
"avatar_subscript_url": "",
"tv_vip_status": 0,
"tv_vip_pay_type": 0,
"tv_due_date": 1655481600
},
"pendant": {
"pid": 32257,
"name": "EveOneCat2",
"image": "https://i2.hdslb.com/bfs/garb/item/488870931b1bba66da36d22848f0720480d3d79a.png",
"expire": 0,
"image_enhance": "https://i2.hdslb.com/bfs/garb/item/5974f17f9d96a88bafba2f6d18d647a486e88312.webp",
"image_enhance_frame": "https://i2.hdslb.com/bfs/garb/item/4316a3910bb0bd6f2f1c267a3e9187f0b9fe5bd0.png"
},
"nameplate": {
"nid": 10,
"name": "见习偶像",
"image": "https://i0.hdslb.com/bfs/face/e93dd9edfa7b9e18bf46fd8d71862327a2350923.png",
"image_small": "https://i1.hdslb.com/bfs/face/275b468b043ec246737ab8580a2075bee0b1263b.png",
"level": "普通勋章",
"condition": "所有自制视频总播放数>=10万"
},
"official": {
"role": 2,
"title": "bilibili创始人站长",
"desc": "",
"type": 0
},
"birthday": 622137600,
"is_fake_account": 0,
"is_deleted": 0,
"in_reg_audit": 0,
"face_nft": 0,
"face_nft_new": 0,
"is_senior_member": 1
"silence": 0
}, {
"mid": 3,
"name": "囧囧倉",
@ -1125,64 +1023,7 @@ curl -G 'https://api.vc.bilibili.com/account/v1/user/cards' \
"sign": "富强、民主、文明、和谐、自由、平等、公正、法治、爱国、敬业、诚信、友善。",
"rank": 10000,
"level": 5,
"silence": 0,
"vip": {
"type": 0,
"status": 0,
"due_date": 0,
"vip_pay_type": 0,
"theme_type": 0,
"label": {
"path": "",
"text": "",
"label_theme": "",
"text_color": "",
"bg_style": 0,
"bg_color": "",
"border_color": "",
"use_img_label": true,
"img_label_uri_hans": "",
"img_label_uri_hant": "",
"img_label_uri_hans_static": "https://i0.hdslb.com/bfs/vip/d7b702ef65a976b20ed854cbd04cb9e27341bb79.png",
"img_label_uri_hant_static": "https://i0.hdslb.com/bfs/activity-plat/static/20220614/e369244d0b14644f5e1a06431e22a4d5/KJunwh19T5.png"
},
"avatar_subscript": 0,
"nickname_color": "",
"role": 0,
"avatar_subscript_url": "",
"tv_vip_status": 0,
"tv_vip_pay_type": 0,
"tv_due_date": 0
},
"pendant": {
"pid": 0,
"name": "",
"image": "",
"expire": 0,
"image_enhance": "",
"image_enhance_frame": ""
},
"nameplate": {
"nid": 0,
"name": "",
"image": "",
"image_small": "",
"level": "",
"condition": ""
},
"official": {
"role": 0,
"title": "",
"desc": "",
"type": -1
},
"birthday": 1262275200,
"is_fake_account": 0,
"is_deleted": 0,
"in_reg_audit": 0,
"face_nft": 0,
"face_nft_new": 0,
"is_senior_member": 0
"silence": 0
}]
}
```

View File

@ -6,25 +6,27 @@
### 关系列表对象
| 字段 | 类型 | 内容 | 备注 |
| --------------- | ------------------------------------------- | --------------- | ------------------------------------------------------------ |
| mid | num | 用户 mid | |
| attribute | num | 关注属性 | 0未关注<br />1已关注<br />2已关注<br />6已互粉<br />128已拉黑 |
| mtime | num | 关注对方时间 | 时间戳<br />互关后刷新 |
| tag | 默认分组null<br />存在至少一个分组array | 分组 id | |
| special | num | 特别关注标志 | 0<br />1是 |
| contract_info | obj | | |
| uname | str | 用户昵称 | |
| face | str | 用户头像url | |
| face_nft | num | 是否为 NFT 头像 | 0非 NFT 头像<br />1NFT 头像 |
| sign | str | 用户签名 | |
| official_verify | obj | 认证信息 | |
| vip | obj | 会员信息 | |
| nft_icon | str | | |
| rec_reason | str | | |
| track_id | str | | |
以下说明中的 “目标用户” 指被查询的用户,“对方” 指返回的关系列表中的用户。
数组`list`中的对象中的`tag`数组:
| 字段 | 类型 | 内容 | 备注 |
| --------------- | ------------------------------------------- | -------------------------- | ------------------------------------------------------------ |
| mid | num | 用户 mid | |
| attribute | num | 对方对于**自己**的关系属性 | 0未关注<br />1悄悄关注现已下线<br />2已关注<br />6已互粉<br />128已拉黑 |
| mtime | num | 对方关注目标用户时间 | 秒级时间戳<br />互关后刷新 |
| tag | 默认分组null<br />存在至少一个分组array | 目标用户将对方分组到的 id | |
| special | num | 目标用户特别关注对方标识 | 0<br />1是 |
| contract_info | obj | 契约计划相关信息 | |
| uname | str | 用户昵称 | |
| face | str | 用户头像url | |
| face_nft | num | 是否为 NFT 头像 | 0非 NFT 头像<br />1NFT 头像 |
| sign | str | 用户签名 | |
| official_verify | obj | 认证信息 | |
| vip | obj | 会员信息 | |
| nft_icon | str | | |
| rec_reason | str | | |
| track_id | str | | |
`list`中的对象中的`tag`数组:
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ------------------------ | ---- |
@ -32,11 +34,21 @@
| n | num | 位于分组n+1的分组 id | |
| …… | num | …… | …… |
`list`中的对象中的`contract_info`对象:
| 字段 | 类型 | 内容 | 备注 |
| ------------- | ---- | ------------------------------ | ----------------------------------------------------------- |
| is_contract | bool | 目标用户是否为对方的契约者 | 仅当为 `true` 时才有此项 |
| is_contractor | bool | 对方是否为目标用户的契约者 | 仅当为 `true` 时才有此项 |
| ts | num | 对方成为目标用户的契约者的时间 | 秒级时间戳,仅当 `is_contractor` 项的值为 `true` 时才有此项 |
| user_attr | num | 对方作为目标用户的契约者的属性 | 1老粉<br />否则为原始粉丝<br />仅当有特殊属性时才有此项 |
`list`中的对象中的`official_verify`对象:
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ------------ | ------------------- |
| type | num | 用户认证类型 | -1<br />1认证 |
| type | num | 用户认证类型 | -1<br />0UP 主认证<br />1机构认证 |
| desc | str | 用户认证信息 | 无为空 |
`list`中的对象中的`vip`对象:
@ -66,7 +78,9 @@
认证方式CookieSESSDATA或 APP
登录可看当前用户前 1000 名,其他用户可查看前 250 名(网页端请求时`ps`为 20所以直接查看只能看到前 100 名)
本接口只有登录、标头 `referer``bilibili.com` 下的子域名、UA 不含 `python` 时才会返回列表
**本接口仅可返回前 1000 名粉丝**,若继续往后查询则返回空列表
**url参数**
@ -75,7 +89,7 @@
| access_key | str | APP 登录 Token | APP 方式必要 | |
| vmid | num | 目标用户 mid | 必要 | |
| ps | num | 每页项数 | 非必要 | 默认为 50 |
| pn | num | 页码 | 非必要 | 默认为 1<br />其他用户仅可查看前 5 页 |
| pn | num | 页码 | 非必要 | 默认为 1<br />仅可查看前 1000 名粉丝 |
**json回复**
@ -83,7 +97,7 @@
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ----------------------------------------------------- |
| code | num | 返回值 | 0成功<br />-400请求错误<br />22007访问超过 5 页 |
| code | num | 返回值 | 0成功<br />-101账号未登录<br />-352请求被拦截<br />-400请求错误<br />22007访问超过 5 页 |
| message | str | 错误信息 | 默认为 0 |
| ttl | num | 1 | |
| data | obj | 信息本体 | |
@ -192,7 +206,9 @@ curl -G 'https://api.bilibili.com/x/relation/followers' \
认证方式CookieSESSDATA或 APP
登录可看当前用户全部其他用户仅可查看前5页
本接口只有登录、标头 `referer``bilibili.com` 下的子域名、UA 不含 `python` 时才会返回列表
登录可看当前用户全部,其他用户仅可查看前 100 个,访问超过 100 个时返回空列表(但 `code` 值为 `0`
**url参数**
@ -200,20 +216,20 @@ curl -G 'https://api.bilibili.com/x/relation/followers' \
| ---------- | ---- | -------------- | ------------ | ------------------------------------------------------- |
| access_key | str | APP 登录 Token | APP 方式必要 | |
| vmid | num | 目标用户 mid | 必要 | |
| order_type | str | 排序方式 | 非必要 | 按照关注顺序排列:留空<br />按照最常访问排列attention |
| order_type | str | 排序方式 | 非必要 | 当目标用户为自己时有效<br />按照关注顺序排列:留空<br />按照最常访问排列attention |
| ps | num | 每页项数 | 非必要 | 默认为 50 |
| pn | num | 页码 | 非必要 | 默认为 1<br />其他用户仅可查看前 5 页 |
| pn | num | 页码 | 非必要 | 默认为 1<br />其他用户仅可查看前 100 个 |
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0成功<br />-400请求错误<br />22007访问超过 5 页<br />22115用户已设置隐私无法查看 |
| message | str | 错误信息 | 默认为 0 |
| ttl | num | 1 | |
| data | obj | 信息本体 | |
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ---------------------------------------------------------------- |
| code | num | 返回值 | 0成功<br />-101账号未登录<br />-352请求被拦截<br />-400请求错误<br />22115用户已设置隐私无法查看 |
| message | str | 错误信息 | 默认为 0 |
| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data`对象:
@ -318,7 +334,7 @@ curl -G 'https://api.bilibili.com/x/relation/followings' \
*请求方式GET*
仅可查看前 5 页,可以获取已设置可见性隐私的关注列表
仅可查看前 5 页,对于已设置可见性隐私关注列表的用户,`$.data.list` 为 null`$.data.total` 为0
**url参数**
@ -384,7 +400,7 @@ curl -G 'https://api.bilibili.com/x/relation/followings' \
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ------------ | ------------------- |
| type | num | 用户认证类型 | -1<br />1认证 |
| type | num | 用户认证类型 | -1<br />0UP主认证<br />1机构认证 |
| desc | str | 用户认证信息 | 无为空 |
`list`中的对象中的`vip`对象:
@ -485,6 +501,96 @@ curl -G 'https://app.biliapi.net/x/v2/relation/followings' \
</details>
## 查询用户关注明细3
<img src="../../assets/img/relation.svg" width="100" height="100" />
> https://line3-h5-mobile-api.biligame.com/game/center/h5/user/relationship/following_list
*请求方式GET*
对于设置了可见性隐私关注列表的用户会返回空列表
**url参数**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------ | ----------- | -------- |
| vmid | num | 目标用户mid | 必要 | |
| ps | num | 每页项数 | 非必要 | 默认为20 |
| pn | num | 页码 | 非必要 | 默认为1 |
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ---- | ---------- | --------------------------- |
| code | num | 返回值 | 0成功<br />-400请求错误 |
| message | str | 错误信息 | 成功时无此项 |
| data | obj | 信息本体 | 失败时无此项 |
| ts | num | 当前时间戳 | 单位为毫秒 |
| request_id | str | 请求id | |
`data`对象:
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ----- | -------- | ------------ |
| list | array | 明细列表 | |
`data`中的`list`数组:
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | --------- | ---------------- |
| 0 | obj | 关注1 | |
| n | obj | 关注(n+1) | 按照关注顺序排列 |
| …… | obj | …… | …… |
数组`list`中的对象:
| 字段 | 类型 | 内容 | 备注 |
| --------------- | ---- | ----------- | --------------------------------------- |
| mid | str | 用户mid | |
| attribute | num | 关注属性 | 0未关注<br />2已关注<br />6已互粉 |
| uname | str | 用户昵称 | |
| face | str | 用户头像url | |
**示例:**
获取用户`mid=293793435`的关注明细
```shell
curl -G 'https://line3-h5-mobile-api.biligame.com/game/center/h5/user/relationship/following_list' \
--data-urlencode 'vmid=293793435' \
--data-urlencode 'ps=2' \
--data-urlencode 'pn=1'
```
<details>
<summary>查看响应示例:</summary>
```json
{
"code": 0,
"data": {
"list": [{
"mid": "14082",
"attribute": 2,
"uname": "山新",
"face": "https://i0.hdslb.com/bfs/face/74c82caee6d9eb623e56161ea8ed6d68afabfeae.jpg"
}, {
"mid": "420831218",
"attribute": 2,
"uname": "支付宝Alipay",
"face": "https://i2.hdslb.com/bfs/face/aaf18aeb2d9822e28a590bd8d878572ca8c59e04.jpg"
}]
},
"ts": 1677410818395,
"request_id": "d9d541b9f2d24e21821e2d6d2d16c17d"
}
```
</details>
### 搜索关注明细
> https://api.bilibili.com/x/relation/followings/search
@ -1700,12 +1806,14 @@ curl 'https://api.bilibili.com/x/relation/tags' \
| track_id | str | | |
`data`对象中的`official_verify`
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ------------ | ---- |
| type | num | 0 | |
| desc | str | 官方认证内容 | |
`data`对象中的`live`
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | -------- | -------------------- |
| live_status | num | 0或1 | 0未开播1已直播 |

View File

@ -1,57 +1,5 @@
# 用户空间相关
- [主页](#主页)
- [置顶视频](#置顶视频)
- [查询用户置顶视频](#查询用户置顶视频)
- [设置置顶视频](#设置置顶视频)
- [取消置顶视频](#取消置顶视频)
- [代表作视频](#代表作视频)
- [查询用户代表作视频列表](#查询用户代表作视频列表)
- [添加代表作视频](#添加代表作视频)
- [删除代表作视频](#删除代表作视频)
- [个人TAG](#个人tag)
- [查看用户个人TAG](#查看用户个人tag)
- [修改个人TAG](#修改个人tag)
- [空间公告](#空间公告)
- [查看用户空间公告](#查看用户空间公告)
- [修改空间公告](#修改空间公告)
- [主页板块布局与权限](#主页板块布局与权限)
- [查询空间设置](#查询空间设置)
- [调整空间板块布局](#调整空间板块布局)
- [修改空间隐私权限](#修改空间隐私权限)
- [查询用户最近访问内容](#查询用户最近访问内容)
- [查询用户最近玩过的游戏](#查询用户最近玩过的游戏)
- [查询用户最近玩过的游戏V2](#查询用户最近玩过的游戏V2)
- [查询用户最近投币视频Web](#查询用户最近投币视频Web)
- [查询用户最近投币视频APP](#查询用户最近投币视频APP)
- [查询用户最近点赞视频Web](#查询用户最近点赞视频Web)
- [查询用户最近点赞视频APP](#查询用户最近点赞视频APP)
- [投稿](#投稿)
- [查询用户投稿视频明细](#查询用户投稿视频明细)
- [查询用户投稿相簿预览](#查询用户投稿相簿预览)
- [查询用户投稿相簿明细](#查询用户投稿相簿明细)
- [频道](#频道)
- [查询用户频道列表](#查询用户频道列表)
- [查询用户频道中的视频](#查询用户频道中的视频)
- [创建频道](#创建频道)
- [修改频道](#修改频道)
- [删除频道](#删除频道)
- [频道添加视频](#频道添加视频)
- [频道删除视频](#频道删除视频)
- [调整频道视频排序](#调整频道视频排序)
- [检查频道中有无失效视频](#检查频道中有无失效视频)
- [收藏](#收藏)
- [查询用户创建的视频收藏夹](#查询用户创建的视频收藏夹)
- [查询用户收藏的视频收藏夹](#查询用户收藏的视频收藏夹)
- [课程](#课程)
- [查询用户发布的课程列表](#查询用户发布的课程列表)
- [订阅](#订阅)
- [查询用户追番预览列表](#查询用户追番预览列表)
- [查询用户追番(追剧)明细](#查询用户追番追剧明细)
- [查询用户关注的TAG话题](#查询用户关注的tag话题)
---
## 主页
<img src="../../assets/img/home.svg" width="100" height="100" />

View File

@ -46,8 +46,8 @@
| ctime | num | 用户投稿时间 | 秒级时间戳 |
| desc | str | 视频简介 | |
| desc_v2 | array | 新版视频简介 | |
| state | num | 视频状态 | 详情见[属性数据文档](attribute_data.md#attribute字段值(稿件属性位)) |
| ~~attribute~~(已经弃用) | ~~num~~ | ~~稿件属性位配置~~ | 详情见[属性数据文档](attribute_data.md#state字段值(稿件状态)) |
| state | num | 视频状态 | 详情见[属性数据文档](attribute_data.md#state字段值(稿件状态)) |
| ~~attribute~~(已经弃用) | ~~num~~ | ~~稿件属性位配置~~ | 详情见[属性数据文档](attribute_data.md#attribute字段值(稿件属性位)) |
| duration | num | 稿件总时长(所有分P) | 单位为秒 |
| forward | num | 撞车视频跳转avid | 仅撞车视频存在此字段 |
| mission_id | num | 稿件参与的活动id | |
@ -1474,7 +1474,7 @@ curl -G 'https://api.bilibili.com/x/web-interface/view/detail' \
"title": "𓀬古埃及𓀯宽带广告𓀿𓀶𓈷𓉅 𓁞 𓁟𓂮 𓂯𓃠𓃄𓀰 𓀱𓀐𓀡 𓀼 𓀽𓁀𓉆𓁀𓁁𓁂𓁃𓁄𓁅𓁆𓀷𓀾",
"pubdate": 1612174676,
"ctime": 1612174676,
"desc": "??? ?最新?发掘出的 ?古埃及?宽带? 广告? ?? ???? ??? ? ???\n??汉谟拉比?宽带??? BV1rv411s7b6\n印尼宽带西藏特供版ཧིན་ཉི་ཐགས་ཡངས་དམིགས་བསལ་མཁོ་འདོན་པར་གཞི་BV1ao4y1d7VH\n印औ度ष宽फ 带(梵ह文)औगळऴॊवशछजॊझञस BV1bA411u7Fy\n【乱<EFBFBD>码】此 宽 带 无 法 显 示<><E7A4BA><EFBFBD><EFBFBD> 迠鐩\u0007\u0010内<30>暫?\u0015\fV/豬嶬<E8B1AC>源=塇 BV1P54y1W75k",
"desc": "??? ?最新?发掘出的 ?古埃及?宽带? 广告? ?? ???? ??? ? ???\n??汉谟拉比?宽带??? BV1rv411s7b6\n印尼宽带西藏特供版ཧིན་ཉི་ཐགས་ཡངས་དམིགས་བསལ་མཁོ་འདོན་པར་གཞི་BV1ao4y1d7VH\n印औ度ष宽फ 带(梵ह文)औगळऴॊवशछजॊझञस BV1bA411u7Fy\n【乱 码】此 宽 带 无 法 显 示 迠鐩\u0007\u0010内 暫?\u0015\fV/豬嶬 源=塇 BV1P54y1W75k",
"state": 0,
"duration": 37,
"rights": {
@ -3338,7 +3338,7 @@ curl -G 'https://api.bilibili.com/x/web-interface/view/detail' \
"title": "【8K超高清重制版】印尼魔性电信广告原版完整版IndiHome Paket Phoenix",
"pubdate": 1611702584,
"ctime": 1611702584,
"desc": "前面那个被锁了,现在重投了\n原版看累了来康康up的其他印尼宽带视频吧\n哔哩哔哩大会员广告印尼特供版 8K超高清重制版BV14T4y1K7gY\n印尼宽带西藏特供版ཧིན་ཉི་ཐགས་ཡངས་དམིགས་བསལ་མཁོ་འདོན་པར་གཞི་BV1ao4y1d7VH\n【4K⁶⁰ᶠᵖˢ】这里有一个初音给你的视频唷 BV19T4y1A7fJ\n古埃及宽带广告最新出土av331415167\n汉谟拉比宽带 BV1rv411s7b6\n【乱<EFBFBD>码】此 宽 带 无 法 显 示<><E7A4BA><EFBFBD> 迠鐩<E8BFA0>BV1P54y1W75k",
"desc": "前面那个被锁了,现在重投了\n原版看累了来康康up的其他印尼宽带视频吧\n哔哩哔哩大会员广告印尼特供版 8K超高清重制版BV14T4y1K7gY\n印尼宽带西藏特供版ཧིན་ཉི་ཐགས་ཡངས་དམིགས་བསལ་མཁོ་འདོན་པར་གཞི་BV1ao4y1d7VH\n【4K⁶⁰ᶠᵖˢ】这里有一个初音给你的视频唷 BV19T4y1A7fJ\n古埃及宽带广告最新出土av331415167\n汉谟拉比宽带 BV1rv411s7b6\n【乱 码】此 宽 带 无 法 显 示 迠鐩 BV1P54y1W75k",
"state": 0,
"duration": 262,
"rights": {