feat: 各种接口补充与错误修正 (#1066)

* fix(video/collection.md): unclosed xml tags

* feat(video/report.md): uuid not really random

* feat: b23.tv short link

* feat: login/moral/exp log

* feat: v_voucher

* feat: upload video cover & post

* feat(creativecenter/upload.md): upload octet-stream

* feat(creativecenter/upload.md): update some notes

* feat(clientinfo/ip.md): another from live

* feat: live web heartbeat

* feat: update popular series & precious

* fix(creativecenter/upload.md): mistakes in example

* feat: merge duplicate fav info

* feat(README.md): missing link to webmask

* feat(search/hot.md): word_type

* feat(login/login_action): recovery old api

* feat(video/collection.md):  series operation

* feat: video season operation

* feat: add & mod some links

* feat(search/suggest.md): up to date

* feat: web home header image

* feat(misc/sign/bili_ticket.md): demo for nodejs

* feat(creativecenter/upload.md): x-upos-auth validity period

* feat: add referer & buvid3 to request header

* feat: customer service message heartbeat & upload

* feat(customerservice/msg.md): upload code 1200201

* feat(video/report.md): click/web/h5

* feat(video/report.md): view count desc

* feat: laser2

* feat: wbi_key in bili_ticket

* fix: typo & unclosed XML tags

* feat(misc/sign/v_voucher): cookie x-bili-gaia-vtoken

* feat(search/hot.md): square

* feat(video/status_number.md): fold archive_stat/stat

* feat(fav/info.md): resource/infos invalid type 21

* feat: /x/activity/subject/info

* feat: lottery

* feat(docs/misc/b23.tv): remove some unnecessary fields

* feat(creativecenter/upload.md): types/predict

* fix(video/collection.md): invalid end tag

* feat: app version upgrade

* feat(creativecenter/upload.md): tag/recommend #528

* feat(user/status_number.md): navnum

* feat: /x/activity/page/list

* feat(comment/list.md): desc about pagination_str

* feat(comment/list.md): update example

* feat(dynamic/all.md): #1082

* fix(comment/list.md): -352 not -412

* feat: #700

* feat(video/video_stream.md): #606 & cv949156

* feat(message/private_msg.md): single_unread freq

* feat: getUserWallet

* fix: broken form

* feat(Layout.vue): copyright to 2024

* feat: /x/topic/pub/rcmd/search

* feat: #425

* feat(misc/time_stamp.md): rtc/getTimestamp

* fix(misc/time_stamp.md): missing end tag

* feat: #745

* feat(dynamic/all.md): update feed/all

* feat(danmaku/action.md): #220

* feat(live/info.md): gethistory from cv8186413

* fix(danmaku/action.md): missing end tag
This commit is contained in:
Session小胡
2024-08-21 19:02:39 +08:00
committed by GitHub
parent f7599fb693
commit 60a0c5d1a2
46 changed files with 18489 additions and 8207 deletions

213
docs/activity/list.md Normal file
View File

@@ -0,0 +1,213 @@
# 活动列表
## 获取活动列表
> https://api.bilibili.com/x/activity/page/list
*请求方式: GET*
**URL参数:**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ---- |
| plat | str | 活动平台类型? | 必要 | 可选范围 [1, 3], 以半角逗号分隔, 默认 `1,3` |
| mold | int | 0 | 非必要 | |
| http | int | 3 | 非必要 | |
| pn | int | 目标页码 | 非必要 | 默认为 `1` |
| ps | int | 每页条数 | 非必要 | 默认为 `15` |
**JSON回复:**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| - | - | - | - |
| code | int | 返回值 | 0成功<br />-400请求错误 |
| message | str | 错误信息 | 默认为 0 |
| ttl | int | 1 | |
| data | obj | 信息本体 | |
`data` 对象:
| 字段 | 类型 | 内容 | 备注 |
| - | - | - | - |
| list | array | 活动列表 | |
| num | int | 当前页码 | |
| size | int | 每页条数 | |
| total | int | 总条数 | |
`list` 数组中的对象:
| 字段 | 类型 | 内容 | 备注 |
| - | - | - | - |
| id | int | 活动 ID | |
| state | int | 1 | |
| stime | int | 开始时间 | UNIX 秒级时间戳 |
| etime | int | 结束时间 | UNIX 秒级时间戳 |
| ctime | int | 创建时间? | UNIX 秒级时间戳, 可能为 0 |
| mtime | int | 修改时间? | UNIX 秒级时间戳, 可能为 0 |
| name | str | 活动名称 | |
| author | str | 空 ||
| pc_url | str | 空 ||
| rank | int | 0 | |
| h5_url | str | 活动链接 | |
| pc_cover | str | 空 | |
| h5_cover | str | 活动封面 | |
| page_name | str | 页面名称 | |
| plat | int | 活动平台类型? | 即 URL 中 `plat` 参数 |
| desc | str | 活动描述 | |
| click | int | 0 | |
| type | int | 0 | |
| mold | int | 0 | |
| series | int | 0 | |
| dept | int | 0 | |
| reply_id | int | 0 | |
| tp_id | int | 0 | |
| ptime | int | 0 | |
| catalog | int | 0 | |
| creator | str | 空 | |
| spm_id | str | 空 | |
**示例:**
```shell
curl -G 'https://api.bilibili.com/x/activity/page/list' \
--url-query 'plat=1,2,3' \
--url-query 'ps=4'
```
<details>
<summary>查看响应示例:</summary>
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"list": [
{
"id": 207,
"state": 1,
"stime": 1723262400,
"etime": 1724774399,
"ctime": 0,
"mtime": 0,
"name": "原神fes2024",
"author": "",
"pc_url": "",
"rank": 0,
"h5_url": "https://www.bilibili.com/blackboard/era/DK8i0NS7fxwcLBgm.html",
"pc_cover": "",
"h5_cover": "https://i0.hdslb.com/bfs/activity-plat/static/d32c2bb79f59192cb072d7bf79b61c6d/In2tYOLFTZ.png",
"page_name": "原神fes2024",
"plat": 2,
"desc": "",
"click": 0,
"type": 0,
"mold": 0,
"series": 0,
"dept": 0,
"reply_id": 0,
"tp_id": 0,
"ptime": 0,
"catalog": 0,
"creator": "",
"spm_id": ""
},
{
"id": 210,
"state": 1,
"stime": 1723219200,
"etime": 1725983999,
"ctime": 0,
"mtime": 0,
"name": "暗区突围端游海外版全员夺金冲榜挑战赛",
"author": "",
"pc_url": "",
"rank": 0,
"h5_url": "https://www.bilibili.com/blackboard/era/UP8CZSTfboDVZuGr.html",
"pc_cover": "",
"h5_cover": "https://i0.hdslb.com/bfs/activity-plat/static/f9a67e268d55d029e6b27d81246fc59a/LPN9dlcRlW.png",
"page_name": "暗区突围端游海外版全员夺金冲榜挑战赛",
"plat": 2,
"desc": "",
"click": 0,
"type": 0,
"mold": 0,
"series": 0,
"dept": 0,
"reply_id": 0,
"tp_id": 0,
"ptime": 0,
"catalog": 0,
"creator": "",
"spm_id": ""
},
{
"id": 199,
"state": 1,
"stime": 1723089600,
"etime": 1725897599,
"ctime": 0,
"mtime": 0,
"name": "剑与远征:启程公测创作者激励",
"author": "",
"pc_url": "",
"rank": 0,
"h5_url": "https://www.bilibili.com/blackboard/era/HkHatvvW9nJZXEMh.html",
"pc_cover": "",
"h5_cover": "https://i0.hdslb.com/bfs/activity-plat/static/7785e7ecb0434c85530b92e3586f32ff/CgKENr0ftC.jpeg",
"page_name": "剑与远征:启程公测创作者激励",
"plat": 2,
"desc": "",
"click": 0,
"type": 0,
"mold": 0,
"series": 0,
"dept": 0,
"reply_id": 0,
"tp_id": 0,
"ptime": 0,
"catalog": 0,
"creator": "",
"spm_id": ""
},
{
"id": 203,
"state": 1,
"stime": 1723089600,
"etime": 1724255999,
"ctime": 0,
"mtime": 0,
"name": "王者荣耀新英雄少司缘创作激励",
"author": "",
"pc_url": "",
"rank": 0,
"h5_url": "https://www.bilibili.com/blackboard/era/g0gn2j4ZENrCLYLn.html",
"pc_cover": "",
"h5_cover": "https://i0.hdslb.com/bfs/activity-plat/static/a99ba278036e9fbfa81b9100d13d9e7e/9UHZg6r0Y5.jpg",
"page_name": "王者荣耀新英雄少司缘创作激励",
"plat": 2,
"desc": "",
"click": 0,
"type": 0,
"mold": 0,
"series": 0,
"dept": 0,
"reply_id": 0,
"tp_id": 0,
"ptime": 0,
"catalog": 0,
"creator": "",
"spm_id": ""
}
],
"num": 1,
"size": 4,
"total": 5391
}
}
```
</details>