Merge pull request #1231 from wuziqian211/patch-1

feat: 修改部分接口文档的描述,新增视频新版分区信息
This commit is contained in:
z0z0r4
2025-04-20 23:07:19 +08:00
committed by GitHub
51 changed files with 6447 additions and 4891 deletions

View File

@@ -1,4 +1,4 @@
# 专栏投币&点赞&收藏
# 专栏点赞&投币&收藏
## 点赞文章

46
docs/article/delete.md Normal file
View File

@@ -0,0 +1,46 @@
# 删除专栏
> <https://member.bilibili.com/x/web/article/delete>
*请求方式POST*
认证方式CookieSESSDATA
**正文参数application/x-www-form-urlencoded**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------------ | ------ | ---- |
| aid | num | 文章cvid | 必要 | |
| csrf | str | CSRF Token位于cookie | 必要 | |
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | --------- |
| code | num | 返回值 | 0成功<br />-101账号未登录<br />-111csrf校验失败<br />-400请求错误<br />-404无此项<br />37104无权限操作他人专栏 |
| message | str | 错误信息 | 默认为`0` |
| ttl | num | 1 | |
**示例:**
```shell
curl 'https://member.bilibili.com/x/web/article/delete' \
--data-urlencode 'aid=114514' \
--data-urlencode 'csrf=xxx' \
-b 'SESSDATA=xxx'
```
<details>
<summary>查看响应示例:</summary>
```json
{
"code": 0,
"message": "0",
"ttl": 1
}
```
</details>

View File

@@ -1,676 +0,0 @@
# 获取用户专栏信息
## 获取用户专栏文章列表
> https://api.bilibili.com/x/space/wbi/article
> ~~https://api.bilibili.com/x/space/article~~(旧链接)
*请求方式GET*
认证方式CookieSESSDATA
鉴权方式:[Wbi 签名](../misc/sign/wbi.md)
**url参数**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|------|-----|-------|--------------------------------------------------------------------------|-----|
| mid | num | 用户uid | | √ |
| pn | num | | 默认1 | |
| ps | num | | 默认30<br/>范围:[1,30] | |
| sort | str | | `publish_time`:最新发布<br/>`view`:最多阅读<br/>`fav`:最多收藏<br/>默认:`publish_time` | |
**json回复**
根对象
| 字段 | 类型 | 内容 | 备注 |
|---------|-----|------|--------------------|
| code | num | 返回值 | 0成功<br/>-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无<br />0个人认证<br />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无<br />1月大会员<br />2年度及以上大会员 |
| status | num | 大会员状态 | 0无<br />1有 |
| due_date | num | 大会员过期时间时间戳 | 单位:毫秒 |
| vip_pay_type | num | 支付类型 | |
| theme_type | num | `0` | |
| label | obj | 大会员标签 | |
| avatar_subscript | num | 是否显示大会员图标 | 0不显示<br />1显示 |
| nickname_color | str | 大会员昵称颜色 | |
`data`对象 -> `articles`数组中的对象 -> `author`对象 -> `vip`对象 -> `label`对象
| 字段名 | 类型 | 内容 | 备注 |
|-------------|-----|--------|------------------------------------------------------------------------------------------------------------------------------|
| path | str | `空串` | |
| text | str | 会员类型文案 | `大会员` `年度大会员` `十年大会员` `百年大会员` `最强绿鲤鱼` |
| label_theme | str | 会员标签 | vip大会员<br />annual_vip年度大会员<br />ten_annual_vip十年大会员<br />hundred_annual_vip百年大会员<br/>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'
```
<details>
<summary>查看响应示例:</summary>
```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
}
}
```
</details>
## 获取用户专栏文集列表
> https://api.bilibili.com/x/article/up/lists
*请求方式GET*
认证方式CookieSESSDATA
**url参数**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|----------|-----|-------|-----|-------------------|
| mid | num | 用户uid | √ | |
| sort | num | 排序方式 | | 0最近更新<br/>1最多阅读 |
| jsonp | str | | | |
| callback | str | | | |
**json回复**
根对象
| 字段名 | 类型 | 内容 | 备注 |
|---------|-----|------|--------------------|
| code | num | 响应码 | 0成功<br/>-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'
```
<details>
<summary>点击查看</summary>
```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
}
}
```
</details>

1
docs/article/list.md Symbolic link
View File

@@ -0,0 +1 @@
../user/space.md

View File

@@ -2,7 +2,7 @@
## 删除动态
> https://api.vc.bilibili.com/dynamic_svr/v1/dynamic_svr/rm_dynamic
> <https://api.vc.bilibili.com/dynamic_svr/v1/dynamic_svr/rm_dynamic>
*请求方式POST*
@@ -39,10 +39,10 @@
```shell
curl 'https://api.vc.bilibili.com/dynamic_svr/v1/dynamic_svr/rm_dynamic' \
--data-urlencode 'dynamic_id=588320531406678918' \
--data-urlencode 'csrf_token=xxx' \
--data-urlencode 'csrf=xxx' \
-b 'SESSDATA=xxx'
--data-urlencode 'dynamic_id=588320531406678918' \
--data-urlencode 'csrf_token=xxx' \
--data-urlencode 'csrf=xxx' \
-b 'SESSDATA=xxx'
```
<details>
@@ -50,12 +50,63 @@ curl 'https://api.vc.bilibili.com/dynamic_svr/v1/dynamic_svr/rm_dynamic' \
```json
{
"code": 0,
"msg": "",
"message": "",
"data": {
"_gt_": 0
}
"code": 0,
"msg": "",
"message": "",
"data": {
"_gt_": 0
}
}
```
</details>
## 删除定时发布动态
> <https://api.vc.bilibili.com/dynamic_draft/v1/dynamic_draft/rm_draft>
*请求方式POST*
认证方式CookieSESSDATA
**正文参数application/x-www-form-urlencoded**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | -------------- | ------ | ---- |
| draft_id | num | 定时发布动态id | 必要 | |
| csrf_token | str | csrf | 必要 | |
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------ |
| code | num | 返回值 | 0成功<br />4120015系统异常 |
| message | str | 错误信息 | |
| ttl | num | 1 | |
| data | obj | 数据本体 | 空对象,即`{}` |
**示例:**
删除定时发布动态`draft_id=755409289278914611`
```shell
curl 'https://api.vc.bilibili.com/dynamic_draft/v1/dynamic_draft/rm_draft' \
--data-urlencode 'draft_id=755409289278914611' \
--data-urlencode 'csrf=xxxx'
-b 'SESSDATA=xxx'
```
<details>
<summary>查看响应示例:</summary>
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {}
}
```

View File

@@ -410,7 +410,7 @@ curl 'https://api.vc.bilibili.com/dynamic_svr/v1/dynamic_svr/create' \
| 字段 | 类型 | 内容 | 备注 |
| --- | --- | --- | --- |
| code | num | 返回值 | 0成功 |
| code | num | 返回值 | 0成功<br />-101账号未登录<br />4126021你没有绑定手机无法发布动态 |
| message | str | 错误信息 | 成功为空 |
| data | obj | 数据本体 | |

View File

@@ -31,7 +31,7 @@
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0成功并不代表充电成功 <br />-101账号未登录<br />-111csrf校验失败<br />-400请求错误 |
| code | num | 返回值 | 0成功并不代表充电成功 <br />-101账号未登录<br />-111csrf校验失败<br />-400请求错误<br />-500服务器错误 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | obj | 信息本体 | |
@@ -72,17 +72,17 @@ curl 'https://api.bilibili.com/x/ugcpay/web/v2/trade/elec/pay/quick' \
```json
{
"code":0,
"message":"0",
"ttl":1,
"data":{
"mid":293793435,
"up_mid":293793435,
"order_no":"BPRG5CEC3VUPOOANA540",
"bp_num":2,
"exp":"2",
"status":4,
"msg":""
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"mid": 293793435,
"up_mid": 293793435,
"order_no": "BPRG5CEC3VUPOOANA540",
"bp_num": 2,
"exp": "2",
"status": 4,
"msg": ""
}
}
```
@@ -108,17 +108,17 @@ curl 'https://api.bilibili.com/x/ugcpay/web/v2/trade/elec/pay/quick' \
```json
{
"code":0,
"message":"0",
"ttl":1,
"data":{
"mid":0,
"up_mid":0,
"order_no":"",
"bp_num":"0",
"exp":0,
"status":-2,
"msg":"elec raw order create failed: 88201"
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"mid": 0,
"up_mid": 0,
"order_no": "",
"bp_num": "0",
"exp": 0,
"status": -2,
"msg": "elec raw order create failed: 88201"
}
}
```
@@ -145,17 +145,17 @@ curl 'https://api.bilibili.com/x/ugcpay/web/v2/trade/elec/pay/quick' \
```json
{
"code":0,
"message":"0",
"ttl":1,
"data":{
"mid":0,
"up_mid":0,
"order_no":"",
"bp_num":"0",
"exp":0,
"status":-4,
"msg":"bp.to.battery http failed, invalid args, errNo=800409904: B 币余额不足"
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"mid": 0,
"up_mid": 0,
"order_no": "",
"bp_num": "0",
"exp": 0,
"status": -4,
"msg": "bp.to.battery http failed, invalid args, errNo=800409904: B 币余额不足"
}
}
```
@@ -232,17 +232,17 @@ curl 'https://api.bilibili.com/x/ugcpay/trade/elec/pay/quick' \
```json
{
"code":0,
"message":"0",
"ttl":1,
"data":{
"mid":293793435,
"up_mid":293793435,
"order_no":"BPRG5CEC3VUPOOANA540",
"elec_num":20,
"exp":2,
"status":4,
"msg":""
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"mid": 293793435,
"up_mid": 293793435,
"order_no": "BPRG5CEC3VUPOOANA540",
"elec_num": 20,
"exp": 2,
"status": 4,
"msg": ""
}
}
```
@@ -268,17 +268,17 @@ curl 'https://api.bilibili.com/x/ugcpay/trade/elec/pay/quick' \
```json
{
"code":0,
"message":"0",
"ttl":1,
"data":{
"mid":0,
"up_mid":0,
"order_no":"",
"elec_num":0,
"exp":0,
"status":-2,
"msg":"elec raw order create failed: 88201"
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"mid": 0,
"up_mid": 0,
"order_no": "",
"elec_num": 0,
"exp": 0,
"status": -2,
"msg": "elec raw order create failed: 88201"
}
}
```
@@ -304,17 +304,17 @@ curl 'https://api.bilibili.com/x/ugcpay/trade/elec/pay/quick' \
```json
{
"code":0,
"message":"0",
"ttl":1,
"data":{
"mid":0,
"up_mid":0,
"order_no":"",
"elec_num":0,
"exp":0,
"status":-4,
"msg":"bp.to.battery http failed, invalid args, errNo=800409904: B 币余额不足"
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"mid": 0,
"up_mid": 0,
"order_no": "",
"elec_num": 0,
"exp": 0,
"status": -4,
"msg": "bp.to.battery http failed, invalid args, errNo=800409904: B 币余额不足"
}
}
```

View File

@@ -23,9 +23,9 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------------------- | ---- | ------------------------ | ------ | ------------------------------------------------------------ |
| bp_num | num | 充电B币数量 | 必要 | 必须在2-9999之间 |
| up_mid | num | 充电对象用户mid | 必要 | |
| bp_num | num | 充电B币数量 | 必要 | 必须在2-9999之间 |
| is_bp_remains_prior | bool | 是否优先扣除B币 | 必要 | true是<br />false否<br />在B币不足时剩余的部分利用支付平台支付 |
| up_mid | num | 充电对象用户mid | 必要 | |
| otype | str | 充电来源 | 必要 | up空间充电<br />archive视频充电 |
| oid | num | 充电来源代码 | 必要 | 空间充电充电对象用户mid<br />视频充电稿件avid |
| csrf | str | CSRF Token位于cookie | 必要 | |
@@ -118,7 +118,7 @@ curl 'https://api.bilibili.com/x/ugcpay/trade/elec/pay/qr_code/create' \
**示例:**
当申请到的支付二维码未被扫描时,`data`.`ststus`的值为`2`
当申请到的支付二维码未被扫描时,`data`.`status`的值为`2`
```shell
curl -G 'https://api.bilibili.com/x/ugcpay/trade/elec/pay/order/status' \
@@ -131,20 +131,20 @@ curl -G 'https://api.bilibili.com/x/ugcpay/trade/elec/pay/order/status' \
```json
{
"code":0,
"message":"0",
"ttl":1,
"data":{
"qr_token":"c7cbdc47fc424cd18f2146db653597b8",
"mid":293793435,
"status":2
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"qr_token": "c7cbdc47fc424cd18f2146db653597b8",
"mid": 293793435,
"status": 2
}
}
```
</details>
当申请到的支付二维码已扫描但未确认时,`data`.`ststus`的值为`3`
当申请到的支付二维码已扫描但未确认时,`data`.`status`的值为`3`
```shell
curl -G 'https://api.bilibili.com/x/ugcpay/trade/elec/pay/order/status' \
@@ -157,20 +157,20 @@ curl -G 'https://api.bilibili.com/x/ugcpay/trade/elec/pay/order/status' \
```json
{
"code":0,
"message":"0",
"ttl":1,
"data":{
"qr_token":"c7cbdc47fc424cd18f2146db653597b8",
"mid":293793435,
"status":3
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"qr_token": "c7cbdc47fc424cd18f2146db653597b8",
"mid": 293793435,
"status": 3
}
}
```
</details>
成功支付后,`data`.`ststus`的值为`1`,且`data`.`order_no`存在留言token
成功支付后,`data`.`status`的值为`1`,且`data`.`order_no`存在留言token
```shell
curl -G 'https://api.bilibili.com/x/ugcpay/trade/elec/pay/order/status' \
@@ -183,14 +183,14 @@ curl -G 'https://api.bilibili.com/x/ugcpay/trade/elec/pay/order/status' \
```json
{
"code":0,
"message":"0",
"ttl":1,
"data":{
"qr_token":"bd649c836c524550bfe22a369334fc05",
"order_no":"BPTD36U3KP82I31RSSLG",
"mid":293793435,
"status":1
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"qr_token": "bd649c836c524550bfe22a369334fc05",
"order_no": "BPTD36U3KP82I31RSSLG",
"mid": 293793435,
"status": 1
}
}
```

View File

@@ -42,7 +42,6 @@
| 0 | obj | 充电用户1 | |
| n | obj | 充电用户(n+1) | 按照充电排名排列 |
| …… | obj | …… | …… |
| 29 | obj | 充电用户30 | 最后一项 |
`data`中的`list`数组中的对象:
@@ -60,11 +59,11 @@
`list`数组中的对象中的`vip_info`对象:
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ---- | -------------------- | ----------------------------------------- |
| vipDueMsec | num | 大会员过期时间 | 恒为0 |
| vipStatus | num | 大会员状态 | 0无<br />1 |
| vipType | num | 大会员类型 | 0无<br />1月会员<br />2会员及以上 |
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ---- | -------------- | ----- |
| vipDueMsec | num | 大会员过期时间 | 恒为0 |
| vipStatus | num | 大会员状态 | 包月充电时恒为0<br />自定义充电:<br />0无<br />1 |
| vipType | num | 大会员类型 | 包月充电时恒为0<br />自定义充电:<br />0无<br />1会员<br />2及以上大会员 |
**示例:**
@@ -85,56 +84,33 @@ curl -G 'https://api.bilibili.com/x/ugcpay-rank/elec/month/up' \
"message": "",
"ttl": 0,
"data": {
"count": 397,
"count": 8521,
"list": [
{
"uname": "Mars韩笑",
"avatar": "https://i1.hdslb.com/bfs/face/a46599fa41cac672eda677e334f0be93cca02f1f.jpg",
"uname": "云梦澡堂",
"avatar": "https://i1.hdslb.com/bfs/face/6589df5fdac0f80593f6a86e4d88dc08e25df3d2.jpg",
"mid": 53456,
"pay_mid": 5683462,
"pay_mid": 1555775947,
"rank": 1,
"trend_type": 0,
"vip_info": {
"vipDueMsec": 0,
"vipStatus": 1,
"vipType": 2
},
"message": "你真棒你是奇迹Warma真的是太棒了",
"vip_info": { "vipDueMsec": 0, "vipStatus": 0, "vipType": 0 },
"message": "",
"message_hidden": 0
},
{
"uname": "愚星-",
"avatar": "https://i1.hdslb.com/bfs/face/7e4a8b150567a20a1b075aa3894dd3674a1e6ebe.jpg",
"uname": "在下小天子",
"avatar": "https://i1.hdslb.com/bfs/face/a3bfbe6186889bb50dcd87c1156d07a70227a25b.jpg",
"mid": 53456,
"pay_mid": 382630072,
"pay_mid": 508630801,
"rank": 2,
"trend_type": 0,
"vip_info": {
"vipDueMsec": 0,
"vipStatus": 1,
"vipType": 1
},
"message": "感谢您给我带来的快乐!我的人生遇见你是我的荣幸!!",
"message_hidden": 0
},
{
"uname": "なか酱",
"avatar": "https://i0.hdslb.com/bfs/face/d4b74091d7f1c336399625dc062ddc93d676bcdc.jpg",
"mid": 53456,
"pay_mid": 446080731,
"rank": 3,
"trend_type": 0,
"vip_info": {
"vipDueMsec": 0,
"vipStatus": 1,
"vipType": 2
},
"vip_info": { "vipDueMsec": 0, "vipStatus": 0, "vipType": 0 },
"message": "",
"message_hidden": 0
}
],
"total_count": 27291,
"total": 27291,
"total_count": 41919,
"total": 41919,
"special_day": 0
}
}
@@ -144,7 +120,7 @@ curl -G 'https://api.bilibili.com/x/ugcpay-rank/elec/month/up' \
## 获取视频充电鸣谢名单
> https://api.bilibili.com/x/web-interface/elec/show
> https://api.bilibili.com/x/web-interface/elec/show
*请求方式:GET*
@@ -169,22 +145,41 @@ curl -G 'https://api.bilibili.com/x/ugcpay-rank/elec/month/up' \
`data`对象:
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ----- | ---------------- | ------------ |
| show_info | obj | 展示选项 | |
| av_count | num | 目标视频充电人数 | |
| count | num | 本月充电人数 | |
| total_count | num | 总计充电人数 | |
| special_day | num | 0 | 作用尚不明确 |
| display_num | num | 0 | 作用尚不明确 |
| list | array | 本月充电用户列表 | |
| 字段 | 类型 | 内容 | 备注 |
| ------------- | ----- | ---------------- | ------------ |
| show_info | obj | 展示选项 | |
| av_count | num | 目标视频充电人数 | |
| count | num | 本月充电人数 | |
| total_count | num | 总计充电人数 | |
| special_day | num | 0 | 作用尚不明确 |
| display_num | num | 0 | 作用尚不明确 |
| cnt_priv_type | num | 0 | 作用尚不明确 |
| list | array | 本月充电用户列表 | |
`data`中的`show_info`对象:
| 字段 | 类型 | 内容 | 备注 |
| ----- | ---- | ------------------------ | ----------------------------- |
| show | bool | 是否展示视频充电鸣谢名单 | false不展示<br />true展示 |
| state | num | 0 | |
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ---- | ------------------------ | ---------------- |
| show | bool | 是否展示视频充电鸣谢名单 | |
| state | num | 充电功能开启状态 | -1未开通充电功能<br />1已开通自定义充电<br />2已开通包月、自定义充电<br />3已开通高档、自定义充电 |
| title | str | 充电按钮显示文字 | 空字符串或 `充电``充电中` |
| jump_url | str | 跳转url | |
| icon | str | 充电图标 | |
| high_level | obj | 高档充电信息 | |
`show_info`中的`high_level`对象:
| 字段 | 类型 | 内容 | 备注 |
| -------------- | ---- | ------------------------ | ---------------- |
| privilege_type | num | | |
| title | str | | |
| sub_title | str | | |
| show_button | bool | | |
| button_text | str | | |
| jump_url | obj | | |
| intro | str | | |
| open | bool | | |
| new | bool | | |
`data`中的`list`数组:
@@ -193,7 +188,6 @@ curl -G 'https://api.bilibili.com/x/ugcpay-rank/elec/month/up' \
| 0 | obj | 充电用户1 | |
| n | obj | 充电用户(n+1) | 按照充电排名排列 |
| …… | obj | …… | …… |
| 29 | obj | 充电用户30 | 最后一项 |
`data`中的`list`数组中的对象:
@@ -211,11 +205,11 @@ curl -G 'https://api.bilibili.com/x/ugcpay-rank/elec/month/up' \
`data`中的`list`数组中的`vip_info`对象:
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ---- | ---------- | ----------------------------------- |
| vipType | num | 大会员类型 | 0无<br />1月会员<br />2年会员 |
| vipDueMsec | num | 0 | 作用尚不明确 |
| vipStatus | num | 大会员状态 | 0无<br />1 |
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ---- | -------------- | ----- |
| vipType | num | 大会员类型 | 包月充电时恒为0<br />自定义充电:<br />0无<br />1会员<br />2度及以上大会员 |
| vipDueMsec | num | 大会员过期时间 | 恒为0 |
| vipStatus | num | 大会员状态 | 包月充电时恒为0<br />自定义充电:<br />0无<br />1 |
**示例:**
@@ -248,45 +242,51 @@ curl -G 'https://api.bilibili.com/x/web-interface/elec/show' \
"data": {
"show_info": {
"show": true,
"state": 0
"state": 2,
"title": "充电",
"jump_url": "https://www.bilibili.com/h5/upower/index?mid=53456&navhide=1&prePage=video&oid=967773538",
"icon": "https://i0.hdslb.com/bfs/garb/item/33e2e72d9a0c855f036b4cb55448f44af67a0635.png",
"high_level": {
"privilege_type": 0,
"title": "",
"sub_title": "",
"show_button": false,
"button_text": "",
"jump_url": { "up_link": "", "paywall_link": "", "previewbar_link": "" },
"intro": "",
"open": false,
"new": false
}
},
"av_count": 0,
"count": 0,
"total_count": 19422,
"total_count": 41919,
"special_day": 0,
"display_num": 0,
"cnt_priv_type": 0,
"list": [
{
"mid": 53456,
"pay_mid": 1216085164,
"pay_mid": 1555775947,
"rank": 1,
"uname": "JZ72",
"avatar": "http://i1.hdslb.com/bfs/face/3d741682fafc286999b5e8089a844ae4f46651fe.jpg",
"message": "Warma YYDS ",
"uname": "云梦澡堂",
"avatar": "https://i1.hdslb.com/bfs/face/6589df5fdac0f80593f6a86e4d88dc08e25df3d2.jpg",
"message": "",
"msg_deleted": 0,
"vip_info": {
"vipType": 2,
"vipDueMsec": 0,
"vipStatus": 1
},
"vip_info": { "vipType": 0, "vipDueMsec": 0, "vipStatus": 0 },
"trend_type": 0
},
{
"mid": 53456,
"pay_mid": 305858373,
"pay_mid": 508630801,
"rank": 2,
"uname": "适应性神经系统",
"avatar": "http://i0.hdslb.com/bfs/face/2ad38dec879f66c32b5e5cb1750cb3f3e446bf91.jpg",
"uname": "在下小天子",
"avatar": "https://i1.hdslb.com/bfs/face/a3bfbe6186889bb50dcd87c1156d07a70227a25b.jpg",
"message": "",
"msg_deleted": 0,
"vip_info": {
"vipType": 1,
"vipDueMsec": 0,
"vipStatus": 0
},
"vip_info": { "vipType": 0, "vipDueMsec": 0, "vipStatus": 0 },
"trend_type": 0
},
......
}
]
}
}
@@ -307,7 +307,7 @@ curl -G 'https://api.bilibili.com/x/web-interface/elec/show' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ----------- | ---- | -------- | ------ | ------------------- |
| currentPage | num | 页数 | 必要 | |
| pageSize | num | 分页大小 | 必要 | 取值范围[1,50] |
| pageSize | num | 分页大小 | 必要 | 取值范围\[1,50\] |
| customerId | num | (?) | 必要 | 目前为固定值10026 |
| beginTime | str | 开始日期 | 非必要 | yyyy-MM-dd |
| endTime | str | 结束日期 | 非必要 | yyyy-MM-dd |
@@ -318,12 +318,12 @@ curl -G 'https://api.bilibili.com/x/web-interface/elec/show' \
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | --------------------------- |
| code | num | 返回值 | 0成功<br />800501007user not login<br />800501008内部错误<br /> 800501011请求参数有误 |
| code | num | 返回值 | 0成功<br />800501007user not login<br />800501008内部错误<br />800501011请求参数有误 |
| errno | num | | |
| msg | str | | |
| showMsg | str | | |
| success | bool | | |
| data | obj | 信息本体 | |
| success | bool | | |
`data`对象:
@@ -342,18 +342,6 @@ curl -G 'https://api.bilibili.com/x/web-interface/elec/show' \
| totalCount | num | 记录总数 | |
| totalPage | num | 总页数 | |
`config`数组中的对象:
| 字段 | 类型 | 内容 | 备注 |
| ----------------- | ---- | ---- | ---------- |
| mid | null | | 总是为null |
| name | null | | 总是为null |
| avatar | null | | 总是为null |
| originalThirdCoin | null | | 总是为null |
| brokerage | null | | 总是为null |
| remark | null | | 总是为null |
| ctime | null | | 总是为null |
`result`数组中的对象:
| 字段 | 类型 | 内容 | 备注 |
@@ -366,6 +354,18 @@ curl -G 'https://api.bilibili.com/x/web-interface/elec/show' \
| remark | str | 充电渠道 | Web/安卓/iOS |
| ctime | str | 充电时间 | yyyy-MM-dd HH:mm:ss |
`config`数组中的对象:
| 字段 | 类型 | 内容 | 备注 |
| ----------------- | ---- | ---- | ---------- |
| mid | null | | 总是为null |
| name | null | | 总是为null |
| avatar | null | | 总是为null |
| originalThirdCoin | null | | 总是为null |
| brokerage | null | | 总是为null |
| remark | null | | 总是为null |
| ctime | null | | 总是为null |
**示例:**
```shell
@@ -469,7 +469,7 @@ curl -G 'https://pay.bilibili.com/bk/brokerage/listForCustomerRechargeRecord' \
| -------- | ---- | ---------- | ------------------- |
| aid | num | 0 | |
| bvid | str | 空 | |
| elec_num | num | 充电电池数 | |
| elec_num | num | 充电电池数 | |
| title | str | 空 | |
| uname | str | 空 | |
| avatar | str | 空 | |

View File

@@ -8,7 +8,7 @@
认证方式CookieSESSDATA
**正文参数( application/x-www-form-urlencoded **
**正文参数application/x-www-form-urlencoded**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| -------- | ---- | ------------------------ | ------ | ---- |
@@ -32,10 +32,10 @@
```shell
curl 'https://api.bilibili.com/x/ugcpay/trade/elec/message' \
--data-urlencode 'order_id=BPRG5CEC3VUPOOANA540' \
--data-urlencode 'message=支持一下大佬' \
--data-urlencode 'csrf=xxx' \
-b 'SESSDATA=xxx'
--data-urlencode 'order_id=BPRG5CEC3VUPOOANA540' \
--data-urlencode 'message=支持一下大佬' \
--data-urlencode 'csrf=xxx' \
-b 'SESSDATA=xxx'
```
<details>
@@ -43,9 +43,9 @@ curl 'https://api.bilibili.com/x/ugcpay/trade/elec/message' \
```json
{
"code":0,
"message":"0",
"ttl":1
"code": 0,
"message": "0",
"ttl": 1
}
```
@@ -55,71 +55,71 @@ curl 'https://api.bilibili.com/x/ugcpay/trade/elec/message' \
> https://member.bilibili.com/x/web/elec/remark/list
*请求方式:GET*
*请求方式GET*
认证方式CookieSESSDATA
**url参数**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------ | ------------ | ------------------ |
| begin | str | 起始日期 | | 默认2016-01-01 |
| end | str | 结束日期 | | 默认2050-01-01 |
| pn | str | 页数 | | |
| ps | str | 分页大小 | | 取值范围[1,12] |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | --------- | ------ | ---------------- |
| begin | str | 起始日期 | 非必要 | 默认2016-01-01 |
| end | str | 结束日期 | 非必要 | 默认2050-01-01 |
| pn | str | 页数 | 非必要 | |
| ps | str | 分页大小 | 非必要 | 取值范围\[1,12\] |
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | --------------------------- |
| code | num | 返回值 | 0成功<br />-101账号未登录|
| msg | str | 0 | |
| ttl | num | 1 | |
| data | obj | 信息本体 | |
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ----------------------------- |
| code | num | 返回值 | 0成功<br />-101账号未登录 |
| msg | str | 错误信息 | 成功时为`0` |
| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data`对象:
| 字段 | 类型 | 内容 | 备注 |
| -------- | ----- | ------ | ---- |
| page | obj | 分页信息 | |
| list | array | 信息本体 | |
`page`对象:
| 字段 | 类型 | 内容 | 备注 |
| -------- | ----- | ------ | ---- |
| current | num | 当前页数 | |
| size | num | 当前分页大小 | |
| total | num | 记录总数 | |
| 字段 | 类型 | 内容 | 备注 |
| ----- | ----- | -------- | ---- |
| list | array | 信息本体 | |
| pager | obj | 分页信息 | |
`list`数组中的对象:
| 字段 | 类型 | 内容 | 备注 |
| -------- | ----- | ------ | ---- |
| aid | num | | |
| bvid | str | | |
| id | num | 留言记录id | |
| mid | num | | |
| reply_mid | num | 0| |
| elec_num | num | 0 | |
| state | num | UP是否已经回复这条留言 | 0未回复<br />1已回复 |
| msg | str | 留言信息 | |
| aname | str | 空 | |
| uname | str |空 | |
| avator | str | 空 | |
| reply_name | str | 空 | |
| reply_avator | str | 空 | |
| reply_msg | str | 空 | |
| ctime | num | 留言时间 | 毫秒级时间戳 |
| reply_time | num | 0 | |
| 字段 | 类型 | 内容 | 备注 |
| ------------ | ---- | ---------------------- | ---- |
| aid | num | | |
| bvid | str | | |
| id | num | 留言记录id | |
| mid | num | 0 | |
| reply_mid | num | 0 | |
| elec_num | num | 0 | |
| state | num | UP是否已经回复这条留言 | 0未回复<br />1已回复 |
| msg | str | 留言信息 | |
| aname | str | 空 | |
| uname | str | 空 | |
| avator | str | 空 | |
| reply_name | str | 空 | |
| reply_avator | str | 空 | |
| reply_msg | str | 空 | |
| ctime | num | 留言时间 | 毫秒级时间戳 |
| reply_time | num | 0 | |
`pager`对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | ------------ | ---- |
| current | num | 当前页数 | |
| size | num | 当前分页大小 | |
| total | num | 记录总数 | |
**示例:**
```shell
curl -L -X GET 'https://member.bilibili.com/x/web/elec/remark/list?begin=2016-01-01&end=2050-01-01&pn=1&ps=10' \
-H 'Cookie: SESSDATA=xxx;'
curl 'https://member.bilibili.com/x/web/elec/remark/list?begin=2016-01-01&end=2050-01-01&pn=1&ps=10' \
-b 'SESSDATA=xxx'
```
<details>
@@ -166,51 +166,53 @@ curl -L -X GET 'https://member.bilibili.com/x/web/elec/remark/list?begin=2016-01
> https://member.bilibili.com/x/web/elec/remark/detail
*请求方式GET*
认证方式CookieSESSDATA
**url参数**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| -------- | ---- | -------- | ------ | -------------------------------- |
| id | num | 留言id | 必要 | |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ---- |
| id | num | 留言id | 必要 | |
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | --------------------------- |
| code | num | 返回值 | 0成功<br />-101账号未登录<br />-400请求错误|
| message | str | 0 | |
| ttl | num | 1 | |
| data | obj | 信息本体 | |
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------- |
| code | num | 返回值 | 0成功<br />-101账号未登录<br />-400请求错误 |
| message | str | 错误信息 | 成功时为 `0` |
| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data`对象:
| 字段 | 类型 | 内容 | 备注 |
| -------- | ----- | ------ | ---- |
| aid | num | | |
| bvid | str | | |
| id | num | 留言id | |
| mid | num | 留言者uid充电用户 | |
| reply_mid | num | UP主uid | |
| elec_num | num | 0 | |
| state | num | UP是否已经回复这条留言 | 0未回复<br />1已回复 |
| msg | str | 留言内容 | |
| aname | str | 空 | |
| uname | str | 留言者用户名 | |
| avator | str | 留言者头像 | |
| reply_name | str | UP主用户名 | |
| reply_avator | str | UP主头像 | |
| reply_msg | str | 回复内容 | |
| ctime | num | 留言时间 | 毫秒级时间戳 |
| reply_time | num | 回复时间 | 毫秒级时间戳 |
| 字段 | 类型 | 内容 | 备注 |
| ------------ | ---- | ---------------------- | ---- |
| aid | num | | |
| bvid | str | | |
| id | num | 留言id | |
| mid | num | 留言者mid充电用户 | |
| reply_mid | num | UP主mid | |
| elec_num | num | 0 | |
| state | num | UP是否已经回复这条留言 | 0未回复<br />1已回复 |
| msg | str | 留言内容 | |
| aname | str | 空 | |
| uname | str | 留言者用户名 | |
| avator | str | 留言者头像 | |
| reply_name | str | UP主用户名 | |
| reply_avator | str | UP主头像 | |
| reply_msg | str | 回复内容 | |
| ctime | num | 留言时间 | 毫秒级时间戳 |
| reply_time | num | 回复时间 | 毫秒级时间戳 |
**示例:**
```shell
curl -L -X GET 'https://member.bilibili.com/x/web/elec/remark/detail?id=6507563' \
-H 'cookie: SESSDATA=xxx'
curl 'https://member.bilibili.com/x/web/elec/remark/detail?id=6507563' \
-b 'SESSDATA=xxx'
```
<details>
@@ -252,13 +254,13 @@ curl -L -X GET 'https://member.bilibili.com/x/web/elec/remark/detail?id=6507563'
认证方式CookieSESSDATA
**正文参数( application/x-www-form-urlencoded **
**正文参数application/x-www-form-urlencoded**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------------ | ------ | ------------------------ | -------------- | ------------------------------------------------------------ |
| csrf | str | csrf | 必要 | |
| id | num | 留言id | 必要 | |
| msg | str | 回复信息 | | |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ---- |
| csrf | str | csrf | 必要 | |
| id | num | 留言id | 必要 | |
| msg | str | 回复信息 | 必要 | |
**json回复**
@@ -266,19 +268,19 @@ curl -L -X GET 'https://member.bilibili.com/x/web/elec/remark/detail?id=6507563'
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0成功<br />-101账号未登录<br />-111csrf 校验失败<br />-400请求错误20004充电服务异常<br /> |
| message | str | 错误信息 | |
| code | num | 返回值 | 0成功<br />-101账号未登录<br />-111csrf 校验失败<br />-400请求错误<br />20004充电服务异常 |
| message | str | 错误信息 | |
| ttl | num | 1 | |
| data | num | 数据本体 | 1成功<br />2失败 |
**示例:**
```shell
curl -L -X POST 'https://member.bilibili.com/x/web/elec/remark/reply' \
-H 'cookie: SESSDATA=xxx' \
-H 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'csrf=xxx' \
--data-urlencode 'id=6258929' \
--data-urlencode 'msg=( ̄3 ̄)'
curl 'https://member.bilibili.com/x/web/elec/remark/reply' \
-b 'SESSDATA=xxx' \
--data-urlencode 'csrf=xxx' \
--data-urlencode 'id=6258929' \
--data-urlencode 'msg=( ̄3 ̄)'
```
<details>

View File

@@ -2,6 +2,24 @@
<img src="../../assets/img/battery-100.png" width="100" height="100"/>
## 常量说明
### 充电档位代码(`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否<br />1是<br />2 |
数组`list`中的对象中的`item`数组:
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | -------- | -------- |
| 0 | obj | 充电详情 | 套了个娃 |
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ------------- | -------- |
| 0 | obj | 充电档位1 | |
| n | obj | 充电档位(n+1) | |
| …… | obj | …… | …… |
数组`item`中的对象:
| 字段 | 类型 | 内容 | 备注 |
| -------------- | --------------------------------------------- | ---------------- | ---------------- |
| privilege_type | num | 10 | **作用尚不明确** |
| privilege_type | num | 充电档位代码 | 详见[充电档位代码与定价](#充电档位代码privilege_type与定价) |
| icon | str | 充电图标 | |
| name | str | `包月充电` | |
| expire_time | num | 充电过期时间 | 时间戳 |
| name | str | 充电档位名称 | |
| expire_time | num | 该档位过期时间 | 秒级时间戳 |
| renew | 开启自动续费时obj<br />关闭自动续费时null | 充电自动续费详情 | |
| start_time | num | 该档位生效时间 | 秒级时间戳 |
| renew_list | 开启自动续费时array<br />关闭自动续费时null | 充电自动续费列表 | |
数组`item`中的对象中的`renew`对象:
`renew`对象、`renew_list`数组中的对象:
| 字段 | 类型 | 内容 | 备注 |
| ----------------- | ---- | ------------ | ------------------------------------------------- |
@@ -81,11 +106,12 @@
| ruid | num | UP主的mid | |
| goods_id | num | 充电类型 | 172一个月<br />173连续包月<br />174连续包年 |
| status | num | 充电状态 | 1 |
| next_execute_time | num | 下次续费时间 | 时间戳 |
| signed_time | num | 签约时间 | 时间戳 |
| next_execute_time | num | 下次续费时间 | 秒级时间戳 |
| signed_time | num | 签约时间 | 秒级时间戳 |
| signed_price | num | 下次续费金额 | 单位为千分之一元人民币 |
| pay_channel | num | 签约平台 | 2微信支付<br />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"
}
]
},
@@ -466,7 +530,7 @@ curl 'https://api.bilibili.com/x/upower/charge/follow/info' \
| nickname | str | UP主昵称 | |
| avatar | str | UP主头像url | |
| type | num | UP主认证类型 | -1无<br />0UP主认证<br />1机构认证 |
| title | str | UP主认证信息 | |
| title | str | UP主认证文字 | |
`data`中的`rank_info`数组:
@@ -476,7 +540,7 @@ curl 'https://api.bilibili.com/x/upower/charge/follow/info' \
| n | obj | 用户(n+1) | 按照充电排名排列 |
| …… | obj | …… | …… |
数组`rank_info`中的对象:
`rank_info`数组中的对象:
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | ---------------- | ----- |
@@ -497,14 +561,13 @@ curl 'https://api.bilibili.com/x/upower/charge/follow/info' \
| avatar | str | 用户头像url | |
| rank | num | 包月充电排名 | 不在包月充电用户列表里为-1 |
| day | num | 包月充电天数 | |
| expire_at | num | 包月充电过期时间 | 时间戳若从未给UP主包月充电为0 |
| expire_at | num | 包月充电过期时间 | 秒级时间戳若从未给UP主包月充电为0 |
| remain_days | num | 未过期时:剩余天数<br />已过期且之前给UP主包月充电过自过期以来的天数 | |
**示例:**
获取给`mid=293793435`包月充电的用户排名
```shell
curl 'https://api.bilibili.com/x/upower/up/member/rank/v2' \
--data-urlencode 'up_mid=293793435' \
@@ -530,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,
@@ -540,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,

View File

@@ -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小<br />2大 |
| gif_url | str | 表情GIF链接 | 仅部分表情存在此项 |
| gif_url | str | 表情GIF链接 | 仅部分表情存在此项,如小电视表情 |
**示例:**
@@ -1257,35 +1257,35 @@ curl 'https://api.vc.bilibili.com/session_svr/v1/session_svr/update_ack' \
**仅支持发送 `msg[msg_type]` 为 `1`、`2` 或 `5` 的私信**
调用该接口同时会将该会话设置为已读
调用该接口会将该会话设置为已读
**URL参数:**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| --- | --- | --- | --- | --- |
| w_sender_uid | num | 发送者mid | 必要 | 必须为自己的 mid |
| w_receiver_id | num | 接收者id | 必要 | `w_receiver_id``1` 时表示用户 mid`2` 时表示粉丝团 id |
| w_receiver_id | num | 接收者id | 必要 | 请求参数 `msg[receiver_type]``1` 时表示用户 mid`2` 时表示粉丝团 id |
| w_dev_id | str | 设备id | 必要 | 实质上即 UUID版本 4**生成方式见下** |
| w_rid | str | Wbi 签名 | 必要 | 参见 [Wbi 签名](../misc/sign/wbi.md) |
| wts | str | UNIX 秒级时间戳 | 必要 | 参见 [Wbi 签名](../misc/sign/wbi.md) |
**正文参数application/x-www-form-urlencoded**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| --------------------- | ---- | ------------------------ | ------ | ---------------------------------------------------- |
| msg[sender_uid] | num | 发送者mid | 必要 | 必须为自己的 mid |
| msg[receiver_id] | num | 接收者id | 必要 | `msg[receiver_type]``1` 时表示用户 mid`2` 时表示粉丝团 id |
| msg[receiver_type] | num | 接收者类型 | 必要 | 1用户<br />2粉丝团 |
| msg[msg_type] | num | 消息类型 | 必要 | 详见[私信消息类型、内容说明](private_msg_content.md)<br />**此接口仅支持传入 `1``2``5`** |
| msg[msg_status] | num | 消息状态 | 非必要 | 恒为 `0` |
| msg[dev_id] | str | 设备id | 必要 | 实质上即 UUID版本 4**生成方式见下** |
| msg[timestamp] | num | 当前时间戳(秒) | 必要 | |
| msg[new_face_version] | num | 表情包版本 | 非必要 | 提供 `0` 或者未提供本参数表示旧版表情包,此时 B 站会自动转换成新版表情包,例如 `[doge]` -> `[tv_doge]``1` 为新版 |
| msg[content] | str | 消息内容 | 必要 | 详见[私信消息类型、内容说明](private_msg_content.md) |
| csrf_token | str | CSRF Token位于cookie | 必要 | |
| csrf | str | CSRF Token位于cookie | 必要 | |
| build | num | 客户端内部版本号 | 非必要 | 默认为 `0` |
| mobi_app | str | 平台标识 | 非必要 | 可为 `web` 等 |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ----------------------- | ---- | ------------------------ | ------ | ---------------------------------------------------- |
| msg\[sender_uid\] | num | 发送者mid | 必要 | 必须为自己的 mid |
| msg\[receiver_id\] | num | 接收者id | 必要 | `msg[receiver_type]``1` 时表示用户 mid`2` 时表示粉丝团 id |
| msg\[receiver_type\] | num | 接收者类型 | 必要 | 1用户<br />2粉丝团 |
| msg\[msg_type\] | num | 消息类型 | 必要 | 详见[私信消息类型、内容说明](private_msg_content.md)<br />**此接口仅支持传入 `1``2``5`** |
| msg\[msg_status\] | num | 消息状态 | 非必要 | 恒为 `0` |
| msg\[dev_id\] | str | 设备id | 必要 | 实质上即 UUID版本 4**生成方式见下** |
| msg\[timestamp\] | num | 当前时间戳(秒) | 必要 | |
| msg\[new_face_version\] | num | 表情包版本 | 非必要 | 提供 `0` 或者未提供本参数表示旧版表情包,此时 B 站会自动转换成新版表情包,例如 `[doge]` -> `[tv_doge]``1` 为新版 |
| msg\[content\] | str | 消息内容 | 必要 | 详见[私信消息类型、内容说明](private_msg_content.md) |
| csrf_token | str | CSRF Token位于cookie | 必要 | |
| csrf | str | CSRF Token位于cookie | 必要 | |
| build | num | 客户端内部版本号 | 非必要 | 默认为 `0` |
| mobi_app | str | 平台标识 | 非必要 | 可为 `web` 等 |
---
@@ -1344,7 +1344,7 @@ public class Main {
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------- |
| code | num | 返回值 | 0成功<br />-3系统错误<br />-101账号未登录<br />-400请求错误<br />10005msgkey不存在<br />21007消息过长无法发送<br />21020你发送消息频率过快请稍后再发~<br />21026不能给自己发送消息哦~<br />21028由于系统升级暂无法发送敬请谅解<br />21035该类消息暂时无法发送<br />21037图片格式不合法不要调戏接口啦<br />21041消息已超期不能撤回了哦<br />21042消息已经撤回了哦<br />21046你发消息的频率太高了请在24小时后再发吧~<br />21047对方主动回复或关注你前最多发送1条消息~<br />25003因对方隐私设置暂无法给他发送聊天消息<br />25005你已拉黑了对方请先将对方移出黑名单后才能聊天<br />700013已解散QAQ无法执行此操作<br />700014你已不在此同萌中QAQ无法执行此操作 |
| code | num | 返回值 | 0成功<br />-3系统错误<br />-101账号未登录<br />-400请求错误<br />10005msgkey不存在<br />21007消息过长无法发送<br />21015为了维护社区的良好秩序只有绑定手机号的账号才能发送消息<br />21020你发送消息频率过快请稍后再发~<br />21026不能给自己发送消息哦~<br />21028由于系统升级暂无法发送敬请谅解<br />21035该类消息暂时无法发送<br />21037图片格式不合法不要调戏接口啦<br />21041消息已超期不能撤回了哦<br />21042消息已经撤回了哦<br />21046你发消息的频率太高了请在24小时后再发吧~<br />21047对方主动回复或关注你前最多发送1条消息~<br />25003因对方隐私设置暂无法给他发送聊天消息<br />25005你已拉黑了对方请先将对方移出黑名单后才能聊天<br />700013已解散QAQ无法执行此操作<br />700014你已不在此同萌中QAQ无法执行此操作 |
| message | str | 错误信息 | 成功时为0 |
| ttl | num | | 默认为1 |
| data | 有效时obj<br />无效时null | 信息本体 | |

View File

@@ -65,8 +65,8 @@
| birthday | str | 生日 | MM-DD<br />如设置隐私为空 |
| school | obj | 学校 | |
| profession | obj | 专业资质信息 | |
| tags | null | 个人标签 | |
| series | obj | | |
| tags | 有效时array<br />无效时:null | 个人标签 | |
| series | obj | | |
| is_senior_member | num | 是否为硬核会员 | 0否<br />1是 |
| mcn_info | null | | |
| gaia_res_type | num | | |
@@ -74,11 +74,13 @@
| is_risk | bool | | |
| elec | obj | 充电信息 | |
| contract | obj | 是否显示老粉计划 | |
| certificate_show | bool | | |
| name_render | 有效时obj<br />无效时null | 昵称渲染信息 | |
`rank`示例
| UID | rank |
|-----------|-------|
| --------- | ----- |
| 2 | 20000 |
| 16765 | 20000 |
| 15773384 | 20000 |
@@ -105,7 +107,7 @@
`profession`示例
| UID |
|------------|
| ---------- |
| 654391 |
| 1440295 |
| 1785155 |
@@ -137,6 +139,8 @@
| avatar_subscript_url | str | 大会员角标地址 | |
| tv_vip_status | num | 电视大会员状态 | 0未开通 |
| tv_vip_pay_type | num | 电视大会员支付类型 | |
| tv_due_date | num | 电视大会员过期时间 | 秒级时间戳 |
| avatar_icon | obj | 大会员角标信息 | |
`vip`中的`label`对象:
@@ -155,6 +159,12 @@
| img_label_uri_hans_static | str | 大会员牌子图片 | 简体版 |
| img_label_uri_hant_static | str | 大会员牌子图片 | 繁体版 |
`vip`中的`avatar_icon`对象:
| 字段 | 类型 | 内容 | 备注 |
| ------------ | ---- | ------ | ------------ |
| icon_type | num | | 作用尚不明确 |
| icon_resource | obj | | 作用尚不明确 |
`data`中的`pendant`对象:
@@ -162,25 +172,26 @@
**动态头像框的`image`为png静态图片`image_enhance`为webp动态图片`image_enhance_frame`为png逐帧序列**
| 字段 | 类型 | 内容 | 备注 |
|---------------------|-----|--------------|------------|
| pid | num | 头像框id | |
| name | str | 头像框名称 | |
| image | str | 头像框图片url | |
| expire | num | 过期时间 | 此接口返回恒为`0` |
| image_enhance | str | 头像框图片url | |
| image_enhance_frame | str | 头像框图片逐帧序列url | |
| 字段 | 类型 | 内容 | 备注 |
| ------------------- | ---- | --------------------- | ----------------- |
| pid | num | 头像框id | |
| name | str | 头像框名称 | |
| image | str | 头像框图片url | |
| expire | num | 过期时间 | 此接口返回恒为`0` |
| image_enhance | str | 头像框图片url | |
| image_enhance_frame | str | 头像框图片逐帧序列url | |
| n_pid | num | 新版头像框id | |
`data`中的`nameplate`对象:
| 字段 | 类型 | 内容 | 备注 |
|-------------|-----|---------|-----|
| nid | num | 勋章id | |
| name | str | 勋章名称 | |
| image | str | 勋章图标 | |
| image_small | str | 勋章图标(小) | |
| level | str | 勋章等级 | |
| condition | str | 获取条件 | |
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | -------------- | ---- |
| nid | num | 勋章id | |
| name | str | 勋章名称 | |
| image | str | 勋章图标 | |
| image_small | str | 勋章图标(小) | |
| level | str | 勋章等级 | |
| condition | str | 获取条件 | |
`data`中的`fans_medal`对象:
@@ -298,19 +309,19 @@
`data`中的`elec`对象:
| 字段 | 类型 | 内容 | 备注 |
|-----------|-----|-----|-----|
| show_info | obj | | |
| 字段 | 类型 | 内容 | 备注 |
| --------- | ---- | -------------- | ---- |
| show_info | obj | 显示的充电信息 | |
`elec`中的`show_info`对象:
| 字段 | 类型 | 内容 | 备注 |
|----------|------|---------|------------------|
| show | bool | 是否开通了充电 | |
| state | num | 状态 | -1未开通<br/>1已开通 |
| title | str | `空串` | |
| icon | str | `空串` | |
| jump_url | str | `空串` | |
| 字段 | 类型 | 内容 | 备注 |
| -------- | ---- | ---------------- | ---------------- |
| show | bool | 是否显示充电按钮 | |
| state | num | 充电功能开启状态 | -1未开通充电功能<br />1已开通自定义充电<br />2已开通包月、自定义充电<br />3已开通高档、自定义充电 |
| title | str | 充电按钮显示文字 | 空字符串或 `充电``充电中` |
| icon | str | 充电图标 | |
| jump_url | str | 跳转url | |
`data`中的`contract`对象:
@@ -325,10 +336,10 @@
```shell
curl -G 'https://api.bilibili.com/x/space/wbi/acc/info' \
--data-urlencode 'mid=2' \
--data-urlencode 'wts=1685070149' \
--data-urlencode 'w_rid=f7b376124782ae8cb42c56fdd69144ed' \
-b 'SESSDATA=xxx'
--data-urlencode 'mid=2' \
--data-urlencode 'wts=1685070149' \
--data-urlencode 'w_rid=f7b376124782ae8cb42c56fdd69144ed' \
-b 'SESSDATA=xxx'
```
<details>
@@ -359,21 +370,23 @@ curl -G 'https://api.bilibili.com/x/space/wbi/acc/info' \
"wear": true,
"medal": {
"uid": 2,
"target_id": 335115,
"medal_id": 45408,
"level": 21,
"medal_name": "伍千万",
"medal_color": 1725515,
"intimacy": 1980,
"next_intimacy": 2000,
"target_id": 548076,
"medal_id": 32525,
"level": 28,
"medal_name": "桜樱怪",
"medal_color": 398668,
"intimacy": 25364,
"next_intimacy": 160000,
"day_limit": 250000,
"medal_color_start": 1725515,
"medal_color_end": 5414290,
"medal_color_border": 1725515,
"today_feed": 2382,
"medal_color_start": 398668,
"medal_color_end": 6850801,
"medal_color_border": 6809855,
"is_lighted": 1,
"guard_level": 3,
"light_status": 1,
"wearing_status": 1,
"score": 50001980
"score": 50185364
}
},
"official": {
@@ -385,7 +398,7 @@ curl -G 'https://api.bilibili.com/x/space/wbi/acc/info' \
"vip": {
"type": 2,
"status": 1,
"due_date": 3931344000000,
"due_date": 3979555200000,
"vip_pay_type": 0,
"theme_type": 0,
"label": {
@@ -407,8 +420,12 @@ curl -G 'https://api.bilibili.com/x/space/wbi/acc/info' \
"role": 7,
"avatar_subscript_url": "",
"tv_vip_status": 1,
"tv_vip_pay_type": 0,
"tv_due_date": 2000822400
"tv_vip_pay_type": 1,
"tv_due_date": 2003500800,
"avatar_icon": {
"icon_type": 1,
"icon_resource": {}
}
},
"pendant": {
"pid": 32257,
@@ -416,7 +433,8 @@ curl -G 'https://api.bilibili.com/x/space/wbi/acc/info' \
"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"
"image_enhance_frame": "https://i2.hdslb.com/bfs/garb/item/4316a3910bb0bd6f2f1c267a3e9187f0b9fe5bd0.png",
"n_pid": 32257
},
"nameplate": {
"nid": 10,
@@ -429,10 +447,11 @@ curl -G 'https://api.bilibili.com/x/space/wbi/acc/info' \
"user_honour_info": {
"mid": 0,
"colour": null,
"tags": []
"tags": [],
"is_latest_100honour": 0
},
"is_followed": true,
"top_photo": "http://i2.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png",
"is_followed": false,
"top_photo": "http://i0.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png",
"theme": {},
"sys_notice": {},
"live_room": {
@@ -446,9 +465,9 @@ curl -G 'https://api.bilibili.com/x/space/wbi/acc/info' \
"broadcast_type": 0,
"watched_show": {
"switch": true,
"num": 19,
"text_small": "19",
"text_large": "19人看过",
"num": 3,
"text_small": "3",
"text_large": "3人看过",
"icon": "https://i0.hdslb.com/bfs/live/a725a9e61242ef44d764ac911691a7ce07f36c1d.png",
"icon_location": "",
"icon_web": "https://i0.hdslb.com/bfs/live/8d9d0f33ef8bf6f308742752d13dd0df731df19c.png"
@@ -486,7 +505,9 @@ curl -G 'https://api.bilibili.com/x/space/wbi/acc/info' \
"contract": {
"is_display": false,
"is_follow_display": false
}
},
"certificate_show": false,
"name_render": null
}
}
```
@@ -934,11 +955,13 @@ curl -G 'https://api.bilibili.com/x/space/myinfo' \
*请求方式GET*
认证方式CookieSESSDATA
**url参数**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------------- | ------ | ---------------------------------- |
| uids | nums | 目标用户的mid列表 | 必要 | 每个成员间用`,`分隔,最多200个成员 |
| uids | nums | 目标用户的mid列表 | 必要 | 每个成员间用`,`分隔,最多50个成员 |
**json回复**
@@ -946,7 +969,7 @@ curl -G 'https://api.bilibili.com/x/space/myinfo' \
| 字段 | 类型 | 内容 | 备注 |
| ------- | ----- | -------- | -------------------------------------------------------- |
| code | num | 返回值 | 0成功<br />-400请求错误<br />40143批量大小超过限制 |
| code | num | 返回值 | 0成功<br />-101账号未登录<br />-400请求错误<br />40143批量大小超过限制 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | obj | 信息本体 | 用户信息随机排序 |
@@ -962,16 +985,12 @@ curl -G 'https://api.bilibili.com/x/space/myinfo' \
| 字段 | 类型 | 内容 | 备注 |
| ------------ | ---- | ------------------- | -------------------- |
| face | str | 头像链接 | |
| face_nft | num | 是否为 NFT 头像 | 0不是 NFT 头像<br />1是 NFT 头像 |
| face_nft_new | num | 是否为新版 NFT 头像 | |
| mid | str | mid | |
| face | str | 头像链接 | |
| name | str | 昵称 | |
| name_render | 有效时obj<br />无效时null | 昵称渲染信息 | |
| nameplate | 有效时obj<br />无效时null | 勋章信息 | 基本同「[用户空间详细信息](#用户空间详细信息)」中的 `data.nameplate` 对象 |
| official | obj | 认证信息 | 基本同「[用户空间详细信息](#用户空间详细信息)」中的 `data.official` 对象 |
| pendant | 有效时obj<br />无效时null| 头像框信息 | 基本同「[用户空间详细信息](#用户空间详细信息)」中的 `data.pendant` 对象,其中有些类型为 `num` 的字段在本接口中类型为 `str` |
| vip | obj | 会员信息 | 基本同「[用户空间详细信息](#用户空间详细信息)」中的 `data.vip` 对象,其中有些类型为 `num` 的字段在本接口中类型为 `str` |
| name_render | 有效时obj<br />无效时null | 昵称渲染信息 | |
`{用户mid}`中的`name_render`对象:
@@ -1021,35 +1040,30 @@ curl -G 'https://api.bilibili.com/x/polymer/pc-electron/v1/user/cards' \
"ttl": 1,
"data": {
"1": {
"face": "http://i1.hdslb.com/bfs/face/34c5b30a990c7ce4a809626d8153fa7895ec7b63.gif",
"face_nft": 0,
"face_nft_new": 0,
"mid": "1",
"face": "http://i1.hdslb.com/bfs/face/34c5b30a990c7ce4a809626d8153fa7895ec7b63.gif",
"name": "bishi",
"name_render": {
"colors_info": { "color": [], "color_ids": [ "6" ] },
"render_scheme": "Default"
"official": {
"desc": "",
"role": 0,
"title": "",
"type": -1
},
"nameplate": null,
"official": { "desc": "", "role": 0, "title": "", "type": -1 },
"pendant": null,
"vip": {
"avatar_icon": {
"icon_resource": {
"type": "ICON_RES_TYPE_IMAGE",
"url": "https://i0.hdslb.com/bfs/bangumi/kt/aba51485c0d02940c89aeefcf6680510d9858472.png"
},
"icon_type": "ICON_TYPE_VIP_ACTIVITY"
},
"avatar_subscript": 1,
"avatar_subscript_url": "",
"due_date": "1883059200000",
"due_date": "1912521600000",
"nickname_color": "#FB7299",
"role": "7",
"status": 1,
"theme_type": 0,
"type": 2,
"label": {
"bg_color": "#FB7299",
"bg_style": 1,
"border_color": "",
"img_label_uri_hans": "",
"img_label_uri_hans_static": "https://i0.hdslb.com/bfs/bangumi/kt/fb0a74b14d6a4e119ae301ba2693febeda051030.png",
"img_label_uri_hans_static": "https://i0.hdslb.com/bfs/vip/adb599797dd171e2d3d6d012f448b49679258344.png",
"img_label_uri_hant": "",
"img_label_uri_hant_static": "https://i0.hdslb.com/bfs/activity-plat/static/20220614/e369244d0b14644f5e1a06431e22a4d5/sGu57N6pgK.png",
"label_theme": "ten_annual_vip",
@@ -1057,63 +1071,35 @@ curl -G 'https://api.bilibili.com/x/polymer/pc-electron/v1/user/cards' \
"text": "十年大会员",
"text_color": "#FFFFFF",
"use_img_label": true
},
}
},
"name_render": null
},
"2": {
"mid": "2",
"face": "https://i2.hdslb.com/bfs/face/ef0457addb24141e15dfac6fbf45293ccf1e32ab.jpg",
"name": "碧诗",
"official": {
"desc": "",
"role": 2,
"title": "bilibili创始人站长",
"type": 0
},
"vip": {
"avatar_subscript": 1,
"avatar_subscript_url": "",
"due_date": "3995625600000",
"nickname_color": "#FB7299",
"role": "7",
"status": 1,
"theme_type": 0,
"tv_due_date": "1633622400",
"tv_vip_pay_type": 0,
"tv_vip_status": 0,
"type": 2,
"vip_pay_type": 1
}
},
"2": {
"face": "https://i2.hdslb.com/bfs/face/ef0457addb24141e15dfac6fbf45293ccf1e32ab.jpg",
"face_nft": 0,
"face_nft_new": 0,
"mid": "2",
"name": "碧诗",
"name_render": {
"colors_info": { "color": [], "color_ids": [ "6" ] },
"render_scheme": "Default"
},
"nameplate": {
"condition": "所有自制视频总播放数>=10万",
"image": "https://i1.hdslb.com/bfs/face/e93dd9edfa7b9e18bf46fd8d71862327a2350923.png",
"image_small": "https://i2.hdslb.com/bfs/face/275b468b043ec246737ab8580a2075bee0b1263b.png",
"level": "普通勋章",
"name": "见习偶像",
"nid": 10
},
"official": { "desc": "", "role": 2, "title": "bilibili创始人站长", "type": 0 },
"pendant": {
"expire": "0",
"image": "https://i2.hdslb.com/bfs/garb/item/488870931b1bba66da36d22848f0720480d3d79a.png",
"image_enhance": "https://i2.hdslb.com/bfs/garb/item/5974f17f9d96a88bafba2f6d18d647a486e88312.webp",
"image_enhance_frame": "https://i2.hdslb.com/bfs/garb/item/4316a3910bb0bd6f2f1c267a3e9187f0b9fe5bd0.png",
"n_pid": "32257",
"name": "EveOneCat2",
"pid": 32257
},
"vip": {
"avatar_icon": {
"icon_resource": {
"type": "ICON_RES_TYPE_IMAGE",
"url": "https://i0.hdslb.com/bfs/bangumi/kt/aba51485c0d02940c89aeefcf6680510d9858472.png"
},
"icon_type": "ICON_TYPE_VIP_ACTIVITY"
},
"avatar_subscript": 1,
"avatar_subscript_url": "",
"due_date": "3968841600000",
"label": {
"bg_color": "#FB7299",
"bg_style": 1,
"border_color": "",
"img_label_uri_hans": "",
"img_label_uri_hans_static": "https://i0.hdslb.com/bfs/bangumi/kt/53845a8ab8b226131c5d89b198d4b61de91d0aa2.png",
"img_label_uri_hans": "https://i0.hdslb.com/bfs/activity-plat/static/20220608/e369244d0b14644f5e1a06431e22a4d5/wltavwHAkL.gif",
"img_label_uri_hans_static": "https://i0.hdslb.com/bfs/vip/802418ff03911645648b63aa193ba67997b5a0bc.png",
"img_label_uri_hant": "",
"img_label_uri_hant_static": "https://i0.hdslb.com/bfs/activity-plat/static/20220614/e369244d0b14644f5e1a06431e22a4d5/8u7iRTPE7N.png",
"label_theme": "ten_annual_vip",
@@ -1121,43 +1107,29 @@ curl -G 'https://api.bilibili.com/x/polymer/pc-electron/v1/user/cards' \
"text": "十年大会员",
"text_color": "#FFFFFF",
"use_img_label": true
},
"nickname_color": "#FB7299",
"role": "7",
"status": 1,
"theme_type": 0,
"tv_due_date": "2003500800",
"tv_vip_pay_type": 1,
"tv_vip_status": 1,
"type": 2,
"vip_pay_type": 0
}
}
},
"name_render": null
},
"3": {
"face": "http://i0.hdslb.com/bfs/face/d4de6a84557eea8f18510a3f61115d96832aa071.jpg",
"face_nft": 0,
"face_nft_new": 0,
"mid": "3",
"face": "http://i0.hdslb.com/bfs/face/d4de6a84557eea8f18510a3f61115d96832aa071.jpg",
"name": "囧囧倉",
"name_render": {
"colors_info": {
"color": [
{ "color_day": "#CB7919", "color_night": "#E2963C" },
{ "color_day": "#E6A75B", "color_night": "#E6A75B" },
{ "color_day": "#E9BD67", "color_night": "#F8CE7E" }
],
"color_ids": [ "6" ]
},
"render_scheme": "Colorful"
"official": {
"desc": "",
"role": 0,
"title": "",
"type": -1
},
"nameplate": null,
"official": { "desc": "", "role": 0, "title": "", "type": -1 },
"pendant": null,
"vip": {
"avatar_icon": null,
"avatar_subscript": 0,
"avatar_subscript_url": "",
"due_date": "0",
"nickname_color": "",
"role": "0",
"status": 0,
"theme_type": 0,
"type": 0,
"label": {
"bg_color": "",
"bg_style": 0,
@@ -1171,17 +1143,9 @@ curl -G 'https://api.bilibili.com/x/polymer/pc-electron/v1/user/cards' \
"text": "",
"text_color": "",
"use_img_label": true
},
"nickname_color": "",
"role": "0",
"status": 0,
"theme_type": 0,
"tv_due_date": "0",
"tv_vip_pay_type": 0,
"tv_vip_status": 0,
"type": 0,
"vip_pay_type": 0
}
}
},
"name_render": null
}
}
}
@@ -1195,6 +1159,8 @@ curl -G 'https://api.bilibili.com/x/polymer/pc-electron/v1/user/cards' \
*请求方式GET*
认证方式CookieSESSDATA
本接口较其他接口相比,只会返回非常有限的信息
**url参数**
@@ -1209,7 +1175,7 @@ curl -G 'https://api.bilibili.com/x/polymer/pc-electron/v1/user/cards' \
| 字段 | 类型 | 内容 | 备注 |
| ------- | ----- | -------- | --------------------------- |
| code | num | 返回值 | 0成功<br />-400请求错误 |
| code | num | 返回值 | 0成功<br />-101账号未登录<br />-400请求错误 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | array | 信息本体 | 用户信息随机排序 |
@@ -1248,34 +1214,38 @@ curl -G 'https://api.vc.bilibili.com/account/v1/user/cards' \
```json
{
"code": 0,
"message": "",
"ttl": 1,
"data": [{
"mid": 1,
"name": "bishi",
"face": "http://i1.hdslb.com/bfs/face/34c5b30a990c7ce4a809626d8153fa7895ec7b63.gif",
"sign": "",
"rank": 10000,
"level": 6,
"silence": 0
}, {
"mid": 2,
"name": "碧诗",
"face": "http://i2.hdslb.com/bfs/face/ef0457addb24141e15dfac6fbf45293ccf1e32ab.jpg",
"sign": "https://kami.im 直男过气网红 # We Are Star Dust",
"rank": 20000,
"level": 6,
"silence": 0
}, {
"mid": 3,
"name": "囧囧倉",
"face": "http://i0.hdslb.com/bfs/face/d4de6a84557eea8f18510a3f61115d96832aa071.jpg",
"sign": "富强、民主、文明、和谐、自由、平等、公正、法治、爱国、敬业、诚信、友善。",
"rank": 10000,
"level": 6,
"silence": 0
}]
"code": 0,
"message": "0",
"ttl": 1,
"data": [
{
"mid": 3,
"name": "囧囧倉",
"face": "http://i0.hdslb.com/bfs/face/d4de6a84557eea8f18510a3f61115d96832aa071.jpg",
"sign": "富强、民主、文明、和谐、自由、平等、公正、法治、爱国、敬业、诚信、友善。",
"rank": 10000,
"level": 6,
"silence": 0
},
{
"mid": 2,
"name": "碧诗",
"face": "https://i2.hdslb.com/bfs/face/ef0457addb24141e15dfac6fbf45293ccf1e32ab.jpg",
"sign": "https://kami.im 直男过气网红 # We Are Star Dust",
"rank": 20000,
"level": 6,
"silence": 0
},
{
"mid": 1,
"name": "bishi",
"face": "http://i1.hdslb.com/bfs/face/34c5b30a990c7ce4a809626d8153fa7895ec7b63.gif",
"sign": "",
"rank": 10000,
"level": 6,
"silence": 0
}
]
}
```

View File

@@ -1303,7 +1303,7 @@ curl -G 'https://api.bilibili.com/x/relation/blacks' \
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0成功<br />-101账号未登录<br />-102账号被封停<br />-111csrf校验失败<br />-400请求错误<br />22001不能对自己进行此操作<br />22002因对方隐私设置你还不能关注<br />22003关注失败请将该用户移除黑名单之后再试<br />22013账号已注销无法完成操作<br />22014已经关注用户无法重复关注<br />22120重复加入黑名单<br />40061用户不存在 |
| code | num | 返回值 | 0成功<br />-101账号未登录<br />-102账号被封停<br />-111csrf校验失败<br />-400请求错误<br />22001不能对自己进行此操作<br />22002因对方隐私设置你还不能关注<br />22003关注失败请将该用户移除黑名单之后再试<br />22008黑名单达到上限<br />22009关注失败已达关注上限<br />22013账号已注销无法完成操作<br />22014已经关注用户无法重复关注<br />22120重复加入黑名单<br />40061用户不存在 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
@@ -2043,7 +2043,7 @@ curl 'https://api.bilibili.com/x/relation/tag/special' \
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0成功<br />-111csrf校验失败<br />-101账号未登录<br />-400请求错误<br />22106该分组已经存在<br />22103分组名过长 |
| code | num | 返回值 | 0成功<br />-111csrf校验失败<br />-101账号未登录<br />-400请求错误<br />22101分组名称存在不允许的字符<br />22102分组数量超过限制<br />22103分组名过长<br />22106该分组已经存在 |
| message | str | 错误信息 | 默认为 0 |
| ttl | num | 1 | |
| data | obj | 信息本体 | |
@@ -2104,7 +2104,7 @@ curl 'https://api.bilibili.com/x/relation/tag/create' \
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0成功<br />-111csrf校验失败<br />-101账号未登录<br />-400请求错误<br />22103分组名过长<br />22104该分组不存在 |
| code | num | 返回值 | 0成功<br />-111csrf校验失败<br />-101账号未登录<br />-400请求错误<br />22101分组名称存在不允许的字符<br />22103分组名过长<br />22104该分组不存在 |
| message | str | 错误信息 | 默认为 0 |
| ttl | num | 1 | |
@@ -2212,7 +2212,7 @@ curl 'https://api.bilibili.com/x/relation/tag/del' \
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0成功<br />-111csrf校验失败<br />-101账号未登录<br />-400请求错误<br />22104无权限<br />22105未关注 |
| code | num | 返回值 | 0成功<br />-111csrf校验失败<br />-101账号未登录<br />-400请求错误<br />22104分组不存在<br />22105未关注 |
| message | str | 错误信息 | 默认为 0 |
| ttl | num | 1 | |
@@ -2264,7 +2264,7 @@ curl 'https://api.bilibili.com/x/relation/tags/addUsers' \
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0成功<br />-111csrf校验失败<br />-101账号未登录<br />-400请求错误<br />22104无权限<br />22105未关注 |
| code | num | 返回值 | 0成功<br />-111csrf校验失败<br />-101账号未登录<br />-400请求错误<br />22104分组不存在<br />22105未关注 |
| message | str | 错误信息 | 默认为 0 |
| ttl | num | 1 | |
@@ -2317,7 +2317,7 @@ curl 'https://api.bilibili.com/x/relation/tags/copyUsers' \
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0成功<br />-111csrf校验失败<br />-101账号未登录<br />-400请求错误<br />22104无权限<br />22105未关注 |
| code | num | 返回值 | 0成功<br />-111csrf校验失败<br />-101账号未登录<br />-400请求错误<br />22104分组不存在<br />22105未关注 |
| message | str | 错误信息 | 默认为 0 |
| ttl | num | 1 | |

File diff suppressed because it is too large Load Diff

File diff suppressed because it is too large Load Diff

View File

@@ -1,9 +1,11 @@
# 视频分区一览
用于通过稿件 avid 判断所在的分区,或推荐分区视频等.......
用于判断视频所在的分区,或推荐分区视频等……
亦可用于更深♂入了解B站的分区
本文档中的内容适用于 `tid``tname` 等字段,关于 `tid_v2``tname_v2` 等字段请参阅 “[视频分区一览 (v2)](./video_zone_v2.md)” 文档
## 动画
<img src="../../assets/zone_icon/douga.svg" width="100" height="100"/>

458
docs/video/video_zone_v2.md Normal file
View File

@@ -0,0 +1,458 @@
# 视频分区一览 (v2)
本文档中的内容适用于 `tid_v2`(部分接口写为 `tidv2`)、`tname_v2`(部分接口写为 `tnamev2`)等字段,关于 `tid``tname` 等字段请参阅 “[视频分区一览](./video_zone.md)” 文档
目前 B 站尚未启用子分区
## 动画
<img src="../../assets/zone_v2_icon/douga.svg" width="100" height="100" />
| 名称 | 代号 | tid | channelId | url 路由 |
| ------------- | ----------- | ---- | --------- | ---------------------------------------------- |
| 动画 (主分区) | douga | 1005 | 7 | [/c/douga/](https://www.bilibili.com/c/douga/) |
| 同人动画 | fan_anime | 2037 | | |
| 模玩周边 | garage_kit | 2038 | | |
| cosplay | cosplay | 2039 | | |
| 二次元线下 | offline | 2040 | | |
| 动漫剪辑 | editing | 2041 | | |
| 动漫评论 | commentary | 2042 | | |
| 动漫速读 | quick_view | 2043 | | |
| 动漫配音 | voice | 2044 | | |
| 动漫资讯 | information | 2045 | | |
| 网文解读 | interpret | 2046 | | |
| 虚拟up主 | vup | 2047 | | |
| 特摄 | tokusatsu | 2048 | | |
| 布袋戏 | puppetry | 2049 | | |
| 漫画·动态漫 | comic | 2050 | | |
| 广播剧 | motion | 2051 | | |
| 动漫reaction | reaction | 2052 | | |
| 动漫教学 | tutorial | 2053 | | |
| 二次元其他 | other | 2054 | | |
## 游戏
<img src="../../assets/zone_v2_icon/game.svg" width="100" height="100" />
| 名称 | 代号 | tid | channelId | url 路由 |
| -------------- | ----------- | ---- | --------- | -------------------------------------------- |
| 游戏 (主分区) | game | 1008 | 8 | [/c/game/](https://www.bilibili.com/c/game/) |
| 单人RPG游戏 | rpg | 2064 | | |
| MMORPG游戏 | mmorpg | 2065 | | |
| 单机主机类游戏 | stand_alone | 2066 | | |
| SLG游戏 | slg | 2067 | | |
| 回合制策略游戏 | tbs | 2068 | | |
| 即时策略游戏 | rts | 2069 | | |
| MOBA游戏 | moba | 2070 | | |
| 射击游戏 | stg | 2071 | | |
| 体育竞速游戏 | spg | 2072 | | |
| 动作竞技游戏 | act | 2073 | | |
| 音游舞游 | msc | 2074 | | |
| 模拟经营游戏 | sim | 2075 | | |
| 女性向游戏 | otome | 2076 | | |
| 休闲/小游戏 | puz | 2077 | | |
| 沙盒类 | sandbox | 2078 | | |
| 其他游戏 | other | 2079 | | |
## 鬼畜
<img src="../../assets/zone_v2_icon/kichiku.svg" width="100" height="100" />
| 名称 | 代号 | tid | channelId | url 路由 |
| ------------- | --------------- | ---- | --------- | -------------------------------------------------- |
| 鬼畜 (主分区) | kichiku | 1007 | 9 | [/c/kichiku/](https://www.bilibili.com/c/kichiku/) |
| 鬼畜调教 | guide | 2059 | | |
| 鬼畜剧场 | theatre | 2060 | | |
| 人力VOCALOID | manual_vocaloid | 2061 | | |
| 音MAD | mad | 2062 | | |
| 鬼畜综合 | other | 2063 | | |
## 音乐
<img src="../../assets/zone_v2_icon/music.svg" width="100" height="100" />
| 名称 | 代号 | tid | channelId | url 路由 |
| ------------- | ---------- | ---- | --------- | ---------------------------------------------- |
| 音乐 (主分区) | music | 1003 | 10 | [/c/music/](https://www.bilibili.com/c/music/) |
| 原创音乐 | original | 2016 | | |
| MV | mv | 2017 | | |
| 音乐现场 | live | 2018 | | |
| 乐迷饭拍 | fan_videos | 2019 | | |
| 翻唱 | cover | 2020 | | |
| 演奏 | perform | 2021 | | |
| VOCALOID | vocaloid | 2022 | | |
| AI音乐 | ai_music | 2023 | | |
| 电台·歌单 | radio | 2024 | | |
| 音乐教学 | tutorial | 2025 | | |
| 乐评盘点 | commentary | 2026 | | |
| 音乐综合 | other | 2027 | | |
## 舞蹈
<img src="../../assets/zone_v2_icon/dance.svg" width="100" height="100" />
| 名称 | 代号 | tid | channelId | url 路由 |
| ------------- | -------- | ---- | --------- | ---------------------------------------------- |
| 舞蹈 (主分区) | dance | 1004 | 11 | [/c/dance/](https://www.bilibili.com/c/dance/) |
| 宅舞 | otaku | 2028 | | |
| 街舞 | hiphop | 2029 | | |
| 颜值·网红舞 | gestures | 2030 | | |
| 明星舞蹈 | star | 2031 | | |
| 国风舞蹈 | china | 2032 | | |
| 舞蹈教学 | tutorial | 2033 | | |
| 芭蕾舞 | ballet | 2034 | | |
| wota艺 | wota | 2035 | | |
| 舞蹈综合 | other | 2036 | | |
## 影视
<img src="../../assets/zone_v2_icon/cinephile.svg" width="100" height="100" />
| 名称 | 代号 | tid | channelId | url 路由 |
| ------------- | ----------- | ---- | --------- | ------------------------------------------------------ |
| 影视 (主分区) | cinephile | 1001 | 12 | [/c/cinephile/](https://www.bilibili.com/c/cinephile/) |
| 影视解读 | commentary | 2001 | | |
| 影视剪辑 | montage | 2002 | | |
| 影视资讯 | information | 2003 | | |
| 影视正片搬运 | porterage | 2004 | | |
| 短剧短片 | shortfilm | 2005 | | |
| AI影视 | ai | 2006 | | |
| 影视reaction | reaction | 2007 | | |
| 影视综合 | other | 2008 | | |
## 娱乐
<img src="../../assets/zone_v2_icon/entertainment.svg" width="100" height="100" />
| 名称 | 代号 | tid | channelId | url 路由 |
| ------------- | ----------- | ---- | --------- | ------------------------------------------ |
| 娱乐 (主分区) | ent | 1002 | 13 | [/c/ent/](https://www.bilibili.com/c/ent/) |
| 娱乐评论 | commentary | 2009 | | |
| 明星剪辑 | montage | 2010 | | |
| 娱乐饭拍&现场 | fans_video | 2011 | | |
| 娱乐资讯 | information | 2012 | | |
| 娱乐reaction | reaction | 2013 | | |
| 娱乐综艺正片 | variety | 2014 | | |
| 娱乐综合 | other | 2015 | | |
## 知识
<img src="../../assets/zone_v2_icon/knowledge.svg" width="100" height="100" />
| 名称 | 代号 | tid | channelId | url 路由 |
| -------------- | ------------------ | ---- | --------- | ------------------------------------------------------ |
| 知识 (主分区) | knowledge | 1010 | 14 | [/c/knowledge/](https://www.bilibili.com/c/knowledge/) |
| 应试教育 | exam | 2084 | | |
| 非应试语言学习 | lang_skill | 2085 | | |
| 大学专业知识 | campus | 2086 | | |
| 商业财经 | business | 2087 | | |
| 社会观察 | social_observation | 2088 | | |
| 时政解读 | politics | 2089 | | |
| 人文历史 | humanity_history | 2090 | | |
| 设计艺术 | design | 2091 | | |
| 心理杂谈 | psychology | 2092 | | |
| 职场发展 | career | 2093 | | |
| 科学科普 | science | 2094 | | |
| 其他知识杂谈 | other | 2095 | | |
## 科技数码
<img src="../../assets/zone_v2_icon/tech.svg" width="100" height="100" />
| 名称 | 代号 | tid | channelId | url 路由 |
| ----------------- | ----------- | ---- | --------- | -------------------------------------------- |
| 科技数码 (主分区) | tech | 1012 | 15 | [/c/tech/](https://www.bilibili.com/c/tech/) |
| 电脑 | computer | 2099 | | |
| 手机 | phone | 2100 | | |
| 平板电脑 | pad | 2101 | | |
| 摄影摄像 | photography | 2102 | | |
| 工程机械 | machine | 2103 | | |
| 自制发明/设备 | create | 2104 | | |
| 科技数码综合 | other | 2105 | | |
## 资讯
<img src="../../assets/zone_v2_icon/information.svg" width="100" height="100" />
| 名称 | 代号 | tid | channelId | url 路由 |
| ------------- | ----------- | ---- | --------- | ---------------------------------------------------------- |
| 资讯 (主分区) | information | 1009 | 16 | [/c/information/](https://www.bilibili.com/c/information/) |
| 时政资讯 | politics | 2080 | | |
| 海外资讯 | overseas | 2081 | | |
| 社会资讯 | social | 2082 | | |
| 综合资讯 | other | 2083 | | |
## 美食
<img src="../../assets/zone_v2_icon/food.svg" width="100" height="100" />
| 名称 | 代号 | tid | channelId | url 路由 |
| ------------- | ---------- | ---- | --------- | -------------------------------------------- |
| 美食 (主分区) | food | 1020 | 17 | [/c/food/](https://www.bilibili.com/c/food/) |
| 美食制作 | make | 2149 | | |
| 美食探店 | detective | 2150 | | |
| 美食测评 | commentary | 2151 | | |
| 美食记录 | record | 2152 | | |
| 美食综合 | other | 2153 | | |
## 小剧场
<img src="../../assets/zone_v2_icon/shortplay.svg" width="100" height="100" />
| 名称 | 代号 | tid | channelId | url 路由 |
| --------------- | ---------- | ---- | --------- | ------------------------------------------------------ |
| 小剧场 (主分区) | shortplay | 1021 | 18 | [/c/shortplay/](https://www.bilibili.com/c/shortplay/) |
| 剧情演绎 | plot | 2154 | | |
| 语言类小剧场 | lang | 2155 | | |
| UP主小综艺 | up_variety | 2156 | | |
| 街头采访 | interview | 2157 | | |
## 汽车
<img src="../../assets/zone_v2_icon/car.svg" width="100" height="100" />
| 名称 | 代号 | tid | channelId | url 路由 |
| ------------- | ---------- | ---- | --------- | ---------------------------------------- |
| 汽车 (主分区) | car | 1013 | 19 | [/c/car](https://www.bilibili.com/c/car) |
| 汽车测评 | commentary | 2106 | | |
| 汽车文化 | culture | 2107 | | |
| 汽车生活 | life | 2108 | | |
| 汽车技术 | tech | 2109 | | |
| 汽车综合 | other | 2110 | | |
## 时尚美妆
<img src="../../assets/zone_v2_icon/fashion.svg" width="100" height="100" />
| 名称 | 代号 | tid | channelId | url 路由 |
| ----------------- | ----------- | ---- | --------- | -------------------------------------------------- |
| 时尚美妆 (主分区) | fashion | 1014 | 20 | [/c/fashion/](https://www.bilibili.com/c/fashion/) |
| 美妆 | makeup | 2111 | | |
| 护肤 | skincare | 2112 | | |
| 仿装cos | cos | 2113 | | |
| 鞋服穿搭 | outfits | 2114 | | |
| 箱包配饰 | accessories | 2115 | | |
| 珠宝首饰 | jewelry | 2116 | | |
| 三坑 | trick | 2117 | | |
| 时尚解读 | commentary | 2118 | | |
| 时尚综合 | other | 2119 | | |
## 体育运动
<img src="../../assets/zone_v2_icon/sports.svg" width="100" height="100" />
| 名称 | 代号 | tid | channelId | url 路由 |
| ----------------- | ----------- | ---- | --------- | ------------------------------------------------ |
| 体育运动 (主分区) | sports | 1018 | 21 | [/c/sports/](https://www.bilibili.com/c/sports/) |
| 潮流运动 | trend | 2133 | | |
| 足球 | football | 2134 | | |
| 篮球 | basketball | 2135 | | |
| 跑步 | running | 2136 | | |
| 武术 | kungfu | 2137 | | |
| 格斗 | fighting | 2138 | | |
| 羽毛球 | badminton | 2139 | | |
| 体育资讯 | information | 2140 | | |
| 体育赛事 | match | 2141 | | |
| 体育综合 | other | 2142 | | |
## 动物
<img src="../../assets/zone_v2_icon/animal.svg" width="100" height="100" />
| 名称 | 代号 | tid | channelId | url 路由 |
| --------------------- | -------- | ---- | --------- | ------------------------------------------------ |
| 动物 (主分区) | animal | 1024 | 22 | [/c/animal/](https://www.bilibili.com/c/animal/) |
| 猫 | cat | 2167 | | |
| 狗 | dog | 2168 | | |
| 小宠异宠 | reptiles | 2169 | | |
| 野生动物·动物解说科普 | science | 2170 | | |
| 动物综合·二创 | other | 2171 | | |
## vlog
<img src="../../assets/zone_v2_icon/vlog.svg" width="100" height="100" />
| 名称 | 代号 | tid | channelId | url 路由 |
| ------------- | ------- | ---- | --------- | -------------------------------------------- |
| vlog (主分区) | vlog | 1029 | 23 | [/c/vlog/](https://www.bilibili.com/c/vlog/) |
| 中外生活vlog | life | 2194 | | |
| 学生vlog | student | 2195 | | |
| 职业vlog | career | 2196 | | |
| 其他vlog | other | 2197 | | |
## 绘画
<img src="../../assets/zone_v2_icon/painting.svg" width="100" height="100" />
| 名称 | 代号 | tid | channelId | url 路由 |
| ------------- | -------- | ---- | --------- | ---------------------------------------------------- |
| 绘画 (主分区) | painting | 1006 | 24 | [/c/painting/](https://www.bilibili.com/c/painting/) |
| 二次元绘画 | acg | 2055 | | |
| 非二次元绘画 | none_acg | 2056 | | |
| 绘画学习 | tutorial | 2057 | | |
| 绘画综合 | other | 2058 | | |
## 人工智能
<img src="../../assets/zone_v2_icon/ai.svg" width="100" height="100" />
| 名称 | 代号 | tid | channelId | url 路由 |
| ----------------- | ----------- | ---- | --------- | ---------------------------------------- |
| 人工智能 (主分区) | ai | 1011 | 25 | [/c/ai/](https://www.bilibili.com/c/ai/) |
| AI学习 | tutorial | 2096 | | |
| AI资讯 | information | 2097 | | |
| AI杂谈 | other | 2098 | | |
## 家装房产
<img src="../../assets/zone_v2_icon/home.svg" width="100" height="100" />
| 名称 | 代号 | tid | channelId | url 路由 |
| ----------------- | ---------- | ---- | --------- | -------------------------------------------- |
| 家装房产 (主分区) | home | 1015 | 26 | [/c/home/](https://www.bilibili.com/c/home/) |
| 买房租房 | trade | 2120 | | |
| 家庭装修 | renovation | 2121 | | |
| 家居展示 | furniture | 2122 | | |
| 家用电器 | appliances | 2123 | | |
## 户外潮流
<img src="../../assets/zone_v2_icon/outdoors.svg" width="100" height="100" />
| 名称 | 代号 | tid | channelId | url 路由 |
| ----------------- | -------- | ---- | --------- | ---------------------------------------------------- |
| 户外潮流 (主分区) | outdoors | 1016 | 27 | [/c/outdoors/](https://www.bilibili.com/c/outdoors/) |
| 露营 | camping | 2124 | | |
| 徒步 | hiking | 2125 | | |
| 户外探秘 | explore | 2126 | | |
| 户外综合 | other | 2127 | | |
## 健身
<img src="../../assets/zone_v2_icon/gym.svg" width="100" height="100" />
| 名称 | 代号 | tid | channelId | url 路由 |
| ------------- | -------- | ---- | --------- | ------------------------------------------ |
| 健身 (主分区) | gym | 1017 | 28 | [/c/gym/](https://www.bilibili.com/c/gym/) |
| 健身科普 | science | 2128 | | |
| 健身跟练教学 | tutorial | 2129 | | |
| 健身记录 | record | 2130 | | |
| 健身身材展示 | figure | 2131 | | |
| 健身综合 | other | 2132 | | |
## 手工
<img src="../../assets/zone_v2_icon/handmake.svg" width="100" height="100" />
| 名称 | 代号 | tid | channelId | url 路由 |
| ------------- | ----------- | ---- | --------- | ---------------------------------------------------- |
| 手工 (主分区) | handmake | 1019 | 29 | [/c/handmake/](https://www.bilibili.com/c/handmake/) |
| 文具手帐 | handbook | 2143 | | |
| 轻手作 | light | 2144 | | |
| 传统手工艺 | traditional | 2145 | | |
| 解压手工 | relief | 2146 | | |
| DIY玩具 | diy | 2147 | | |
| 其他手工 | other | 2148 | | |
## 旅游出行
<img src="../../assets/zone_v2_icon/travel.svg" width="100" height="100" />
| 名称 | 代号 | tid | channelId | url 路由 |
| ----------------- | --------- | ---- | --------- | ------------------------------------------------ |
| 旅游出行 (主分区) | travel | 1022 | 30 | [/c/travel/](https://www.bilibili.com/c/travel/) |
| 旅游记录 | record | 2158 | | |
| 旅游攻略 | strategy | 2159 | | |
| 城市出行 | city | 2160 | | |
| 公共交通 | transport | 2161 | | |
## 三农
<img src="../../assets/zone_v2_icon/rural.svg" width="100" height="100" />
| 名称 | 代号 | tid | channelId | url 路由 |
| ------------- | -------- | ---- | --------- | ---------------------------------------------- |
| 三农 (主分区) | rural | 1023 | 31 | [/c/rural/](https://www.bilibili.com/c/rural/) |
| 农村种植 | planting | 2162 | | |
| 赶海捕鱼 | fishing | 2163 | | |
| 打野采摘 | harvest | 2164 | | |
| 农业技术 | tech | 2165 | | |
| 农村生活 | life | 2166 | | |
## 亲子
<img src="../../assets/zone_v2_icon/parenting.svg" width="100" height="100" />
| 名称 | 代号 | tid | channelId | url 路由 |
| ------------- | ------------- | ---- | --------- | ------------------------------------------------------ |
| 亲子 (主分区) | parenting | 1025 | 32 | [/c/parenting/](https://www.bilibili.com/c/parenting/) |
| 孕产护理 | pregnant_care | 2172 | | |
| 婴幼护理 | infant_care | 2173 | | |
| 儿童才艺 | talent | 2174 | | |
| 萌娃 | cute | 2175 | | |
| 亲子互动 | interaction | 2176 | | |
| 亲子教育 | education | 2177 | | |
| 亲子综合 | other | 2178 | | |
## 健康
<img src="../../assets/zone_v2_icon/health.svg" width="100" height="100" />
| 名称 | 代号 | tid | channelId | url 路由 |
| ------------- | ---------- | ---- | --------- | ------------------------------------------------ |
| 健康 (主分区) | health | 1026 | 33 | [/c/health/](https://www.bilibili.com/c/health/) |
| 健康科普 | science | 2179 | | |
| 养生 | regimen | 2180 | | |
| 两性知识 | sexes | 2181 | | |
| 心理健康 | psychology | 2182 | | |
| 助眠视频·ASMR | asmr | 2183 | | |
| 医疗保健综合 | other | 2184 | | |
## 情感
<img src="../../assets/zone_v2_icon/emotion.svg" width="100" height="100" />
| 名称 | 代号 | tid | channelId | url 路由 |
| ------------- | ------------- | ---- | --------- | -------------------------------------------------- |
| 情感 (主分区) | emotion | 1027 | 34 | [/c/emotion/](https://www.bilibili.com/c/emotion/) |
| 家庭关系 | family | 2185 | | |
| 恋爱关系 | romantic | 2186 | | |
| 人际关系 | interpersonal | 2187 | | |
| 自我成长 | growth | 2188 | | |
## 生活兴趣
<img src="../../assets/zone_v2_icon/life_joy.svg" width="100" height="100" />
| 名称 | 代号 | tid | channelId | url 路由 |
| ----------------- | ----------------- | ---- | --------- | ---------------------------------------------------- |
| 生活兴趣 (主分区) | life_joy | 1030 | 35 | [/c/life_joy/](https://www.bilibili.com/c/life_joy/) |
| 休闲玩乐 | leisure | 2198 | | |
| 线下演出 | on_site | 2199 | | |
| 文玩文创 | artistic_products | 2200 | | |
| 潮玩玩具 | trendy_toys | 2201 | | |
| 兴趣综合 | other | 2202 | | |
## 生活经验
<img src="../../assets/zone_v2_icon/life_experience.svg" width="100" height="100" />
| 名称 | 代号 | tid | channelId | url 路由 |
| ----------------- | --------------- | ---- | --------- | ------------------------------------------------------------------ |
| 生活经验 (主分区) | life_experience | 1031 | 36 | [/c/life_experience/](https://www.bilibili.com/c/life_experience/) |
| 生活技能 | skills | 2203 | | |
| 办事流程 | procedures | 2204 | | |
| 婚嫁 | marriage | 2205 | | |
## 神秘学 (未公开)
该分区未出现在 B 站前端的界面中,也无图标
| 名称 | 代号 | tid | channelId | url 路由 |
| --------------- | ----------- | ---- | --------- | ------------------------------------------------------ |
| 神秘学 (主分区) | mysticism | 1028 | 44 | [/c/mysticism/](https://www.bilibili.com/c/mysticism/) |
| 塔罗占卜 | tarot | 2189 | | |
| 星座占星 | horoscope | 2190 | | |
| 传统玄学 | metaphysics | 2191 | | |
| 疗愈成长 | healing | 2192 | | |
| 其他神秘学 | other | 2193 | | |

View File

@@ -2,7 +2,7 @@
## 兑换卡券
> https://api.bilibili.com/x/vip/privilege/receive
> <https://api.bilibili.com/x/vip/privilege/receive>
*请求方式POST*
@@ -10,28 +10,28 @@
**正文参数 (application/x-www-form-urlencoded)**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|------|-----|-----------------------|-------------|--------------------------------------------------------------------------------------|
| type | num | 兑换类型 | 必要 | 1B币券<br />2会员购优惠券<br />3漫画福利券<br />4会员购包邮券<br/>5漫画商城优惠券<br/>6装扮体验卡<br/>7课堂优惠券 |
| csrf | str | CSRF Token (位于cookie) | Cookie 方式必要 | |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------------------- | ------ | ------------------------------------------------------------------------------------ |
| type | num | 兑换类型 | 必要 | 1B币券<br />2会员购优惠券<br />3漫画福利券<br />4会员购包邮券<br />5漫画商城优惠券<br />6装扮体验卡<br />7课堂优惠券 |
| csrf | str | CSRF Token (位于cookie) | 必要 | |
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
|---------|-----|------|---------------------------------------------------------------------------------------------------|
| code | num | 返回值 | -101账号未登录<br />-111csrf 校验失败<br />-400请求错误<br />69800网络繁忙 请稍后再试<br />69801你已领取过该权益<br />0成功 |
| message | str | 错误信息 | |
| ttl | num | 1 | |
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------------------------------------------- |
| code | num | 返回值 | 0成功<br />-101账号未登录<br />-111csrf 校验失败<br />-400请求错误<br />69800网络繁忙 请稍后再试<br />69801你已领取过该权益 |
| message | str | 错误信息 | 成功时为`0` |
| ttl | num | 1 | |
**示例:**
```shell
curl 'https://api.bilibili.com/x/vip/privilege/receive' \
-b 'SESSDATA=xxx' \
--data-urlencode 'type=1' \
--data-urlencode 'csrf=xxx'
-b 'SESSDATA=xxx' \
--data-urlencode 'type=1' \
--data-urlencode 'csrf=xxx'
```
<details>
@@ -49,7 +49,7 @@ curl 'https://api.bilibili.com/x/vip/privilege/receive' \
## 大会员每日经验
> https://api.bilibili.com/x/vip/experience/add
> <https://api.bilibili.com/x/vip/experience/add>
*请求方式POST*
@@ -57,39 +57,55 @@ curl 'https://api.bilibili.com/x/vip/privilege/receive' \
**正文参数 (application/x-www-form-urlencoded)**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|------|-----|-----------------------|-------------|--------------------------------------------------------------------------------------|
| csrf | str | CSRF Token (位于cookie) | Cookie 方式必要 | |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------------------- | ------ | ---- |
| csrf | str | CSRF Token (位于cookie) | 必要 | |
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
|---------|-----|------|---------------------------------------------------------------------------------------------------|
| code | num | 返回值 | -101账号未登录<br />-111csrf 校验失败<br />69198用户经验已经领取<br />6034007请求频繁,请稍后再试<br />0成功 |
| message | str | 错误信息 | ` |
| ttl | num | 1 | |
| data | obj | | 信息本体 |
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ---------------------------------------------------------------------------------------------- |
| code | num | 返回值 | 0成功<br />-101账号未登录<br />-111csrf 校验失败<br />69198用户经验已经领取<br />6034007请求频繁,请稍后再试 |
| message | str | 错误信息 | 成功时为`0` |
| ttl | num | 1 | |
| data | obj | 信息本体 | |
**`data`对象:**
`data`对象:
| 字段 | 类型 | 内容 | 备注 |
| ------------------ | ------------------------------- | -------------------- | ---------------------------------------------- |
| type | num | 0 | |
| is_grant | bool | | 暂时发现 code 为 0 时为 `true` |
| 字段 | 类型 | 内容 | 备注 |
| -------- | ---- | ------------ | ---------------- |
| type | num | 0 | **作用尚不明确** |
| is_grant | bool | 是否领取成功 | |
**示例:**
```shell
curl 'https://api.bilibili.com/x/vip/experience/add' \
-b 'SESSDATA=xxx' \
--data-urlencode 'csrf=xxx'
-b 'SESSDATA=xxx' \
--data-urlencode 'csrf=xxx'
```
<details>
<summary>查看响应示例:</summary>
当经验领取成功时:
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"type": 0,
"is_grant": true
}
}
```
当经验已经领取过时:
```json
{
"code": 69198,

View File

@@ -21,20 +21,29 @@
`data`对象:
| 字段 | 类型 | 内容 | 备注 |
| ---------------- | ----- | -------------- | ----------- |
| list | array | 卡券信息列表 | |
| is_short_vip | bool | (?) | |
| is_freight_open | bool | (?) | |
| level | num | 当前等级 | |
| cur_exp | num | 当前拥有经验值 | |
| next_exp | num | 升级所需经验值 | 满级时为 -1 |
| is_vip | bool | 是否为大会员 | |
| is_senior_member | num | (?) | |
| format060102 | num | (?) | |
| 字段 | 类型 | 内容 | 备注 |
| ---------------- | ----- | ---------------------- | ------------------- |
| list | array | 卡券信息列表 | |
| is_short_vip | bool | (?) | |
| is_freight_open | bool | (?) | |
| level | num | 当前等级 | |
| cur_exp | num | 当前拥有经验值 | |
| next_exp | num | 升级所需经验值 | 满级时为 -1 |
| is_vip | bool | 是否为大会员 | |
| is_senior_member | num | 是否为硬核会员 | |
| format060102 | num | (?) | 格式为`YYMMDD`,意义不明 |
| is_overdue_vip | bool | 大会员是否过期 | |
| vip_status | num | 会员状态 | 0无<br />1有 |
| vip_type | num | 会员类型 | 0无<br />1月大会员<br />2年度及以上大会员 |
| keeptime_end | num | 大会员当前阶段过期时间 | 秒级时间戳 |
| vip_due_date | num | 大会员过期时间 | 秒级时间戳 |
| vip_is_annual | bool | 是否为年度及以上大会员 | |
| vip_is_month | bool | 是否为月大会员 | |
| vip_is_new_user | bool | 是否为大会员新用户 | |
| bind_phone | str | 绑定的手机号 | 星号隐藏部分信息 |
| taobao_account | 有效时obj<br />无效时null | 绑定的淘宝账号 | |
`list`数组:
`list`数组中的对象:
| 索引 | 类型 | 内容 | type | 备注 |
| ---- | ---- | -------------------------------- | ---- | ------------------------------- |
@@ -56,24 +65,25 @@
| state | num | 兑换状态 | 0未兑换<br />1已兑换<br />2未完成若需要完成 |
| expire_time | num | 本轮卡券过期时间戳 | 当月月底/当日24点 |
| vip_type | num | 当前用户的大会员状态 | 2年度大会员 |
| next_receive_days | num | 距下一轮兑换剩余天数 | 无权限时,每月任务固定为 0每日固定为 1 |
| next_receive_days | num | 距下一轮兑换剩余天数 | 无权限时,每月任务固定为 0每日固定为 1 |
| period_end_unix | num | 下一轮兑换开始时间戳 | 秒级时间戳 |
**注意:**
卡券除每日可领取(`type``8``9`)的,其他可通过 [https://api.bilibili.com/x/vip/privilege/receive](./action.md#兑换卡券) 领取
卡券除每日可领取(`type``8``9`)的,其他可通过 [https://api.bilibili.com/x/vip/privilege/receive](./action.md#兑换卡券) 领取
每日 10 经验领取(`type``9`)需要完成视频观看,未完成的 `state` 为 2。
**示例:**
```shell
curl 'https://api.bilibili.com/x/vip/privilege/my' \
-b "SESSDATA=xxx"
-b "SESSDATA=xxx"
```
<details>
<summary>查看响应示例:</summary>
```json
{
"code": 0,
@@ -84,46 +94,336 @@ curl 'https://api.bilibili.com/x/vip/privilege/my' \
{
"type": 1,
"state": 0,
"expire_time": 1667231999,
"expire_time": 0,
"vip_type": 2,
"next_receive_days": 29,
"period_end_unix": 1667491200
"period_end_unix": 1747584000,
"is_count": true,
"name": "",
"coupon_code": "",
"app_describe": "",
"recive_state": 1,
"salary_type": 0,
"exp_params": {
"exp_group_tag": "59534,45476",
"hit_value": 2
},
"extra_params": null
},
{
"type": 2,
"state": 0,
"expire_time": 1667231999,
"expire_time": 0,
"vip_type": 2,
"next_receive_days": 29,
"period_end_unix": 1667491200
"period_end_unix": 1747584000,
"is_count": true,
"name": "",
"coupon_code": "",
"app_describe": "",
"recive_state": 1,
"salary_type": 0,
"exp_params": {
"exp_group_tag": "",
"hit_value": 0
},
"extra_params": null
},
{
"type": 3,
"state": 0,
"expire_time": 1667231999,
"expire_time": 0,
"vip_type": 2,
"next_receive_days": 29,
"period_end_unix": 1667491200
"period_end_unix": 1747584000,
"is_count": true,
"name": "",
"coupon_code": "",
"app_describe": "",
"recive_state": 1,
"salary_type": 0,
"exp_params": {
"exp_group_tag": "",
"hit_value": 0
},
"extra_params": null
},
{
"type": 4,
"state": 0,
"expire_time": 1667231999,
"expire_time": 0,
"vip_type": 2,
"next_receive_days": 29,
"period_end_unix": 1667491200
"period_end_unix": 1747584000,
"is_count": true,
"name": "",
"coupon_code": "",
"app_describe": "",
"recive_state": 1,
"salary_type": 0,
"exp_params": {
"exp_group_tag": "",
"hit_value": 0
},
"extra_params": null
},
{
"type": 5,
"state": 0,
"expire_time": 1667231999,
"expire_time": 0,
"vip_type": 2,
"next_receive_days": 29,
"period_end_unix": 1667491200
"period_end_unix": 1747584000,
"is_count": true,
"name": "",
"coupon_code": "",
"app_describe": "",
"recive_state": 1,
"salary_type": 0,
"exp_params": {
"exp_group_tag": "",
"hit_value": 0
},
"extra_params": null
},
{
"type": 6,
"state": 0,
"expire_time": 0,
"vip_type": 2,
"next_receive_days": 29,
"period_end_unix": 1747584000,
"is_count": true,
"name": "",
"coupon_code": "",
"app_describe": "",
"recive_state": 1,
"salary_type": 0,
"exp_params": {
"exp_group_tag": "",
"hit_value": 0
},
"extra_params": null
},
{
"type": 7,
"state": 0,
"expire_time": 0,
"vip_type": 2,
"next_receive_days": 29,
"period_end_unix": 1747584000,
"is_count": true,
"name": "",
"coupon_code": "",
"app_describe": "",
"recive_state": 1,
"salary_type": 0,
"exp_params": {
"exp_group_tag": "",
"hit_value": 0
},
"extra_params": null
},
{
"type": 14,
"state": 0,
"expire_time": 0,
"vip_type": 2,
"next_receive_days": 29,
"period_end_unix": 1747584000,
"is_count": true,
"name": "",
"coupon_code": "",
"app_describe": "",
"recive_state": 1,
"salary_type": 0,
"exp_params": {
"exp_group_tag": "59534,45476",
"hit_value": 2
},
"extra_params": null
},
{
"type": 15,
"state": 0,
"expire_time": 0,
"vip_type": 2,
"next_receive_days": 29,
"period_end_unix": 1747584000,
"is_count": true,
"name": "",
"coupon_code": "",
"app_describe": "",
"recive_state": 1,
"salary_type": 0,
"exp_params": {
"exp_group_tag": "",
"hit_value": 0
},
"extra_params": null
},
{
"type": 16,
"state": 0,
"expire_time": 0,
"vip_type": 2,
"next_receive_days": 29,
"period_end_unix": 1747584000,
"is_count": true,
"name": "",
"coupon_code": "",
"app_describe": "",
"recive_state": 1,
"salary_type": 0,
"exp_params": {
"exp_group_tag": "",
"hit_value": 0
},
"extra_params": null
},
{
"type": 17,
"state": 0,
"expire_time": 0,
"vip_type": 2,
"next_receive_days": 29,
"period_end_unix": 1747584000,
"is_count": true,
"name": "",
"coupon_code": "",
"app_describe": "",
"recive_state": 1,
"salary_type": 0,
"exp_params": {
"exp_group_tag": "",
"hit_value": 0
},
"extra_params": null
},
{
"type": 18,
"state": 0,
"expire_time": 0,
"vip_type": 2,
"next_receive_days": 0,
"period_end_unix": 0,
"is_count": true,
"name": "",
"coupon_code": "",
"app_describe": "",
"recive_state": 1,
"salary_type": 1,
"exp_params": {
"exp_group_tag": "",
"hit_value": 0
},
"extra_params": null
},
{
"type": 19,
"state": 0,
"expire_time": 0,
"vip_type": 2,
"next_receive_days": 0,
"period_end_unix": 0,
"is_count": false,
"name": "",
"coupon_code": "",
"app_describe": "",
"recive_state": 1,
"salary_type": 1,
"exp_params": {
"exp_group_tag": "",
"hit_value": 0
},
"extra_params": {
"is_allowe_receive": "true",
"is_show": "true",
"last_salary_time": "0",
"now": "1745138836"
}
},
{
"type": 20,
"state": 0,
"expire_time": 0,
"vip_type": 2,
"next_receive_days": 0,
"period_end_unix": 0,
"is_count": false,
"name": "",
"coupon_code": "",
"app_describe": "",
"recive_state": 1,
"salary_type": 1,
"exp_params": {
"exp_group_tag": "",
"hit_value": 0
},
"extra_params": {
"is_allowe_receive": "false",
"is_show": "false",
"last_salary_time": "0",
"now": "1745138836"
}
},
{
"type": 8,
"state": 1,
"expire_time": 1745164800,
"vip_type": 2,
"next_receive_days": 1,
"period_end_unix": 1745164800,
"is_count": true,
"name": "",
"coupon_code": "",
"app_describe": "",
"recive_state": 2,
"salary_type": 1,
"exp_params": {
"exp_group_tag": "",
"hit_value": 0
},
"extra_params": null
},
{
"type": 9,
"state": 0,
"expire_time": 1745164800,
"vip_type": 2,
"next_receive_days": 1,
"period_end_unix": 1745164800,
"is_count": false,
"name": "",
"coupon_code": "",
"app_describe": "",
"recive_state": 1,
"salary_type": 0,
"exp_params": {
"exp_group_tag": "",
"hit_value": 0
},
"extra_params": null
}
],
"is_short_vip": false,
"is_freight_open": true
"is_freight_open": true,
"level": 6,
"cur_exp": 34424,
"next_exp": -1,
"is_vip": true,
"is_senior_member": 1,
"format060102": 250418,
"is_overdue_vip": false,
"vip_status": 1,
"vip_type": 2,
"keeptime_end": 1747584000,
"vip_due_date": 1832083200,
"vip_is_annual": true,
"vip_is_month": false,
"vip_is_new_user": false,
"bind_phone": "138****0000",
"taobao_account": null
}
}
```