Northern_Lights/bilibili-API-collect
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

调整部分接口描述与错误修复 (#1088)

Browse Source 
* fix(search/search_request.md): cookie buvid3

* feat(login/login_action/password.md): more sms desc

* fix: typo

* feat(live/info.md): add ps for getRoomBaseInfo

* fix(danmaku/action.md): broken form

* chore: Browserslist: caniuse-lite is outdated

* feat(comment/list.md): reply/wbi/main param next

* feat(misc/buvid3_4.md): get buvid3 only

* fix: broken links & wrong code type

* feat: close all img & br tags

* feat(login/cookie_refresh.md): missing demo links

* feat(dynamic/detail.md): /lottery_svr/v1/lottery_svr/lottery_notice

* fix(video/action.md): share cookie buvid3

* feat: deprecated stat & attribute

* feat(dynamic/detail.md): reaction

* feat(misc/sign/v_voucher.md): header

* feat(dynamic/detail.md): update detail params & example

* feat(APP_widget/ver.md): /x/v2/version

* feat(video/info.md): update view

* feat(docs/user.md): remove channel

* feat(search/search_request.md): search/type -1200

* feat(user/space.md): audio

* feat(video/player.md): /x/player/wbi/v2

* feat(audio/musicstream_url.md): update web/url

* feat(comment/readme.md): state

* fix(user/medal.md): wrong guard_level desc

* feat(live/message_stream.md): DANMU_MSG

* fix(user/medals): wrong guard_level & guard_icon desc

* feat(live/message_stream.md): format & add more 'cmd'

* feat(live/message_stream.md): add more 'cmd'

* feat(live/message_stream.md): add tips for non-login users

* feat(video/player.md): need_login_subtitle

---------

Co-authored-by: 社会易姐QwQ <45892418+SocialSisterYi@users.noreply.github.com>
This commit is contained in:
Session小胡
2024-09-19 23:17:33 +08:00
committed by GitHub
parent 2dbdcd884d
commit 1e24c6b188
32 changed files with 4207 additions and 2654 deletions
Download Patch File Download Diff File Expand all files Collapse all files

790
docs/dynamic/detail.md
View File

@@ -1,49 +1,64 @@
# 获取动态详情
## 动态详情
> https://api.bilibili.com/x/polymer/web-dynamic/v1/detail
请求方式：`GET`
*请求方式: GET*
是否需要登录：`否`
认证方式: Cookie (SESSDATA) (非必要)
## URL参数
鉴权方式: Cookie (User-Agent) (必要), [Wbi 签名](../misc/sign/wbi.md) (非必要)
| 参数名 | 类型 | 必填 | 内容 | 备注 |
|-----------------|-----|-----|--------|-----|
| timezone_offset | num | | `-480` | |
| id | num | √ | 动态id | |
**URL参数:**
## Json回复
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| --- | --- | --- | --- | --- |
| id | num | 动态 ID | 必要 | |
| timezone_offset | num | -480 | 非必要 | |
| platform | str | 平台 | 非必要 | `web` |
| gaia_source | str | 来源 | 非必要 | `main_web` |
| features | str | 功能 | 非必要 | `itemOpusStyle,opusBigCover,onlyfansVote,endFooterHidden,decorationCard,onlyfansAssetsV2,ugcDelete,onlyfansQaCard,commentsNewVersion` |
| web_location | str | `333.1368` | 非必要 | |
| x-bili-device-req-json | obj | 设备信息? | 非必要 | `{"platform":"web","device":"pc"}` |
| x-bili-web-req-json | obj | 请求信息? | 非必要 | `{"spm_id":"333.1368"}` |
| w_rid | str | Wbi 签名 | 不必要 | 参见 [Wbi 签名](../misc/sign/wbi.md) |
| wts | num | UNIX 秒级时间戳 | 不必要 | 参见 [Wbi 签名](../misc/sign/wbi.md) |
### 根对象
**JSON回复:**
根对象:
| 字段名 | 类型 | 内容 | 备注 |
|---------|-----|------|--------------------------|
| code | num | 响应码 | 0：成功<br/>4101139：4101139 |
| code | num | 响应码 | 0: 成功<br/>-352: 风控校验失败<br />4101139: 4101139 |
| message | str | | |
| ttl | num | 1 | |
| data | obj | 信息本体 | |
### `data`对象
`data`对象:
| 字段名 | 类型 | 内容 | 备注 |
|------|-----|-----|-----|
| item | obj | | |
### `data`对象 -> `item`对象
`data.item`对象:
参照 [获取动态列表](./all.md#获取动态列表)
## 请求示例
**示例:**
```shell
curl -L -X GET 'https://api.bilibili.com/x/polymer/web-dynamic/v1/detail?id=724328028268658744'
curl -G 'https://api.bilibili.com/x/polymer/web-dynamic/v1/detail' \
-A 'Mozilla/5.0 (X11; Linux x86_64; rv:109.0) Gecko/20100101 Firefox/115.0' \
-b 'SESSDATA=xxxxxx' \
--url-query 'id=967717348014293017' \
--url-query 'w_rid=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' \
--url-query 'wts=1724986186'
```
## 响应示例
<details>
<summary>点击查看</summary>
<summary>查看响应示例:</summary>
```json
{
@@ -53,65 +68,137 @@ curl -L -X GET 'https://api.bilibili.com/x/polymer/web-dynamic/v1/detail?id=7243
"data": {
"item": {
"basic": {
"comment_id_str": "724328028268658744",
"comment_type": 17,
"comment_id_str": "326122895",
"comment_type": 11,
"like_icon": {
"action_url": "",
"end_url": "",
"id": 0,
"start_url": ""
},
"rid_str": "724328032624443401"
"rid_str": "326122895"
},
"id_str": "724328028268658744",
"id_str": "967717348014293017",
"modules": {
"module_author": {
"face": "https://i2.hdslb.com/bfs/face/876bf5dfa8c583acb5f8689fc923077f6a2aba23.jpg",
"avatar": {
"container_size": {
"height": 1.35,
"width": 1.35
},
"fallback_layers": {
"is_critical_group": true,
"layers": [
{
"general_spec": {
"pos_spec": {
"axis_x": 0.675,
"axis_y": 0.675,
"coordinate_pos": 2
},
"render_spec": {
"opacity": 1
},
"size_spec": {
"height": 1,
"width": 1
}
},
"layer_config": {
"is_critical": true,
"tags": {
"AVATAR_LAYER": {},
"GENERAL_CFG": {
"config_type": 1,
"general_config": {
"web_css_style": {
"borderRadius": "50%"
}
}
}
}
},
"resource": {
"res_image": {
"image_src": {
"placeholder": 6,
"remote": {
"bfs_style": "widget-layer-avatar",
"url": "https://i2.hdslb.com/bfs/face/77906db03b1eefac02613de184afad03f7bc58d7.jpg"
},
"src_type": 1
}
},
"res_type": 3
},
"visible": true
}
]
},
"mid": "645769214"
},
"decorate": {
"card_url": "https://i0.hdslb.com/bfs/vip/a9e3d993c7a15e88ce0bf714a142f7d2b44121e2.png",
"fan": {
"color": "",
"color_format": null,
"is_fan": false,
"num_prefix": "",
"num_str": "",
"number": 0
},
"id": 28,
"jump_url": "https://www.bilibili.com/h5/mall/equity-link/collect-home?item_id=28&isdiy=0&part=card&from=post&f_source=garb&vmid=645769214&native.theme=1&navhide=1",
"name": "2233娘",
"type": 1
},
"face": "https://i2.hdslb.com/bfs/face/77906db03b1eefac02613de184afad03f7bc58d7.jpg",
"face_nft": false,
"following": null,
"jump_url": "//space.bilibili.com/11357018/dynamic",
"jump_url": "//space.bilibili.com/645769214/dynamic",
"label": "",
"mid": 11357018,
"name": "动画魂-Anitama",
"mid": 645769214,
"name": "Session小胡",
"official_verify": {
"desc": "",
"type": 0
"type": -1
},
"pendant": {
"expire": 0,
"image": "",
"image_enhance": "",
"image_enhance_frame": "",
"n_pid": 0,
"name": "",
"pid": 0
},
"pub_action": "",
"pub_location_text": "",
"pub_time": "2022-11-03 22:02",
"pub_ts": 1667484162,
"pub_time": "2024年08月20日 19:17",
"pub_ts": 1724152653,
"type": "AUTHOR_TYPE_NORMAL",
"vip": {
"avatar_subscript": 1,
"avatar_subscript": 0,
"avatar_subscript_url": "",
"due_date": 1685808000000,
"due_date": 1665158400000,
"label": {
"bg_color": "#FB7299",
"bg_style": 1,
"bg_color": "",
"bg_style": 0,
"border_color": "",
"img_label_uri_hans": "",
"img_label_uri_hans_static": "https://i0.hdslb.com/bfs/vip/8d4f8bfc713826a5412a0a27eaaac4d6b9ede1d9.png",
"img_label_uri_hans_static": "https://i0.hdslb.com/bfs/vip/d7b702ef65a976b20ed854cbd04cb9e27341bb79.png",
"img_label_uri_hant": "",
"img_label_uri_hant_static": "https://i0.hdslb.com/bfs/activity-plat/static/20220614/e369244d0b14644f5e1a06431e22a4d5/VEW8fCC0hg.png",
"label_theme": "annual_vip",
"img_label_uri_hant_static": "https://i0.hdslb.com/bfs/activity-plat/static/20220614/e369244d0b14644f5e1a06431e22a4d5/KJunwh19T5.png",
"label_theme": "",
"path": "",
"text": "年度大会员",
"text_color": "#FFFFFF",
"text": "",
"text_color": "",
"use_img_label": true
},
"nickname_color": "#FB7299",
"status": 1,
"nickname_color": "",
"status": 0,
"theme_type": 0,
"type": 2
"type": 1
}
},
"module_dynamic": {
@@ -119,151 +206,538 @@ curl -L -X GET 'https://api.bilibili.com/x/polymer/web-dynamic/v1/detail?id=7243
"desc": {
"rich_text_nodes": [
{
"orig_text": "恭喜 @羽希plume @晕乎菌 中奖，已私信联系。——全天加码放水，红包力度很大，打开手淘搜“我爱你红包”，红包每天可以领，积少成多。 ——明天早上9点开另外一则抽奖，有打扰请多保函。\n",
"text": "恭喜 @羽希plume @晕乎菌 中奖，已私信联系。——全天加码放水，红包力度很大，打开手淘搜“我爱你红包”，红包每天可以领，积少成多。 ——明天早上9点开另外一则抽奖，有打扰请多保函。\n",
"orig_text": "今天因为Linux被骂, 决定放弃支持 Windows. 而且明天要开始军训了, 将停更若干时间, 遂发此动态, 望不知.",
"text": "今天因为Linux被骂, 决定放弃支持 Windows. 而且明天要开始军训了, 将停更若干时间, 遂发此动态, 望不知.",
"type": "RICH_TEXT_NODE_TYPE_TEXT"
}
],
"text": "恭喜 @羽希plume @晕乎菌 中奖，已私信联系。——全天加码放水，红包力度很大，打开手淘搜“我爱你红包”，红包每天可以领，积少成多。 ——明天早上9点开另外一则抽奖，有打扰请多保函。\n"
"text": "今天因为Linux被骂, 决定放弃支持 Windows. 而且明天要开始军训了, 将停更若干时间, 遂发此动态, 望不知."
},
"major": {
"draw": {
"id": 326122895,
"items": [
{
"height": 1080,
"size": 1005.29,
"src": "http://i0.hdslb.com/bfs/new_dyn/0f6f939334104ddc347566514fa4bfa7645769214.jpg",
"tags": [],
"width": 1440
}
]
},
"type": "MAJOR_TYPE_DRAW"
},
"major": null,
"topic": null
},
"module_more": {
"three_point_items": [
{
"label": "举报",
"type": "THREE_POINT_REPORT"
"label": "删除",
"modal": {
"cancel": "取消",
"confirm": "确认删除",
"content": "动态删除后将无法恢复，请谨慎操作",
"title": "要删除动态吗？"
},
"params": {
"dyn_id_str": "967717348014293017",
"dyn_type": 2,
"rid_str": "326122895"
},
"type": "THREE_POINT_DELETE"
}
]
},
"module_stat": {
"comment": {
"count": 5,
"count": 34,
"forbidden": false
},
"forward": {
"count": 1,
"count": 2,
"forbidden": false
},
"like": {
"count": 170,
"count": 65,
"forbidden": false,
"status": false
"status": true
}
}
},
"orig": {
"basic": {
"comment_id_str": "",
"comment_type": 0,
"like_icon": {
"action_url": "",
"end_url": "",
"id": 0,
"start_url": ""
},
"rid_str": ""
},
"id_str": "720590749615259664",
"modules": {
"module_author": {
"face": "https://i2.hdslb.com/bfs/face/876bf5dfa8c583acb5f8689fc923077f6a2aba23.jpg",
"face_nft": false,
"following": null,
"jump_url": "//space.bilibili.com/11357018/dynamic",
"label": "",
"mid": 11357018,
"name": "动画魂-Anitama",
"official_verify": {
"desc": "",
"type": 0
},
"pendant": {
"expire": 0,
"image": "",
"image_enhance": "",
"image_enhance_frame": "",
"name": "",
"pid": 0
},
"pub_action": "",
"pub_time": "",
"pub_ts": 1666614008,
"type": "AUTHOR_TYPE_NORMAL",
"vip": {
"avatar_subscript": 1,
"avatar_subscript_url": "",
"due_date": 1685808000000,
"label": {
"bg_color": "#FB7299",
"bg_style": 1,
"border_color": "",
"img_label_uri_hans": "",
"img_label_uri_hans_static": "https://i0.hdslb.com/bfs/vip/8d4f8bfc713826a5412a0a27eaaac4d6b9ede1d9.png",
"img_label_uri_hant": "",
"img_label_uri_hant_static": "https://i0.hdslb.com/bfs/activity-plat/static/20220614/e369244d0b14644f5e1a06431e22a4d5/VEW8fCC0hg.png",
"label_theme": "annual_vip",
"path": "",
"text": "年度大会员",
"text_color": "#FFFFFF",
"use_img_label": true
},
"nickname_color": "#FB7299",
"status": 1,
"theme_type": 0,
"type": 2
}
},
"module_dynamic": {
"additional": null,
"desc": {
"rich_text_nodes": [
{
"orig_text": "​双11天猫红包，超大力度提前发放\n活动很猛，红包很大，加额加量！\n打开手淘搜“我爱你红包”\n打开手淘搜“我爱你红包”\n打开手淘搜“我爱你红包”\n最高可领取28888元\n\n一天可领3次，今天红包额度最大\n越早领取得现金概率越大！\n抽奖=转发+关注",
"text": "​双11天猫红包，超大力度提前发放\n活动很猛，红包很大，加额加量！\n打开手淘搜“我爱你红包”\n打开手淘搜“我爱你红包”\n打开手淘搜“我爱你红包”\n最高可领取28888元\n\n一天可领3次，今天红包额度最大\n越早领取得现金概率越大！\n抽奖=转发+关注",
"type": "RICH_TEXT_NODE_TYPE_TEXT"
},
{
"jump_url": "//search.bilibili.com/all?keyword=%23%E4%BA%92%E5%8A%A8%E6%8A%BD%E5%A5%96%23",
"orig_text": "#互动抽奖#",
"text": "#互动抽奖#",
"type": "RICH_TEXT_NODE_TYPE_TOPIC"
},
{
"orig_text": "\n转+评，留言你领到多少红包\n评论区随机抽取2位，每人补贴50零花钱 ",
"text": "\n转+评，留言你领到多少红包\n评论区随机抽取2位，每人补贴50零花钱 ",
"type": "RICH_TEXT_NODE_TYPE_TEXT"
}
],
"text": "​双11天猫红包，超大力度提前发放\n活动很猛，红包很大，加额加量！\n打开手淘搜“我爱你红包”\n打开手淘搜“我爱你红包”\n打开手淘搜“我爱你红包”\n最高可领取28888元\n\n一天可领3次，今天红包额度最大\n越早领取得现金概率越大！\n抽奖=转发+关注#互动抽奖#\n转+评，留言你领到多少红包\n评论区随机抽取2位，每人补贴50零花钱 "
},
"major": {
"draw": {
"id": 210334026,
"items": [
{
"height": 672,
"size": 134.85938,
"src": "https://i0.hdslb.com/bfs/new_dyn/37c21f8864e47cbeeb7c3e3a66bb250b11357018.jpg",
"tags": [],
"width": 576
}
]
},
"type": "MAJOR_TYPE_DRAW"
},
"topic": null
}
},
"type": "DYNAMIC_TYPE_DRAW",
"visible": true
},
"type": "DYNAMIC_TYPE_FORWARD",
"type": "DYNAMIC_TYPE_DRAW",
"visible": true
}
}
}
```
</details>
</details>
## 动态赞与转发列表
> https://api.bilibili.com/x/polymer/web-dynamic/v1/detail/reaction
*请求方式: GET*
认证方式: Cookie (SESSDATA)
注: 登录任意账号即可, 若不登录则返回数为 0
**URL参数:**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| --- | --- | --- | --- | --- |
| id | num | 动态 id | 必要 | |
| offset | obj | 偏移量 | 非必要 | 用于翻页, 即响应的 `data.offset` |
| web_location | str | 333.1369 | 非必要 | |
**JSON回复:**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| --- | --- | --- | --- |
| code | num | 返回值 | 0: 成功 |
| message | str | 错误信息 | 默认为 0 |
| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data` 对象:
| 字段 | 类型 | 内容 | 备注 |
| --- | --- | --- | --- |
| has_more | bool | 是否有更多 | |
| items | array | 赞与转发列表 | |
| offset | str | 偏移量 | 套了一层字符串的 JSON 对象, 用于下次请求 |
| total | num | 总数 | |
`data` 对象中的 `items` 数组中的对象:
| 字段 | 类型 | 内容 | 备注 |
| --- | --- | --- | --- |
| action | str | 操作类型 | 赞了/转发了 |
| attend | num | 参与数 | 1: 对方仅关注了发送者<br />2: 发送者关注了对方 |
| desc | str | 描述 | |
| face | str | 头像 URL | |
| mid | num | 用户 mid | |
| name | str | 用户名 | |
**示例:**
获取动态 `967717348014293017` 的赞与转发列表
```shell
curl -G 'https://api.bilibili.com/x/polymer/web-dynamic/v1/detail/reaction' \
--url-query 'id=967717348014293017' \
-b 'SESSDATA=xxx'
```
<details>
<summary>查看响应示例:</summary>
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"has_more": true,
"items": [
{
"action": "赞了",
"attend": 2,
"desc": "",
"face": "https://i0.hdslb.com/bfs/face/aebb2639a0d47f2ce1fec0631f412eaf53d4a0be.jpg",
"mid": "293793435",
"name": "社会易姐QwQ"
},
{
"action": "转发了",
"attend": 2,
"desc": "",
"face": "https://i1.hdslb.com/bfs/face/a8c0d532c19085ff14385abb51450d9c32afe93f.jpg",
"mid": "662407339",
"name": "XhuOffice"
},
{
"action": "赞了",
"attend": 2,
"desc": "",
"face": "https://i1.hdslb.com/bfs/face/a8c0d532c19085ff14385abb51450d9c32afe93f.jpg",
"mid": "662407339",
"name": "XhuOffice"
},
{
"action": "转发了",
"attend": 2,
"desc": "",
"face": "https://i1.hdslb.com/bfs/face/2c506dcf0b6507041b0bfafea7505cb1badf6ccd.jpg",
"mid": "616368979",
"name": "淡紫玲儿"
},
{
"action": "赞了",
"attend": 2,
"desc": "",
"face": "https://i1.hdslb.com/bfs/face/2c506dcf0b6507041b0bfafea7505cb1badf6ccd.jpg",
"mid": "616368979",
"name": "淡紫玲儿"
},
{
"action": "赞了",
"attend": 2,
"desc": "",
"face": "https://i2.hdslb.com/bfs/face/77906db03b1eefac02613de184afad03f7bc58d7.jpg",
"mid": "645769214",
"name": "Session小胡"
},
{
"action": "赞了",
"attend": 0,
"desc": "共同关注了3个Up主",
"face": "https://i0.hdslb.com/bfs/face/2ac46bacfdedebf9aecf6415b95dd58636b1e22a.jpg",
"mid": "340463550",
"name": "折耳喵之心"
},
{
"action": "赞了",
"attend": 0,
"desc": "",
"face": "https://i1.hdslb.com/bfs/face/ec855a27a42e174521399d7508cece6c0c02c6ff.jpg",
"mid": "628114249",
"name": "at白日梦想家"
},
{
"action": "赞了",
"attend": 0,
"desc": "共同关注了3个Up主",
"face": "https://i1.hdslb.com/bfs/face/81362ba3f99b2702b9746ca7fe67ffc76d3a97c4.jpg",
"mid": "198175",
"name": "傲娇金发黑丝双马尾"
},
{
"action": "赞了",
"attend": 0,
"desc": "",
"face": "https://i2.hdslb.com/bfs/face/df1c9bc7d79c84b7227486a944d7a748093fbb31.jpg",
"mid": "1007349302",
"name": "用户9420594"
},
{
"action": "赞了",
"attend": 0,
"desc": "",
"face": "https://i0.hdslb.com/bfs/face/f17befd18cab5e157844ab986bd6c60d58d74738.jpg",
"mid": "1180456113",
"name": "人工智能小冰_yoyo"
},
{
"action": "赞了",
"attend": 0,
"desc": "共同关注了2个Up主",
"face": "https://i0.hdslb.com/bfs/face/f1b0ebdf19c2f4b768c5a3e57cbd50e404ad9549.jpg",
"mid": "273008643",
"name": "LV1渡劫失败降到"
},
{
"action": "赞了",
"attend": 0,
"desc": "",
"face": "https://i0.hdslb.com/bfs/face/a7732df2624c6a0b6e5856ceb27f3c96598a2fd4.jpg",
"mid": "452290620",
"name": "评论永远比视频精彩"
},
{
"action": "赞了",
"attend": 0,
"desc": "",
"face": "https://i0.hdslb.com/bfs/face/cc2ea9088f066b33f24d39434d23aa68cb8ab761.png",
"mid": "91671246",
"name": "樱樱之雪"
},
{
"action": "赞了",
"attend": 0,
"desc": "共同关注了3个Up主",
"face": "http://i1.hdslb.com/bfs/face/d20eae4d6339cef2267b36c1c262ae6466395b64.jpg",
"mid": "340632388",
"name": "天神永恒hb"
},
{
"action": "赞了",
"attend": 0,
"desc": "共同关注了21个Up主",
"face": "https://i0.hdslb.com/bfs/face/368b2a33eed5dc146bd9ab8bf62bc9667653a350.jpg",
"mid": "38120922",
"name": "vgwik"
},
{
"action": "赞了",
"attend": 0,
"desc": "共同关注了2个Up主",
"face": "https://i2.hdslb.com/bfs/face/efbd8bb841ea6340f39854b82d9741f47cb3351e.jpg",
"mid": "691494413",
"name": "熬夜肝不好"
},
{
"action": "赞了",
"attend": 0,
"desc": "",
"face": "https://i1.hdslb.com/bfs/face/c46fe783ac7a5291dac4773744b3d35d7cebd77f.jpg",
"mid": "1486540726",
"name": "o_90"
},
{
"action": "赞了",
"attend": 0,
"desc": "",
"face": "https://i1.hdslb.com/bfs/face/fece6f971d14fddbddcede65a42edc63d01884d4.jpg",
"mid": "34474963",
"name": "Neko_vecter"
},
{
"action": "赞了",
"attend": 0,
"desc": "共同关注了8个Up主",
"face": "https://i0.hdslb.com/bfs/face/e1d66345bdb6f8c75b782ed5c4b93440860c894d.jpg",
"mid": "88466370",
"name": "没有钱的首富"
},
{
"action": "赞了",
"attend": 0,
"desc": "共同关注了15个Up主",
"face": "https://i0.hdslb.com/bfs/face/f8a6e77e5839e64a7448ddeb7112af86eb47aa48.jpg",
"mid": "14625981",
"name": "龙凌洛"
},
{
"action": "赞了",
"attend": 0,
"desc": "",
"face": "https://i2.hdslb.com/bfs/face/18c0bb87fbc8f9fde0d7f92ab88917e517e53df1.jpg",
"mid": "36708269",
"name": "alcoholmole"
},
{
"action": "赞了",
"attend": 0,
"desc": "",
"face": "https://i0.hdslb.com/bfs/face/39f0e0ec39e6828b01afc28ad001471d1efa8c66.jpg",
"mid": "52874964",
"name": "黑暗战师"
},
{
"action": "赞了",
"attend": 1,
"desc": "对方关注了你",
"face": "https://i0.hdslb.com/bfs/face/07d73f7d01c8e8cfb9173d8fe6e40a0c8cb5713d.jpg",
"mid": "702368712",
"name": "-御帝哥哥-"
},
{
"action": "赞了",
"attend": 0,
"desc": "共同关注了22个Up主",
"face": "http://i0.hdslb.com/bfs/face/member/noface.jpg",
"mid": "398095475",
"name": "meipeter"
},
{
"action": "赞了",
"attend": 0,
"desc": "",
"face": "https://i1.hdslb.com/bfs/face/a4a1566d7218307839345a079651bf58a69a028f.jpg",
"mid": "101358808",
"name": "香香软软的小阿芙"
}
],
"offset": "{\"page\":2,\"like\":101358808,\"repost\":-1}",
"total": 65
}
}
```
</details>
## 动态抽奖详情
> https://api.vc.bilibili.com/lottery_svr/v1/lottery_svr/lottery_notice
*请求方法: GET*
**URL参数:**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ----- | ---- | -------- | ------ | ---- |
| business_id | num | 动态 id | 必要 | |
| bussiness_type | num | 业务类型? | 必要 | 1: 动态抽奖 |
| csrf | str | CSRF Token (即 Cookie 中 bili_jct 字段) | 不必要 | |
| web_location | str | 333.1330 | 不必要 | |
<details>
<summary>旧版参数:</summary>
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ----- | ---- | -------- | ------ | ---- |
| dynamic_id | num | 动态 id | 必要 | |
</details>
**JSON回复:**
根对象:
| 字段名 | 类型 | 内容 | 备注 |
| - | - | - | - |
| code | num | 返回值 | 0: 成功<br />-9999: 服务系统错误 |
| message | str | 错误信息 | 无则为空串 |
| msg | str | 错误信息 | 无则为空串 |
| data | obj | 信息本体 | 错误时为空对象 |
`data`对象:
| 字段名 | 类型 | 内容 | 备注 |
| - | - | - | - |
| lottery_id | num | 抽奖 id | |
| sender_uid | num | 发送者 mid | |
| business_type | num | 业务类型 | 1: 动态抽奖 |
| business_id | num | 业务 id | 可能与请求参数不同 |
| status | num | 抽奖状态 | 0: 未开奖<br />2: 已开奖 |
| lottery_time | num | 开奖时间 | UNIX 秒级时间戳 |
| lottery_at_num | num | at 人数? | |
| lottery_feed_limit | num | 转发限制? | |
| need_post | num | 是否需要发布? | |
| pay_status | num | 支付状态? | |
| first_prize | num | 一等奖数量 | |
| second_prize | num | 二等奖数量 | |
| third_prize | num | 三等奖数量 | |
| ts | num | 发布时间 | UNIX 秒级时间戳 |
| participants | num | 参与人数 | |
| has_charge_right | bool | 是否有充值权? | |
| participated | bool | 是否参与过? | |
| followed | bool | 是否关注过 | |
| reposted | bool | 是否转发过 | |
| lottery_detail_url | str | 抽奖详情页 URL? | |
| first_prize_cmt | str | 一等奖奖品名称 | |
| third_prize_cmt | str | 三等奖奖品名称 | |
| first_prize_pic | str | 一等奖奖品图片 URL | |
| second_prize_pic | str | 二等奖奖品图片 URL | |
| third_prize_pic | str | 三等奖奖品图片 URL | |
| vip_batch_sign | str | ？ | |
| prize_type_first | obj | 一等奖奖品类型 | |
| prize_type_second | obj | 二等奖奖品类型 | 无则不存在 |
| prize_type_third | obj | 三等奖奖品类型 | 无则不存在 |
| lottery_result | obj | 抽奖结果 | 无则不存在 |
`data`对象中的`prize_type_first`对象:
| 字段名 | 类型 | 内容 | 备注 |
| - | - | - | - |
| type | num | 奖品类型? | 0 |
| value | obj | 奖品价值? | |
`prize_type_first`对象中的`value`对象:
| 字段名 | 类型 | 内容 | 备注 |
| - | - | - | - |
| stype | num | 子奖品类型? | 0 |
`data`对象中的`prize_type_second`对象:
与 `prize_type_first` 格式相同
`data`对象中的`prize_type_third`对象:
与 `prize_type_first` 格式相同
`data`对象中的`lottery_result`对象:
| 字段名 | 类型 | 内容 | 备注 |
| - | - | - | - |
| first_prize_result | array | 一等奖结果 | |
| second_prize_result | array | 二等奖结果 | 无则不存在 |
| third_prize_result | array | 三等奖结果 | 无则不存在 |
`lottery_result`对象中的`first_prize_result`数组:
| 项名 | 类型 | 内容 | 备注 |
| - | - | - | - |
| uid | num | 中奖者 mid | |
| name | str | 中奖者名称 | |
| face | str | 中奖者头像 URL | |
| hongbao_money | num | 奖品金额? | |
`lottery_result`对象中的`second_prize_result`数组:
与 `first_prize_result` 格式相同
`lottery_result`对象中的`third_prize_result`数组:
与 `first_prize_result` 格式相同
**示例:**
```shell
curl -G 'https://api.vc.bilibili.com/lottery_svr/v1/lottery_svr/lottery_notice' \
--url-query 'business_id=969916293954142214' \
--url-query 'business_type=1'
```
<details>
<summary>查看响应示例:</summary>
```json
{
"code": 0,
"data": {
"lottery_id": 314834,
"sender_uid": 36081646,
"business_type": 1,
"business_id": 969916293954142214,
"status": 2,
"lottery_time": 1724860800,
"lottery_at_num": 0,
"lottery_feed_limit": 1,
"need_post": 0,
"pay_status": 0,
"first_prize": 1,
"second_prize": 0,
"third_prize": 0,
"ts": 1724922650,
"participants": 9230,
"has_charge_right": false,
"participated": false,
"followed": false,
"reposted": false,
"lottery_detail_url": "",
"first_prize_cmt": "S档门票",
"third_prize_cmt": "",
"first_prize_pic": "",
"second_prize_pic": "",
"third_prize_pic": "",
"vip_batch_sign": "",
"prize_type_first": {
"type": 0,
"value": {
"stype": 0
}
},
"lottery_result": {
"first_prize_result": [
{
"uid": 1014634854,
"name": "lty世界第一吃货殿下",
"face": "https://i0.hdslb.com/bfs/face/c746083b15f6761ea75c602661123e68784c6b1c.jpg",
"hongbao_money": 0
}
]
}
},
"message": "",
"msg": ""
}
```
</details>