From 93b4a09aa0cb45e1d856198d10f660365ea684be Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E6=99=A8=E5=8F=B6=E6=A2=A6=E6=98=A5?= <65224318+wuziqian211@users.noreply.github.com> Date: Tue, 15 Apr 2025 22:09:45 +0800 Subject: [PATCH] update --- README.md | 2 - docs/article/list.md | 677 +----------------------------------- docs/dynamic/publish.md | 2 +- docs/electric/monthly.md | 128 +++++-- docs/message/private_msg.md | 14 +- docs/user/space.md | 675 +++++++++++++++++++++++++++++++++++ 6 files changed, 780 insertions(+), 718 deletions(-) mode change 100644 => 120000 docs/article/list.md diff --git a/README.md b/README.md index 99170d1..fa8d610 100644 --- a/README.md +++ b/README.md @@ -126,7 +126,6 @@ B站 API 采用 C/S 结构，大多数接口为 REST API 和 gRPC，少部分接 - [x] [视频在线人数](docs/video/online.md) - [x] [视频 AI 摘要](docs/video/summary.md) - [ ] [稿件投诉](docs/video/appeal.md) - - [ ] [视频状态数](docs/video/status_number.md) - [ ] [视频合集](docs/video/collection.md) - [ ] [播放器](docs/video/player.md) - [ ] [剧集 (番剧、影视)](docs/bangumi) @@ -158,7 +157,6 @@ B站 API 采用 C/S 结构，大多数接口为 REST API 和 gRPC，少部分接 - [X] [基本信息](docs/article/info.md) - [X] [点赞 & 投币 & 收藏 & 分享](docs/article/action.md) - [X] [文集基本信息](docs/article/articles.md) - - [X] [获取用户专栏文章列表](docs/article/list.md) - [ ] [音频](docs/audio) - [x] [歌曲基本信息](docs/audio/info.md) - [ ] [歌单 & 音频收藏夹详细信息](docs/audio/music_list.md) diff --git a/docs/article/list.md b/docs/article/list.md deleted file mode 100644 index 29098bc..0000000 --- a/docs/article/list.md +++ /dev/null @@ -1,676 +0,0 @@ -# 获取用户专栏信息 - -## 获取用户专栏文章列表 - -> https://api.bilibili.com/x/space/wbi/article - -> ~~https://api.bilibili.com/x/space/article~~（旧链接） - -*请求方式：GET* - -认证方式：Cookie（SESSDATA） - -鉴权方式：[Wbi 签名](../misc/sign/wbi.md) - -**url参数：** - -| 参数名 | 类型 | 内容 | 必要性 | 备注 | -|------|-----|-------|--------------------------------------------------------------------------|-----| -| mid | num | 用户uid | | √ | -| pn | num | | 默认：1 | | -| ps | num | | 默认：30
范围：[1,30] | | -| sort | str | | `publish_time`：最新发布
`view`：最多阅读
`fav`：最多收藏
默认：`publish_time` | | - -**json回复：** - -根对象 - -| 字段 | 类型 | 内容 | 备注 | -|---------|-----|------|--------------------| -| code | num | 返回值 | 0：成功
-400：请求错误 | -| message | str | 错误信息 | 默认为0 | -| ttl | num | 1 | | -| data | obj | 信息本体 | | - -`data`对象 - -| 字段名 | 类型 | 内容 | 备注 | -|----------|-------|----------|-----| -| articles | array | 专栏文章信息列表 | | -| pn | num | 本次请求分页页数 | | -| ps | num | 本次请求分页大小 | | -| count | num | 专栏文章总数 | | - -`data`对象 -> `articles`数组中的对象 - -| 字段名 | 类型 | 内容 | 备注 | -|-------------------|-------|----------|------| -| id | num | 专栏文章id | | -| category | obj | 分类 | | -| categories | array | 分类 | | -| title | str | 标题 | | -| summary | str | 摘要 | | -| banner_url | str | 封面图 | | -| template_id | num | | | -| state | num | | | -| author | obj | UP主信息 | | -| reprint | num | | | -| image_urls | array | | | -| publish_time | num | 发布时间戳 | 单位：秒 | -| ctime | num | 提交时间戳 | 单位：秒 | -| stats | obj | 专栏文章数据统计 | | -| tags | array | 标签 | | -| words | num | | | -| dynamic | str | 粉丝动态文案 | | -| origin_image_urls | array | | | -| list | | `null` | | -| is_like | bool | | | -| media | obj | | | -| apply_time | str | `空串` | | -| check_time | str | `空串` | | -| original | num | | | -| act_id | num | | | -| dispute | | `null` | | -| authenMark | | `null` | | -| cover_avid | num | | | -| top_video_info | | `null` | | -| type | num | | | - -`data`对象 -> `articles`数组中的对象 -> `category`对象 - -| 字段名 | 类型 | 内容 | 备注 | -|-----------|-----|--------|-----| -| id | num | 分类id | | -| parent_id | num | 父级分类id | | -| name | str | 分类名称 | | - -`data`对象 -> `articles`数组中的对象 -> `categories`数组中的对象 - -| 字段名 | 类型 | 内容 | 备注 | -|-----------|-----|--------|-----| -| id | num | 分类id | | -| parent_id | num | 父级分类id | | -| name | str | 分类名称 | | - -`data`对象 -> `articles`数组中的对象 -> `author`对象 - -| 字段名 | 类型 | 内容 | 备注 | -|-----------------|-----|--------|-----| -| mid | num | 用户uid | | -| name | str | 用户名 | | -| face | str | 头像 | | -| pendant | obj | 头像框信息 | | -| official_verify | obj | 账号认证信息 | | -| nameplate | obj | 成就勋章信息 | | -| vip | obj | 大会员信息 | | - -`data`对象 -> `articles`数组中的对象 -> `author`对象 -> `pendant`对象 - -| 字段名 | 类型 | 内容 | 备注 | -|--------|-----|----------|-----| -| pid | num | 头像框id | | -| name | str | 头像框名称 | | -| image | str | 头像框图片url | | -| expire | num | 过期时间 | | - -`data`对象 -> `articles`数组中的对象 -> `author`对象 -> `official_verify`对象 - -| 字段名 | 类型 | 内容 | 备注 | -|------|-----|------|------------------------------| -| type | num | 是否认证 | -1：无
0：个人认证
1：机构认证 | -| desc | str | 认证备注 | | - -`data`对象 -> `articles`数组中的对象 -> `author`对象 -> `nameplate`对象 - -| 字段名 | 类型 | 内容 | 备注 | -|-------------|-----|---------|-----| -| nid | num | 勋章id | | -| name | str | 勋章名称 | | -| image | str | 勋章图标 | | -| image_small | str | 勋章图标（小） | | -| level | str | 勋章等级 | | -| condition | str | 获取条件 | | - -`data`对象 -> `articles`数组中的对象 -> `author`对象 -> `vip`对象 - -| 字段名 | 类型 | 内容 | 备注 | -|------------------|-----|------------|---------------------------------| -| type | num | 大会员类型 | 0：无
1：月大会员
2：年度及以上大会员 | -| status | num | 大会员状态 | 0：无
1：有 | -| due_date | num | 大会员过期时间时间戳 | 单位：毫秒 | -| vip_pay_type | num | 支付类型 | | -| theme_type | num | `0` | | -| label | obj | 大会员标签 | | -| avatar_subscript | num | 是否显示大会员图标 | 0：不显示
1：显示 | -| nickname_color | str | 大会员昵称颜色 | | - -`data`对象 -> `articles`数组中的对象 -> `author`对象 -> `vip`对象 -> `label`对象 - -| 字段名 | 类型 | 内容 | 备注 | -|-------------|-----|--------|------------------------------------------------------------------------------------------------------------------------------| -| path | str | `空串` | | -| text | str | 会员类型文案 | `大会员` `年度大会员` `十年大会员` `百年大会员` `最强绿鲤鱼` | -| label_theme | str | 会员标签 | vip：大会员
annual_vip：年度大会员
ten_annual_vip：十年大会员
hundred_annual_vip：百年大会员
fools_day_hundred_annual_vip：最强绿鲤鱼 | - -`data`对象 -> `articles`数组中的对象 -> `stats`对象 - -| 字段名 | 类型 | 内容 | 备注 | -|----------|-----|-----|-------| -| view | num | 浏览数 | | -| favorite | num | 收藏数 | | -| like | num | 点赞数 | | -| dislike | num | 点踩数 | 恒为`0` | -| reply | num | 回复数 | | -| share | num | 转发数 | | -| coin | num | 投币数 | | -| dynamic | num | | | - -`data`对象 -> `articles`数组中的对象 -> `tags`数组中的对象 - -| 字段名 | 类型 | 内容 | 备注 | -|------|-----|------|-----| -| tid | num | 标签id | | -| name | str | 标签名称 | | - -`data`对象 -> `articles`数组中的对象 -> `media`对象 - -| 字段名 | 类型 | 内容 | 备注 | -|-----------|-----|------|-----| -| score | num | `0` | | -| media_id | num | `0` | | -| title | str | `空串` | | -| cover | str | `空串` | | -| area | str | `空串` | | -| type_id | num | `0` | | -| type_name | str | `空串` | | -| spoiler | num | `0` | | - -**示例：** - -```shell -curl -L -X GET 'https://api.bilibili.com/x/space/article?mid=300021061&pn=1&ps=2&sort=publish_time' -``` - -
-查看响应示例： - -```json -{ - "code": 0, - "message": "0", - "ttl": 1, - "data": { - "articles": [ - { - "id": 18989884, - "category": { - "id": 15, - "parent_id": 3, - "name": "日常" - }, - "categories": [ - { - "id": 3, - "parent_id": 0, - "name": "生活" - }, - { - "id": 15, - "parent_id": 3, - "name": "日常" - } - ], - "title": "B站UP主日报2022年10月08日23点（v1.1）", - "summary": "冠：罗翔说刑法(2485.45万粉,+7204) 涨：肯德基(+18.37万粉) 掉：Overidea_China(-186850粉) 播：开心锤锤(+927.56万) 赞：荒草音乐(+31.02万) 赞：飞翔的丘丘人(+22.08万) 充：冰糖IO(+210)", - "banner_url": "https://i0.hdslb.com/bfs/article/5e53260f58f77fff0b8ba6b20179db85b8741b76.jpg", - "template_id": 4, - "state": 0, - "author": { - "mid": 300021061, - "name": "狸工智能", - "face": "https://i1.hdslb.com/bfs/face/4cba9bc9d6cf6935a37ec156dedb8f8d26c1df95.jpg", - "pendant": { - "pid": 0, - "name": "", - "image": "", - "expire": 0 - }, - "official_verify": { - "type": -1, - "desc": "" - }, - "nameplate": { - "nid": 3, - "name": "白银殿堂", - "image": "https://i2.hdslb.com/bfs/face/f6a31275029365ae5dc710006585ddcf1139bde1.png", - "image_small": "https://i2.hdslb.com/bfs/face/b09cdb4c119c467cf2d15db5263b4f539fa6e30b.png", - "level": "高级勋章", - "condition": "单个自制视频总播放数>=10万" - }, - "vip": { - "type": 0, - "status": 0, - "due_date": 0, - "vip_pay_type": 0, - "theme_type": 0, - "label": { - "path": "", - "text": "", - "label_theme": "" - }, - "avatar_subscript": 0, - "nickname_color": "" - } - }, - "reprint": 0, - "image_urls": [ - "https://i0.hdslb.com/bfs/article/8e5497f7854e7df3468fbc29b0dd10fcf17d1223.png" - ], - "publish_time": 1665278884, - "ctime": 1665278884, - "stats": { - "view": 689, - "favorite": 2, - "like": 61, - "dislike": 0, - "reply": 18, - "share": 0, - "coin": 1, - "dynamic": 0 - }, - "words": 0, - "dynamic": "狸子的UP主日报📰v1.1,每天稳定更新～（如果咕咕咕了，请艾特狸子LePtC检查狐务器 [tv_微笑] #排行榜##大数据##狸工智能#", - "origin_image_urls": [ - "https://i0.hdslb.com/bfs/article/5e53260f58f77fff0b8ba6b20179db85b8741b76.jpg" - ], - "list": null, - "is_like": false, - "media": { - "score": 0, - "media_id": 0, - "title": "", - "cover": "", - "area": "", - "type_id": 0, - "type_name": "", - "spoiler": 0 - }, - "apply_time": "", - "check_time": "", - "original": 1, - "act_id": 0, - "dispute": null, - "authenMark": null, - "cover_avid": 0, - "top_video_info": null, - "type": 0 - }, - { - "id": 18972446, - "category": { - "id": 15, - "parent_id": 3, - "name": "日常" - }, - "categories": [ - { - "id": 3, - "parent_id": 0, - "name": "生活" - }, - { - "id": 15, - "parent_id": 3, - "name": "日常" - } - ], - "title": "B站UP主日报2022年10月07日23点（v1.1）", - "summary": "冠：罗翔说刑法(2484.73万粉,+8020) 涨：靖菌命(+3.61万粉) 掉：Overidea_China(-8593粉) 播：开心锤锤(+971.44万) 赞：荒草音乐(+53.14万) 赞：南方都市报(+18.05万) 充：内德维德(+190)", - "banner_url": "https://i0.hdslb.com/bfs/article/5e53260f58f77fff0b8ba6b20179db85b8741b76.jpg", - "template_id": 4, - "state": 0, - "author": { - "mid": 300021061, - "name": "狸工智能", - "face": "https://i1.hdslb.com/bfs/face/4cba9bc9d6cf6935a37ec156dedb8f8d26c1df95.jpg", - "pendant": { - "pid": 0, - "name": "", - "image": "", - "expire": 0 - }, - "official_verify": { - "type": -1, - "desc": "" - }, - "nameplate": { - "nid": 3, - "name": "白银殿堂", - "image": "https://i2.hdslb.com/bfs/face/f6a31275029365ae5dc710006585ddcf1139bde1.png", - "image_small": "https://i2.hdslb.com/bfs/face/b09cdb4c119c467cf2d15db5263b4f539fa6e30b.png", - "level": "高级勋章", - "condition": "单个自制视频总播放数>=10万" - }, - "vip": { - "type": 0, - "status": 0, - "due_date": 0, - "vip_pay_type": 0, - "theme_type": 0, - "label": { - "path": "", - "text": "", - "label_theme": "" - }, - "avatar_subscript": 0, - "nickname_color": "" - } - }, - "reprint": 0, - "image_urls": [ - "https://i0.hdslb.com/bfs/article/8e5497f7854e7df3468fbc29b0dd10fcf17d1223.png" - ], - "publish_time": 1665189149, - "ctime": 1665189149, - "stats": { - "view": 1021, - "favorite": 1, - "like": 66, - "dislike": 0, - "reply": 21, - "share": 2, - "coin": 2, - "dynamic": 0 - }, - "tags": [ - { - "tid": 1598, - "name": "粉丝" - }, - { - "tid": 422982, - "name": "狸子" - }, - { - "tid": 526616, - "name": "大数据" - }, - { - "tid": 14082112, - "name": "狸工智能" - }, - { - "tid": 438, - "name": "排行榜" - } - ], - "words": 0, - "dynamic": "狸子的UP主日报📰v1.1,每天稳定更新～（如果咕咕咕了，请艾特狸子LePtC检查狐务器 [tv_微笑] #排行榜##大数据##狸工智能#", - "origin_image_urls": [ - "https://i0.hdslb.com/bfs/article/5e53260f58f77fff0b8ba6b20179db85b8741b76.jpg" - ], - "list": null, - "is_like": false, - "media": { - "score": 0, - "media_id": 0, - "title": "", - "cover": "", - "area": "", - "type_id": 0, - "type_name": "", - "spoiler": 0 - }, - "apply_time": "", - "check_time": "", - "original": 1, - "act_id": 0, - "dispute": null, - "authenMark": null, - "cover_avid": 0, - "top_video_info": null, - "type": 0 - } - ], - "pn": 1, - "ps": 2, - "count": 1563 - } -} -``` - -
- -## 获取用户专栏文集列表 - -> https://api.bilibili.com/x/article/up/lists - -*请求方式：GET* - -认证方式：Cookie（SESSDATA） - -**url参数：** - -| 参数名 | 类型 | 内容 | 必要性 | 备注 | -|----------|-----|-------|-----|-------------------| -| mid | num | 用户uid | √ | | -| sort | num | 排序方式 | | 0：最近更新
1：最多阅读 | -| jsonp | str | | | | -| callback | str | | | | - -**json回复：** - -根对象 - -| 字段名 | 类型 | 内容 | 备注 | -|---------|-----|------|--------------------| -| code | num | 响应码 | 0：成功
-400：请求错误 | -| message | str | 0 | | -| ttl | num | 1 | | -| data | obj | 信息本体 | | - -`data`对象 - -| 字段名 | 类型 | 内容 | 备注 | -|-------|-------|--------|-----| -| lists | array | 文集信息列表 | | -| total | num | 文集总数 | | - -`data`对象 -> `lists`数组中的对象 - -| 字段名 | 类型 | 内容 | 备注 | -|----------------|-----|---------|------| -| id | num | 文集id | | -| mid | num | 作者uid | | -| name | str | 文集名称 | | -| image_url | str | 封面 | | -| update_time | num | 最后更新时间戳 | 单位：秒 | -| ctime | num | 创建时间戳 | 单位：秒 | -| publish_time | num | | 单位：秒 | -| summary | str | `空串` | | -| words | num | 总字数 | | -| read | num | 阅读量 | | -| articles_count | num | 包含文章数 | | -| state | num | `1` | | -| reason | str | `空串` | | -| apply_time | str | `空串` | | -| check_time | str | `空串` | | - -**示例：** - -```shell -curl -X GET 'https://api.bilibili.com/x/article/up/lists' \ - --data-urlencode 'mid=2859372' \ - --data-urlencode 'sort=0' -``` - -
-点击查看 - -```json -{ - "code": 0, - "message": "0", - "ttl": 1, - "data": { - "lists": [ - { - "id": 77163, - "mid": 2859372, - "name": "碟报", - "image_url": "https://i0.hdslb.com/bfs/article/96d2b3d2a72e6497a011c885ab9245c51507ce18.png", - "update_time": 1664854854, - "ctime": 1554785697, - "publish_time": 1664863200, - "summary": "", - "words": 71532, - "read": 478726, - "articles_count": 113, - "state": 1, - "reason": "", - "apply_time": "", - "check_time": "" - }, - { - "id": 26407, - "mid": 2859372, - "name": "周榜", - "image_url": "https://i0.hdslb.com/bfs/article/96d2b3d2a72e6497a011c885ab9245c51507ce18.png", - "update_time": 1664721205, - "ctime": 1537942450, - "publish_time": 1664721307, - "summary": "", - "words": 102099, - "read": 1366280, - "articles_count": 206, - "state": 1, - "reason": "", - "apply_time": "", - "check_time": "" - }, - { - "id": 107952, - "mid": 2859372, - "name": "制作委员会", - "image_url": "https://i0.hdslb.com/bfs/article/96d2b3d2a72e6497a011c885ab9245c51507ce18.png", - "update_time": 1646663919, - "ctime": 1563107348, - "publish_time": 1646910000, - "summary": "", - "words": 47564, - "read": 72911, - "articles_count": 10, - "state": 1, - "reason": "", - "apply_time": "", - "check_time": "" - }, - { - "id": 26457, - "mid": 2859372, - "name": "实时榜", - "image_url": "https://i0.hdslb.com/bfs/article/96d2b3d2a72e6497a011c885ab9245c51507ce18.png", - "update_time": 1603115712, - "ctime": 1537955117, - "publish_time": 1603115719, - "summary": "", - "words": 206741, - "read": 1136352, - "articles_count": 76, - "state": 1, - "reason": "", - "apply_time": "", - "check_time": "" - }, - { - "id": 49769, - "mid": 2859372, - "name": "预测", - "image_url": "https://i0.hdslb.com/bfs/article/96d2b3d2a72e6497a011c885ab9245c51507ce18.png", - "update_time": 1593933314, - "ctime": 1546153226, - "publish_time": 1593933314, - "summary": "", - "words": 2518, - "read": 55123, - "articles_count": 6, - "state": 1, - "reason": "", - "apply_time": "", - "check_time": "" - }, - { - "id": 96916, - "mid": 2859372, - "name": "书籍周榜", - "image_url": "https://i0.hdslb.com/bfs/article/96d2b3d2a72e6497a011c885ab9245c51507ce18.png", - "update_time": 1559815260, - "ctime": 1559815159, - "publish_time": 1559815577, - "summary": "", - "words": 272, - "read": 2955, - "articles_count": 1, - "state": 1, - "reason": "", - "apply_time": "", - "check_time": "" - }, - { - "id": 96610, - "mid": 2859372, - "name": "原始周榜存档", - "image_url": "https://i0.hdslb.com/bfs/article/96d2b3d2a72e6497a011c885ab9245c51507ce18.png", - "update_time": 1559721231, - "ctime": 1559720762, - "publish_time": 1559721271, - "summary": "", - "words": 290, - "read": 1498, - "articles_count": 1, - "state": 1, - "reason": "", - "apply_time": "", - "check_time": "" - }, - { - "id": 26453, - "mid": 2859372, - "name": "杂谈", - "image_url": "https://i0.hdslb.com/bfs/article/96d2b3d2a72e6497a011c885ab9245c51507ce18.png", - "update_time": 1557303117, - "ctime": 1537954625, - "publish_time": 1557303168, - "summary": "", - "words": 10673, - "read": 38363, - "articles_count": 4, - "state": 1, - "reason": "", - "apply_time": "", - "check_time": "" - }, - { - "id": 59028, - "mid": 2859372, - "name": "新春访谈", - "image_url": "https://i0.hdslb.com/bfs/article/96d2b3d2a72e6497a011c885ab9245c51507ce18.png", - "update_time": 1549878596, - "ctime": 1549343048, - "publish_time": 1549884125, - "summary": "", - "words": 33472, - "read": 34597, - "articles_count": 13, - "state": 1, - "reason": "", - "apply_time": "", - "check_time": "" - } - ], - "total": 9 - } -} -``` - -
diff --git a/docs/article/list.md b/docs/article/list.md new file mode 120000 index 0000000..6dff8e0 --- /dev/null +++ b/docs/article/list.md @@ -0,0 +1 @@ +../user/space.md \ No newline at end of file diff --git a/docs/dynamic/publish.md b/docs/dynamic/publish.md index 8b9cfe9..e55101b 100644 --- a/docs/dynamic/publish.md +++ b/docs/dynamic/publish.md @@ -410,7 +410,7 @@ curl 'https://api.vc.bilibili.com/dynamic_svr/v1/dynamic_svr/create' \ | 字段 | 类型 | 内容 | 备注 | | --- | --- | --- | --- | -| code | num | 返回值 | 0：成功 | +| code | num | 返回值 | 0：成功
-101：账号未登录
4126021：你没有绑定手机，无法发布动态 | | message | str | 错误信息 | 成功为空 | | data | obj | 数据本体 | | diff --git a/docs/electric/monthly.md b/docs/electric/monthly.md index 2a51de1..24dcdcc 100644 --- a/docs/electric/monthly.md +++ b/docs/electric/monthly.md @@ -2,6 +2,24 @@ +## 常量说明 + +### 充电档位代码（`privilege_type`）与定价 + +| 代码 | 定价（单位：元人民币） | +| :--: | :--------------------: | +| 10 | 6 | +| 20 | 30 | +| 30 | 50 | +| 40 | 88 | +| 50 | 128 | +| 60 | 288 | +| 70 | 588 | +| 80 | 998 | +| 100 | 18 | +| 110 | 238 | +| 130 | 68 | + ## 获取包月充电列表 > https://api.live.bilibili.com/xlive/revenue/v1/guard/getChargeRecord @@ -49,31 +67,38 @@ 数组`list`中的对象： -| 字段 | 类型 | 内容 | 备注 | -| --------- | ----- | --------------- | ---------- | -| up_uid | num | 充电UP主mid | | -| user_name | str | 充电UP主昵称 | | -| user_face | str | 充电UP主头像url | | -| item | array | 充电详情 | | -| start | num | 开始充电时间 | 秒级时间戳 | +| 字段 | 类型 | 内容 | 备注 | +| ---------------- | ----- | ------------------------ | ---------- | +| up_uid | num | 充电UP主mid | | +| user_name | str | 充电UP主昵称 | | +| user_face | str | 充电UP主头像url | | +| item | array | 充电详情 | | +| start | num | 开始充电时间 | 秒级时间戳 | +| high_level_state | num | 是否可对UP主进行高档充电 | | +| elec_reply_state | num | 是否可对UP主进行专属问答 | 0：否
1：是
2：（？） | 数组`list`中的对象中的`item`数组： -| 项 | 类型 | 内容 | 备注 | -| ---- | ---- | -------- | -------- | -| 0 | obj | 充电详情 | 套了个娃 | +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | ------------- | -------- | +| 0 | obj | 充电档位1 | | +| n | obj | 充电档位(n+1) | | +| …… | obj | …… | …… | + 数组`item`中的对象： | 字段 | 类型 | 内容 | 备注 | | -------------- | --------------------------------------------- | ---------------- | ---------------- | -| privilege_type | num | 充电类型 | 10：普通包月充电
20：高档充电 | +| privilege_type | num | 充电档位代码 | 详见[充电档位代码与定价](#充电档位代码privilege_type与定价) | | icon | str | 充电图标 | | -| name | str | `包月充电` | | -| expire_time | num | 充电过期时间 | 秒级时间戳 | +| name | str | 充电档位名称 | | +| expire_time | num | 该档位过期时间 | 秒级时间戳 | | renew | 开启自动续费时：obj
关闭自动续费时：null | 充电自动续费详情 | | +| start_time | num | 该档位生效时间 | 秒级时间戳 | +| renew_list | 开启自动续费时：array
关闭自动续费时：null | 充电自动续费列表 | | -数组`item`中的对象中的`renew`对象： +`renew`对象、`renew_list`数组中的对象： | 字段 | 类型 | 内容 | 备注 | | ----------------- | ---- | ------------ | ------------------------------------------------- | @@ -86,6 +111,7 @@ | signed_price | num | 下次续费金额 | 单位为千分之一元人民币 | | pay_channel | num | 签约平台 | 2：微信支付
4：支付宝 | | period | num | 下次充电天数 | | +| mobile_app | num | 充电渠道 | 可为`android`等 | **示例：** @@ -117,7 +143,7 @@ curl 'https://api.live.bilibili.com/xlive/revenue/v1/guard/getChargeRecord' \ { "privilege_type": 10, "icon": "https://s1.hdslb.com/bfs/templar/york-static/lightning_icon@2x.png", - "name": "包月充电", + "name": "为TA充电", "expire_time": 1703519999, "renew": { "uid": 425503913, @@ -128,11 +154,29 @@ curl 'https://api.live.bilibili.com/xlive/revenue/v1/guard/getChargeRecord' \ "signed_time": 1671618921, "signed_price": 36000, "pay_channel": 2, - "period": 366 - } + "period": 366, + "mobile_app": "android" + }, + "start_time": 1671618921, + "renew_list": [ + { + "uid": 425503913, + "ruid": 2233, + "goods_id": 174, + "status": 1, + "next_execute_time": 1703174400, + "signed_time": 1671618921, + "signed_price": 36000, + "pay_channel": 2, + "period": 366, + "mobile_app": "android" + } + ] } ], - "start": 1669183804 + "start": 1669183804, + "high_level_state": 1, + "elec_reply_state": 1 }, { "up_uid": 293793435, @@ -142,7 +186,7 @@ curl 'https://api.live.bilibili.com/xlive/revenue/v1/guard/getChargeRecord' \ { "privilege_type": 10, "icon": "https://s1.hdslb.com/bfs/templar/york-static/lightning_icon@2x.png", - "name": "包月充电", + "name": "为TA充电", "expire_time": 1681401599, "renew": { "uid": 425503913, @@ -153,11 +197,29 @@ curl 'https://api.live.bilibili.com/xlive/revenue/v1/guard/getChargeRecord' \ "signed_time": 1677760921, "signed_price": 5000, "pay_channel": 4, - "period": 31 - } + "period": 31, + "mobile_app": "android" + }, + "start_time": 1677760921, + "renew_list": [ + { + "uid": 425503913, + "ruid": 293793435, + "goods_id": 173, + "status": 1, + "next_execute_time": 1680364800, + "signed_time": 1677760921, + "signed_price": 5000, + "pay_channel": 4, + "period": 31, + "mobile_app": "android" + } + ] } ], - "start": 1676033795 + "start": 1676033795, + "high_level_state": 1, + "elec_reply_state": 1 } ], "page": 1, @@ -273,8 +335,8 @@ curl 'https://api.bilibili.com/x/upower/item/detail' \ { "rank": 1, "mid": 425503913, - "nickname": "wuziqian211", - "avatar": "https://i2.hdslb.com/bfs/face/390f4b18b8b15c1f2ecdb6ee44e572aa18b9b2d0.png" + "nickname": "晨叶梦春", + "avatar": "https://i2.hdslb.com/bfs/face/540ed71e2fb2ddd8967c21b392026c34fc15673e.jpg" } ] }, @@ -333,6 +395,7 @@ curl 'https://api.bilibili.com/x/upower/item/detail' \ | 字段 | 类型 | 内容 | 备注 | | -------------- | ---- | ------------ | ---- | +| mid | num | UP主mid | | | nickname | str | UP主昵称 | | | official_title | str | UP主认证信息 | | | avatar | str | UP主头像url | | @@ -391,13 +454,14 @@ curl 'https://api.bilibili.com/x/upower/charge/follow/info' \ "data": { "days": 17, "up_card": { + "mid": 293793435, "nickname": "社会易姐QwQ", "official_title": "", "avatar": "https://i0.hdslb.com/bfs/face/aebb2639a0d47f2ce1fec0631f412eaf53d4a0be.jpg" }, "user_card": { - "avatar": "https://i2.hdslb.com/bfs/face/390f4b18b8b15c1f2ecdb6ee44e572aa18b9b2d0.png", - "nickname": "wuziqian211" + "avatar": "https://i2.hdslb.com/bfs/face/540ed71e2fb2ddd8967c21b392026c34fc15673e.jpg", + "nickname": "晨叶梦春" }, "remain_days": 15, "remain_less_1day": 0, @@ -408,8 +472,8 @@ curl 'https://api.bilibili.com/x/upower/charge/follow/info' \ { "rank": 1, "mid": 425503913, - "nickname": "wuziqian211", - "avatar": "https://i2.hdslb.com/bfs/face/390f4b18b8b15c1f2ecdb6ee44e572aa18b9b2d0.png" + "nickname": "晨叶梦春", + "avatar": "https://i2.hdslb.com/bfs/face/540ed71e2fb2ddd8967c21b392026c34fc15673e.jpg" } ] }, @@ -529,8 +593,8 @@ curl 'https://api.bilibili.com/x/upower/up/member/rank/v2' \ "rank_info": [ { "mid": 425503913, - "nickname": "wuziqian211", - "avatar": "https://i2.hdslb.com/bfs/face/390f4b18b8b15c1f2ecdb6ee44e572aa18b9b2d0.png", + "nickname": "晨叶梦春", + "avatar": "https://i2.hdslb.com/bfs/face/540ed71e2fb2ddd8967c21b392026c34fc15673e.jpg", "rank": 1, "day": 31, "expire_at": 0, @@ -539,8 +603,8 @@ curl 'https://api.bilibili.com/x/upower/up/member/rank/v2' \ ], "user_info": { "mid": 425503913, - "nickname": "wuziqian211", - "avatar": "https://i2.hdslb.com/bfs/face/390f4b18b8b15c1f2ecdb6ee44e572aa18b9b2d0.png", + "nickname": "晨叶梦春", + "avatar": "https://i2.hdslb.com/bfs/face/540ed71e2fb2ddd8967c21b392026c34fc15673e.jpg", "rank": 1, "day": 31, "expire_at": 1678723199, diff --git a/docs/message/private_msg.md b/docs/message/private_msg.md index ae4e11e..71a2d91 100644 --- a/docs/message/private_msg.md +++ b/docs/message/private_msg.md @@ -1,6 +1,6 @@ # 私信 -## 对象说明 +## 对象与常量说明 ### 会话对象 @@ -60,7 +60,7 @@ | sys_cancel | bool | 是否为系统撤回 | 仅当 `msg_type` 为 `5` 且此项值为 `true` 时有此项；若此项值为 `true`，表示目标消息是被系统撤回的，此时前端将不显示该私信且没有提示 | | notify_code | str | 通知代码 | 发送通知时使用，以下划线 `_` 分割，第 1 项表示主业务 id，第 2 项表示子业务 id；若这条私信非通知则为空文本；详细信息有待补充 | | new_face_version | num | 表情包版本 | 为 `0` 或无此项表示旧版表情包，此时 B 站会自动转换成新版表情包，例如 `[doge]` -> `[tv_doge]`；`1` 为新版 | -| msg_source | num | 消息来源 | 见[消息来源列表](#消息来源列表) | +| msg_source | num | 消息来源 | 见[消息来源列表](#消息来源列表msg_source) | `私信主体对象`中的`at_uids`数组： @@ -70,7 +70,7 @@ | n | num | 用户(n+1) | | | …… | num | …… | …… | -### 消息来源列表 +### 消息来源列表（`msg_source`） | 代码 | 含义 | 备注 | | ---- | ------------------------- | ----------------------------------- | @@ -86,7 +86,7 @@ | 9 | 自动回复 - 收到消息回复 | B站前端会显示“此条消息为自动回复” | | 10 | 自动回复 - 关键词回复 | B站前端会显示“此条消息为自动回复” | | 11 | 自动回复 - 大航海上船回复 | B站前端会显示“此条消息为自动回复” | -| 12 | 自动推送 - UP 主赠言 | 在以前稿件的自动推送与其附带的 UP 主赠言是 2 条不同的私信（其中 UP 主赠言的消息来源代码为 12），现在 UP 主赠言已被合并成为稿件自动推送消息的一部分（`attach_msg`） | +| 12 | 自动推送 - UP 主赠言 | 在以前稿件推送消息与其附带的 UP 主赠言是 2 条不同的私信（其中 UP 主赠言的消息来源代码为 12），现在 UP 主赠言已并入为[稿件自动推送消息](private_msg_content.md#视频推送消息msg_type11)的一部分（`attach_msg`） | | 13 | 粉丝团系统提示 | 如：粉丝团中的提示信息“欢迎xxx入群” | | 16 | 系统 | 目前仅在 `msg_type` 为 `51` 时使用该代码 | | 17 | 互相关注 | 互相关注时自动发送的私信“我们已互相关注，开始聊天吧~” | @@ -790,7 +790,7 @@ curl -G 'https://api.vc.bilibili.com/session_svr/v1/session_svr/session_detail' | text | str | 表情名称 | 包括左右两侧的中括号，如`[tv_doge]` | | uri | str | 表情链接 | | | size | num | 表情尺寸 | 1：小
2：大 | -| gif_url | str | 表情GIF链接 | 仅部分表情存在此项 | +| gif_url | str | 表情GIF链接 | 仅部分表情存在此项，如小电视表情 | **示例：** @@ -1255,7 +1255,7 @@ curl 'https://api.vc.bilibili.com/session_svr/v1/session_svr/update_ack' \ **仅支持发送 `msg[msg_type]` 为 `1`、`2` 或 `5` 的私信** -调用该接口同时会将该会话设置为已读 +调用该接口会将该会话设置为已读 **正文参数（application/x-www-form-urlencoded）：** @@ -1332,7 +1332,7 @@ public class Main { | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | ------------------------------------------------- | -| code | num | 返回值 | 0：成功
-3：系统错误
-101：账号未登录
-400：请求错误
10005：msgkey不存在
21007：消息过长，无法发送
21020：你发送消息频率过快，请稍后再发~
21026：不能给自己发送消息哦~
21028：由于系统升级，暂无法发送，敬请谅解
21035：该类消息暂时无法发送
21037：图片格式不合法，不要调戏接口啦
21041：消息已超期，不能撤回了哦
21042：消息已经撤回了哦
21046：你发消息的频率太高了，请在24小时后再发吧~
21047：对方主动回复或关注你前，最多发送1条消息~
25003：因对方隐私设置，暂无法给他发送聊天消息
25005：你已拉黑了对方，请先将对方移出黑名单后才能聊天
700013：已解散QAQ，无法执行此操作
700014：你已不在此同萌中QAQ，无法执行此操作 | +| code | num | 返回值 | 0：成功
-3：系统错误
-101：账号未登录
-400：请求错误
10005：msgkey不存在
21007：消息过长，无法发送
21015：为了维护社区的良好秩序，只有绑定手机号的账号才能发送消息
21020：你发送消息频率过快，请稍后再发~
21026：不能给自己发送消息哦~
21028：由于系统升级，暂无法发送，敬请谅解
21035：该类消息暂时无法发送
21037：图片格式不合法，不要调戏接口啦
21041：消息已超期，不能撤回了哦
21042：消息已经撤回了哦
21046：你发消息的频率太高了，请在24小时后再发吧~
21047：对方主动回复或关注你前，最多发送1条消息~
25003：因对方隐私设置，暂无法给他发送聊天消息
25005：你已拉黑了对方，请先将对方移出黑名单后才能聊天
700013：已解散QAQ，无法执行此操作
700014：你已不在此同萌中QAQ，无法执行此操作 | | message | str | 错误信息 | 成功时为0 | | ttl | num | | 默认为1 | | data | 有效时：obj
无效时：null | 信息本体 | | diff --git a/docs/user/space.md b/docs/user/space.md index 8b5838b..7130368 100644 --- a/docs/user/space.md +++ b/docs/user/space.md @@ -3066,6 +3066,681 @@ curl -G 'https://api.vc.bilibili.com/link_draw/v1/doc/doc_list' \ +### 查询用户投稿专栏明细 + +> https://api.bilibili.com/x/space/wbi/article + +> ~~https://api.bilibili.com/x/space/article~~（旧链接） + +*请求方式：GET* + +认证方式：Cookie（SESSDATA） + +鉴权方式：[Wbi 签名](../misc/sign/wbi.md) + +**url参数：** + +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +|------|-----|-------|--------------------------------------------------------------------------|-----| +| mid | num | 用户uid | | √ | +| pn | num | | 默认：1 | | +| ps | num | | 默认：30
范围：[1,30] | | +| sort | str | | `publish_time`：最新发布
`view`：最多阅读
`fav`：最多收藏
默认：`publish_time` | | + +**json回复：** + +根对象 + +| 字段 | 类型 | 内容 | 备注 | +|---------|-----|------|--------------------| +| code | num | 返回值 | 0：成功
-400：请求错误 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | obj | 信息本体 | | + +`data`对象 + +| 字段名 | 类型 | 内容 | 备注 | +|----------|-------|----------|-----| +| articles | array | 专栏文章信息列表 | | +| pn | num | 本次请求分页页数 | | +| ps | num | 本次请求分页大小 | | +| count | num | 专栏文章总数 | | + +`data`对象 -> `articles`数组中的对象 + +| 字段名 | 类型 | 内容 | 备注 | +|-------------------|-------|----------|------| +| id | num | 专栏文章id | | +| category | obj | 分类 | | +| categories | array | 分类 | | +| title | str | 标题 | | +| summary | str | 摘要 | | +| banner_url | str | 封面图 | | +| template_id | num | | | +| state | num | | | +| author | obj | UP主信息 | | +| reprint | num | | | +| image_urls | array | | | +| publish_time | num | 发布时间戳 | 单位：秒 | +| ctime | num | 提交时间戳 | 单位：秒 | +| stats | obj | 专栏文章数据统计 | | +| tags | array | 标签 | | +| words | num | | | +| dynamic | str | 粉丝动态文案 | | +| origin_image_urls | array | | | +| list | | `null` | | +| is_like | bool | | | +| media | obj | | | +| apply_time | str | `空串` | | +| check_time | str | `空串` | | +| original | num | | | +| act_id | num | | | +| dispute | | `null` | | +| authenMark | | `null` | | +| cover_avid | num | | | +| top_video_info | | `null` | | +| type | num | | | + +`data`对象 -> `articles`数组中的对象 -> `category`对象 + +| 字段名 | 类型 | 内容 | 备注 | +|-----------|-----|--------|-----| +| id | num | 分类id | | +| parent_id | num | 父级分类id | | +| name | str | 分类名称 | | + +`data`对象 -> `articles`数组中的对象 -> `categories`数组中的对象 + +| 字段名 | 类型 | 内容 | 备注 | +|-----------|-----|--------|-----| +| id | num | 分类id | | +| parent_id | num | 父级分类id | | +| name | str | 分类名称 | | + +`data`对象 -> `articles`数组中的对象 -> `author`对象 + +| 字段名 | 类型 | 内容 | 备注 | +|-----------------|-----|--------|-----| +| mid | num | 用户uid | | +| name | str | 用户名 | | +| face | str | 头像 | | +| pendant | obj | 头像框信息 | | +| official_verify | obj | 账号认证信息 | | +| nameplate | obj | 成就勋章信息 | | +| vip | obj | 大会员信息 | | + +`data`对象 -> `articles`数组中的对象 -> `author`对象 -> `pendant`对象 + +| 字段名 | 类型 | 内容 | 备注 | +|--------|-----|----------|-----| +| pid | num | 头像框id | | +| name | str | 头像框名称 | | +| image | str | 头像框图片url | | +| expire | num | 过期时间 | | + +`data`对象 -> `articles`数组中的对象 -> `author`对象 -> `official_verify`对象 + +| 字段名 | 类型 | 内容 | 备注 | +|------|-----|------|------------------------------| +| type | num | 是否认证 | -1：无
0：个人认证
1：机构认证 | +| desc | str | 认证备注 | | + +`data`对象 -> `articles`数组中的对象 -> `author`对象 -> `nameplate`对象 + +| 字段名 | 类型 | 内容 | 备注 | +|-------------|-----|---------|-----| +| nid | num | 勋章id | | +| name | str | 勋章名称 | | +| image | str | 勋章图标 | | +| image_small | str | 勋章图标（小） | | +| level | str | 勋章等级 | | +| condition | str | 获取条件 | | + +`data`对象 -> `articles`数组中的对象 -> `author`对象 -> `vip`对象 + +| 字段名 | 类型 | 内容 | 备注 | +|------------------|-----|------------|---------------------------------| +| type | num | 大会员类型 | 0：无
1：月大会员
2：年度及以上大会员 | +| status | num | 大会员状态 | 0：无
1：有 | +| due_date | num | 大会员过期时间时间戳 | 单位：毫秒 | +| vip_pay_type | num | 支付类型 | | +| theme_type | num | `0` | | +| label | obj | 大会员标签 | | +| avatar_subscript | num | 是否显示大会员图标 | 0：不显示
1：显示 | +| nickname_color | str | 大会员昵称颜色 | | + +`data`对象 -> `articles`数组中的对象 -> `author`对象 -> `vip`对象 -> `label`对象 + +| 字段名 | 类型 | 内容 | 备注 | +|-------------|-----|--------|------------------------------------------------------------------------------------------------------------------------------| +| path | str | `空串` | | +| text | str | 会员类型文案 | `大会员` `年度大会员` `十年大会员` `百年大会员` `最强绿鲤鱼` | +| label_theme | str | 会员标签 | vip：大会员
annual_vip：年度大会员
ten_annual_vip：十年大会员
hundred_annual_vip：百年大会员
fools_day_hundred_annual_vip：最强绿鲤鱼 | + +`data`对象 -> `articles`数组中的对象 -> `stats`对象 + +| 字段名 | 类型 | 内容 | 备注 | +|----------|-----|-----|-------| +| view | num | 浏览数 | | +| favorite | num | 收藏数 | | +| like | num | 点赞数 | | +| dislike | num | 点踩数 | 恒为`0` | +| reply | num | 回复数 | | +| share | num | 转发数 | | +| coin | num | 投币数 | | +| dynamic | num | | | + +`data`对象 -> `articles`数组中的对象 -> `tags`数组中的对象 + +| 字段名 | 类型 | 内容 | 备注 | +|------|-----|------|-----| +| tid | num | 标签id | | +| name | str | 标签名称 | | + +`data`对象 -> `articles`数组中的对象 -> `media`对象 + +| 字段名 | 类型 | 内容 | 备注 | +|-----------|-----|------|-----| +| score | num | `0` | | +| media_id | num | `0` | | +| title | str | `空串` | | +| cover | str | `空串` | | +| area | str | `空串` | | +| type_id | num | `0` | | +| type_name | str | `空串` | | +| spoiler | num | `0` | | + +**示例：** + +```shell +curl -L -X GET 'https://api.bilibili.com/x/space/article?mid=300021061&pn=1&ps=2&sort=publish_time' +``` + +
+查看响应示例： + +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "articles": [ + { + "id": 18989884, + "category": { + "id": 15, + "parent_id": 3, + "name": "日常" + }, + "categories": [ + { + "id": 3, + "parent_id": 0, + "name": "生活" + }, + { + "id": 15, + "parent_id": 3, + "name": "日常" + } + ], + "title": "B站UP主日报2022年10月08日23点（v1.1）", + "summary": "冠：罗翔说刑法(2485.45万粉,+7204) 涨：肯德基(+18.37万粉) 掉：Overidea_China(-186850粉) 播：开心锤锤(+927.56万) 赞：荒草音乐(+31.02万) 赞：飞翔的丘丘人(+22.08万) 充：冰糖IO(+210)", + "banner_url": "https://i0.hdslb.com/bfs/article/5e53260f58f77fff0b8ba6b20179db85b8741b76.jpg", + "template_id": 4, + "state": 0, + "author": { + "mid": 300021061, + "name": "狸工智能", + "face": "https://i1.hdslb.com/bfs/face/4cba9bc9d6cf6935a37ec156dedb8f8d26c1df95.jpg", + "pendant": { + "pid": 0, + "name": "", + "image": "", + "expire": 0 + }, + "official_verify": { + "type": -1, + "desc": "" + }, + "nameplate": { + "nid": 3, + "name": "白银殿堂", + "image": "https://i2.hdslb.com/bfs/face/f6a31275029365ae5dc710006585ddcf1139bde1.png", + "image_small": "https://i2.hdslb.com/bfs/face/b09cdb4c119c467cf2d15db5263b4f539fa6e30b.png", + "level": "高级勋章", + "condition": "单个自制视频总播放数>=10万" + }, + "vip": { + "type": 0, + "status": 0, + "due_date": 0, + "vip_pay_type": 0, + "theme_type": 0, + "label": { + "path": "", + "text": "", + "label_theme": "" + }, + "avatar_subscript": 0, + "nickname_color": "" + } + }, + "reprint": 0, + "image_urls": [ + "https://i0.hdslb.com/bfs/article/8e5497f7854e7df3468fbc29b0dd10fcf17d1223.png" + ], + "publish_time": 1665278884, + "ctime": 1665278884, + "stats": { + "view": 689, + "favorite": 2, + "like": 61, + "dislike": 0, + "reply": 18, + "share": 0, + "coin": 1, + "dynamic": 0 + }, + "words": 0, + "dynamic": "狸子的UP主日报📰v1.1,每天稳定更新～（如果咕咕咕了，请艾特狸子LePtC检查狐务器 [tv_微笑] #排行榜##大数据##狸工智能#", + "origin_image_urls": [ + "https://i0.hdslb.com/bfs/article/5e53260f58f77fff0b8ba6b20179db85b8741b76.jpg" + ], + "list": null, + "is_like": false, + "media": { + "score": 0, + "media_id": 0, + "title": "", + "cover": "", + "area": "", + "type_id": 0, + "type_name": "", + "spoiler": 0 + }, + "apply_time": "", + "check_time": "", + "original": 1, + "act_id": 0, + "dispute": null, + "authenMark": null, + "cover_avid": 0, + "top_video_info": null, + "type": 0 + }, + { + "id": 18972446, + "category": { + "id": 15, + "parent_id": 3, + "name": "日常" + }, + "categories": [ + { + "id": 3, + "parent_id": 0, + "name": "生活" + }, + { + "id": 15, + "parent_id": 3, + "name": "日常" + } + ], + "title": "B站UP主日报2022年10月07日23点（v1.1）", + "summary": "冠：罗翔说刑法(2484.73万粉,+8020) 涨：靖菌命(+3.61万粉) 掉：Overidea_China(-8593粉) 播：开心锤锤(+971.44万) 赞：荒草音乐(+53.14万) 赞：南方都市报(+18.05万) 充：内德维德(+190)", + "banner_url": "https://i0.hdslb.com/bfs/article/5e53260f58f77fff0b8ba6b20179db85b8741b76.jpg", + "template_id": 4, + "state": 0, + "author": { + "mid": 300021061, + "name": "狸工智能", + "face": "https://i1.hdslb.com/bfs/face/4cba9bc9d6cf6935a37ec156dedb8f8d26c1df95.jpg", + "pendant": { + "pid": 0, + "name": "", + "image": "", + "expire": 0 + }, + "official_verify": { + "type": -1, + "desc": "" + }, + "nameplate": { + "nid": 3, + "name": "白银殿堂", + "image": "https://i2.hdslb.com/bfs/face/f6a31275029365ae5dc710006585ddcf1139bde1.png", + "image_small": "https://i2.hdslb.com/bfs/face/b09cdb4c119c467cf2d15db5263b4f539fa6e30b.png", + "level": "高级勋章", + "condition": "单个自制视频总播放数>=10万" + }, + "vip": { + "type": 0, + "status": 0, + "due_date": 0, + "vip_pay_type": 0, + "theme_type": 0, + "label": { + "path": "", + "text": "", + "label_theme": "" + }, + "avatar_subscript": 0, + "nickname_color": "" + } + }, + "reprint": 0, + "image_urls": [ + "https://i0.hdslb.com/bfs/article/8e5497f7854e7df3468fbc29b0dd10fcf17d1223.png" + ], + "publish_time": 1665189149, + "ctime": 1665189149, + "stats": { + "view": 1021, + "favorite": 1, + "like": 66, + "dislike": 0, + "reply": 21, + "share": 2, + "coin": 2, + "dynamic": 0 + }, + "tags": [ + { + "tid": 1598, + "name": "粉丝" + }, + { + "tid": 422982, + "name": "狸子" + }, + { + "tid": 526616, + "name": "大数据" + }, + { + "tid": 14082112, + "name": "狸工智能" + }, + { + "tid": 438, + "name": "排行榜" + } + ], + "words": 0, + "dynamic": "狸子的UP主日报📰v1.1,每天稳定更新～（如果咕咕咕了，请艾特狸子LePtC检查狐务器 [tv_微笑] #排行榜##大数据##狸工智能#", + "origin_image_urls": [ + "https://i0.hdslb.com/bfs/article/5e53260f58f77fff0b8ba6b20179db85b8741b76.jpg" + ], + "list": null, + "is_like": false, + "media": { + "score": 0, + "media_id": 0, + "title": "", + "cover": "", + "area": "", + "type_id": 0, + "type_name": "", + "spoiler": 0 + }, + "apply_time": "", + "check_time": "", + "original": 1, + "act_id": 0, + "dispute": null, + "authenMark": null, + "cover_avid": 0, + "top_video_info": null, + "type": 0 + } + ], + "pn": 1, + "ps": 2, + "count": 1563 + } +} +``` + +
+ +### 查询用户专栏文集明细 + +> https://api.bilibili.com/x/article/up/lists + +*请求方式：GET* + +认证方式：Cookie（SESSDATA） + +**url参数：** + +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +|----------|-----|-------|-----|-------------------| +| mid | num | 用户uid | √ | | +| sort | num | 排序方式 | | 0：最近更新
1：最多阅读 | +| jsonp | str | | | | +| callback | str | | | | + +**json回复：** + +根对象 + +| 字段名 | 类型 | 内容 | 备注 | +|---------|-----|------|--------------------| +| code | num | 响应码 | 0：成功
-400：请求错误 | +| message | str | 0 | | +| ttl | num | 1 | | +| data | obj | 信息本体 | | + +`data`对象 + +| 字段名 | 类型 | 内容 | 备注 | +|-------|-------|--------|-----| +| lists | array | 文集信息列表 | | +| total | num | 文集总数 | | + +`data`对象 -> `lists`数组中的对象 + +| 字段名 | 类型 | 内容 | 备注 | +|----------------|-----|---------|------| +| id | num | 文集id | | +| mid | num | 作者uid | | +| name | str | 文集名称 | | +| image_url | str | 封面 | | +| update_time | num | 最后更新时间戳 | 单位：秒 | +| ctime | num | 创建时间戳 | 单位：秒 | +| publish_time | num | | 单位：秒 | +| summary | str | `空串` | | +| words | num | 总字数 | | +| read | num | 阅读量 | | +| articles_count | num | 包含文章数 | | +| state | num | `1` | | +| reason | str | `空串` | | +| apply_time | str | `空串` | | +| check_time | str | `空串` | | + +**示例：** + +```shell +curl -X GET 'https://api.bilibili.com/x/article/up/lists' \ + --data-urlencode 'mid=2859372' \ + --data-urlencode 'sort=0' +``` + +
+点击查看 + +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "lists": [ + { + "id": 77163, + "mid": 2859372, + "name": "碟报", + "image_url": "https://i0.hdslb.com/bfs/article/96d2b3d2a72e6497a011c885ab9245c51507ce18.png", + "update_time": 1664854854, + "ctime": 1554785697, + "publish_time": 1664863200, + "summary": "", + "words": 71532, + "read": 478726, + "articles_count": 113, + "state": 1, + "reason": "", + "apply_time": "", + "check_time": "" + }, + { + "id": 26407, + "mid": 2859372, + "name": "周榜", + "image_url": "https://i0.hdslb.com/bfs/article/96d2b3d2a72e6497a011c885ab9245c51507ce18.png", + "update_time": 1664721205, + "ctime": 1537942450, + "publish_time": 1664721307, + "summary": "", + "words": 102099, + "read": 1366280, + "articles_count": 206, + "state": 1, + "reason": "", + "apply_time": "", + "check_time": "" + }, + { + "id": 107952, + "mid": 2859372, + "name": "制作委员会", + "image_url": "https://i0.hdslb.com/bfs/article/96d2b3d2a72e6497a011c885ab9245c51507ce18.png", + "update_time": 1646663919, + "ctime": 1563107348, + "publish_time": 1646910000, + "summary": "", + "words": 47564, + "read": 72911, + "articles_count": 10, + "state": 1, + "reason": "", + "apply_time": "", + "check_time": "" + }, + { + "id": 26457, + "mid": 2859372, + "name": "实时榜", + "image_url": "https://i0.hdslb.com/bfs/article/96d2b3d2a72e6497a011c885ab9245c51507ce18.png", + "update_time": 1603115712, + "ctime": 1537955117, + "publish_time": 1603115719, + "summary": "", + "words": 206741, + "read": 1136352, + "articles_count": 76, + "state": 1, + "reason": "", + "apply_time": "", + "check_time": "" + }, + { + "id": 49769, + "mid": 2859372, + "name": "预测", + "image_url": "https://i0.hdslb.com/bfs/article/96d2b3d2a72e6497a011c885ab9245c51507ce18.png", + "update_time": 1593933314, + "ctime": 1546153226, + "publish_time": 1593933314, + "summary": "", + "words": 2518, + "read": 55123, + "articles_count": 6, + "state": 1, + "reason": "", + "apply_time": "", + "check_time": "" + }, + { + "id": 96916, + "mid": 2859372, + "name": "书籍周榜", + "image_url": "https://i0.hdslb.com/bfs/article/96d2b3d2a72e6497a011c885ab9245c51507ce18.png", + "update_time": 1559815260, + "ctime": 1559815159, + "publish_time": 1559815577, + "summary": "", + "words": 272, + "read": 2955, + "articles_count": 1, + "state": 1, + "reason": "", + "apply_time": "", + "check_time": "" + }, + { + "id": 96610, + "mid": 2859372, + "name": "原始周榜存档", + "image_url": "https://i0.hdslb.com/bfs/article/96d2b3d2a72e6497a011c885ab9245c51507ce18.png", + "update_time": 1559721231, + "ctime": 1559720762, + "publish_time": 1559721271, + "summary": "", + "words": 290, + "read": 1498, + "articles_count": 1, + "state": 1, + "reason": "", + "apply_time": "", + "check_time": "" + }, + { + "id": 26453, + "mid": 2859372, + "name": "杂谈", + "image_url": "https://i0.hdslb.com/bfs/article/96d2b3d2a72e6497a011c885ab9245c51507ce18.png", + "update_time": 1557303117, + "ctime": 1537954625, + "publish_time": 1557303168, + "summary": "", + "words": 10673, + "read": 38363, + "articles_count": 4, + "state": 1, + "reason": "", + "apply_time": "", + "check_time": "" + }, + { + "id": 59028, + "mid": 2859372, + "name": "新春访谈", + "image_url": "https://i0.hdslb.com/bfs/article/96d2b3d2a72e6497a011c885ab9245c51507ce18.png", + "update_time": 1549878596, + "ctime": 1549343048, + "publish_time": 1549884125, + "summary": "", + "words": 33472, + "read": 34597, + "articles_count": 13, + "state": 1, + "reason": "", + "apply_time": "", + "check_time": "" + } + ], + "total": 9 + } +} +``` + +
+ ### 查询用户投稿音频明细 > https://api.bilibili.com/audio/music-service/web/song/upper