返回提交历史
Modified
README.md
+1
-0
Added
docs/article/view.md
+306
-0
XFEstudio/bilibili-API-collect
feat(article/view.md): view from cv1
6ae71c4
代码差异
2 个文件
+307
-0
@@ -154,6 +154,7 @@ B站 API 采用 C/S 结构，大多数接口为 REST API 和 gRPC，少部分接
154
154
- [x] [笔记详细信息](docs/note/info.md)
155
155
- [x] [笔记操作](docs/note/action.md)
156
156
- [ ] [专栏](docs/article)
157
- [ ] [专栏内容](docs/article/view.md)
157
158
- [ ] [专栏分类](docs/article/category.md)
158
159
- [X] [基本信息](docs/article/info.md)
159
160
- [X] [点赞 & 投币 & 收藏 & 分享](docs/article/action.md)
@@ -0,0 +1,306 @@
1
# 专栏内容
2
3
## 获取专栏正文内容
4
5
> https://api.bilibili.com/x/article/view
6
7
*请求方法: GET*
8
9
**URL 参数:**
10
11
| 参数 | 类型 | 内容 | 必要性 | 备注 |
12
| ----- | ------ | ----------- | ------ | ---- |
13
| id | number | 专栏文章 ID | 必要 | |
14
| gaia_source | string | `main_web` | 不必要 | |
15
| w_rid | string | WBI 签名 | 不必要 | 参见 [WBI 签名](../misc/sign/wbi.md) |
16
| wts | number | UNIX 秒级时间戳 | 不必要 | 参见 [WBI 签名](../misc/sign/wbi.md) |
17
18
**JSON 回复:**
19
20
根对象:
21
22
| 字段 | 类型 | 内容 | 备注 |
23
| ---- | ---- | ---- | ---- |
24
| code | number | 返回值 | 0: 成功<br />-352: 请求被风控<br />-400: 请求错误<br />-404: 啥都木有 |
25
| data | object | 数据本体 | 见下 |
26
| message | string | 错误信息 | 成功时为 `0` |
27
| ttl | number | `1` | |
28
29
`data` 对象:
30
31
| 字段 | 类型 | 内容 | 备注 |
32
| ---- | ---- | ---- | ---- |
33
| act_id | number | 操作 ID? | |
34
| apply_time | string | 应用时间? | |
35
| attributes | number | 属性位? | |
36
| authenMark | null | 授权码? | |
37
| author | object | 作者信息 | 参考 [用户基本信息](../user/info.md) |
38
| banner_url | string | 文章头图 URL | |
39
| categories | object[] | 专栏分类信息 | 首项为主分区, 第二项为子分区 |
40
| category | object | 专栏分类信息 | 子分区 |
41
| check_state | number | 检查状态? | |
42
| check_time | string | 检查时间? | |
43
| content | string | 文章内容 | 可能为 JSON , 也可能为 HTML |
44
| content_pic_list | unknown | 内容图片列表? | |
45
| cover_avid | number | 封面视频 AV 号 | `0` 为无视频 |
46
| ctime | number | 创建时间 | UNIX 秒级时间戳 |
47
| dispute | unknown | 争议信息? | |
48
| dyn_id_str | string | 动态 upos id | |
49
| dynamic | string | 动态信息? | 可能不存在 |
50
| id | number | 专栏文章 ID | |
51
| image_urls | string[] | 图片 URL | |
52
| is_like | boolean | 是否喜欢? | |
53
| keywords | string | 关键词 | 以 `,` 分隔 |
54
| list | object | 文集信息 | 见下 |
55
| media | object | 媒体信息? | |
56
| mtime | number | 修改时间 | UNIX 秒级时间戳 |
57
| origin_image_urls | string[] | 原始图片 URL | |
58
| origin_template_id | number | 原始模板 ID? | |
59
| original | number | 是否原创 | 0: 非原创<br />1: 原创 |
60
| private_pub | number | 仅自己可见 | |
61
| publish_time | number | 发布时间 | UNIX 秒级时间戳 |
62
| reprint | number | 是否允许转载 | 0: 不允许<br />1: 允许规范转载 |
63
| state | number | 专栏状态 | |
64
| stats | object | 统计数据 | |
65
| summary | string | 专栏开头部分内容 | |
66
| tags | object[] | 专栏标签 | |
67
| template_id | number | 模板 ID? | |
68
| title | string | 专栏标题 | |
69
| top_video_info | unknown | 封面食品信息? | |
70
| total_art_num | number | 作者总文章数 | |
71
| type | number | 类型? | |
72
| upos | object | upos 信息 | 部分无该字段 |
73
| version_id | number | 版本 ID? | |
74
| words | number | 文章总词数 | |
75
76
`data.categories[]` 对象:
77
78
另见 [专栏分类](category.md)
79
80
| 字段 | 类型 | 内容 | 备注 |
81
| ---- | ---- | ---- | ---- |
82
| id | number | 分类 ID | |
83
| name | string | 分类名称 | |
84
| parent_id | number | 父分类 ID | |
85
86
`data.category` 对象:
87
88
同 `data.categories[]` 中的对象
89
90
`data.list` 对象:
91
92
| 字段 | 类型 | 内容 | 备注 |
93
| ---- | ---- | ---- | ---- |
94
| apply_time | string | 空 | |
95
| articles_count | number | 0 | |
96
| check_time | string | 空 | |
97
| ctime | number | 创建时间 | UNIX 秒级时间戳 |
98
| id | number | 文集 ID | |
99
| image_url | string | 文集封面 URL | |
100
| mid | number | 作者 mid | |
101
| name | string | 文集名称 | |
102
| publish_time | number | 最新发布时间 | UNIX 秒级时间戳 |
103
| read | number | 0 | |
104
| reason | string | 审核不通过理由? | |
105
| state | number | 文集状态 | |
106
| summary | string | 文集描述 | |
107
| update_time | number | 文集更新时间 | UNIX 秒级时间戳 |
108
| words | number | 文集总词数 | |
109
110
`data.media` 对象:
111
112
| 字段 | 类型 | 内容 | 备注 |
113
| ---- | ---- | ---- | ---- |
114
| area | string | | |
115
| cover | string | | |
116
| media_id | number | | |
117
| score | number | | |
118
| season_id | number | | |
119
| spoiler | number | | |
120
| title | string | | |
121
| type_id | number | | |
122
| type_name | string | | |
123
124
`data.stats` 对象:
125
126
| 字段 | 类型 | 内容 | 备注 |
127
| ---- | ---- | ---- | ---- |
128
| coin | number | 硬币数 | |
129
| dislike | number | 点踩数 | 0 |
130
| dynamic | number | 动态数? | |
131
| favorite | number | 收藏数 | |
132
| like | number | 点赞数 | |
133
| reply | number | 回复数 | |
134
| share | number | 分享数 | |
135
| view | number | 查看数 | |
136
137
`data.tags[]` 对象:
138
139
| 字段 | 类型 | 内容 | 备注 |
140
| ---- | ---- | ---- | ---- |
141
| name | string | 标签名 | |
142
| tid | number | 标签 ID | |
143
144
**示例:**
145
146
`cv1` 未知的光
147
148
```shell
149
curl -G 'https://api.bilibili.com/x/article/view' \
150
--url-query 'id=1' \
151
-A 'Mozilla/5.0'
152
```
153
154
<details>
155
<summary>查看响应示例:</summary>
156
157
```json
158
{
159
"code": 0,
160
"data": {
161
"act_id": 0,
162
"apply_time": "",
163
"attributes": 24,
164
"authenMark": null,
165
"author": {
166
"face": "https://i1.hdslb.com/bfs/face/89fe260a17891fdadc3365a9698fee52796c7765.jpg",
167
"fans": 3051,
168
"level": 6,
169
"mid": 91221505,
170
"name": "健行见远渐忘",
171
"nameplate": {
172
"condition": "2018.6.26-7.8某一天是年度大会员",
173
"image": "https://i0.hdslb.com/bfs/face/421179426c929dfeaed4117461c83f5d07ffb148.png",
174
"image_small": "https://i0.hdslb.com/bfs/face/682001c2e1c2ae887bdf2a0e18eef61180c48f84.png",
175
"level": "稀有勋章",
176
"name": "大会员2018年度勋章",
177
"nid": 74
178
},
179
"official_verify": {
180
"desc": "",
181
"type": -1
182
},
183
"pendant": {
184
"expire": 0,
185
"image": "https://i1.hdslb.com/bfs/face/7ae15f06f8c912435206a2578509d6bc77c12353.png",
186
"name": "作文鬼才",
187
"pid": 255
188
},
189
"vip": {
190
"avatar_subscript": 1,
191
"due_date": 0,
192
"label": {
193
"label_theme": "annual_vip",
194
"path": "http://i0.hdslb.com/bfs/vip/label_annual.png",
195
"text": "年度大会员"
196
},
197
"nickname_color": "#FB7299",
198
"status": 1,
199
"theme_type": 0,
200
"type": 2,
201
"vip_pay_type": 0
202
}
203
},
204
"banner_url": "https://i0.hdslb.com/bfs/article/b1e1029c08d8ad1bb06460d736839a7741dd7925.jpg",
205
"categories": [
206
{
207
"id": 3,
208
"name": "生活",
209
"parent_id": 0
210
},
211
{
212
"id": 15,
213
"name": "日常",
214
"parent_id": 3
215
}
216
],
217
"category": {
218
"id": 15,
219
"name": "日常",
220
"parent_id": 3
221
},
222
"check_state": 0,
223
"check_time": "",
224
"content": "<p>天空像是倾倒出的墨水，黑得静谧而深邃。黎明还远，光亮全无。</p><p>夜不能寐。披衣，起床。茶香的弥漫，一盏灯的相伴。夜，你是我久别重逢的朋友，那一刹那的相见，带给了我久违的安思。如果不是梦魇的皮闹，我本不该投入你的怀抱，此时此刻，万念侵扰，思绪咆哮。</p><p>台灯在角落里静静注视着我，不稳定的电流偶尔会吱吱作响。一切都像打在海绵上的水，渐渐消失，慢慢隐身于黑夜，独独留下我自己。一盏灯就可以把夜撕出个伤口，我似乎听到夜逃离光亮的脚步声，窸窸窣窣。它在蔓延，吞噬的野心已越过了窗沿。</p><p>我捧着茶杯，仿佛是在捧着一整个空间，凝重而诡异。茶香绕过茶杯脱落的瓷层向四周扩散，空气闻到了茶香，于是身边的气息似乎活跃了起来。转念一想，人生如茶。器皿的束缚不是茶香的归宿，所以人生的低谷也不是生命的全部。黑暗是光明的束缚，但光明却是黑暗的归宿。</p><p>灯光下，书架上一本金色题字的书的书名熠熠发光，我起身取下书，发现是海伦写的《假如给我三天光明》，我内心一热，忽然间有些感动。一个身体残疾的孩子，孱弱的身躯却支撑起了刚劲的灵魂。她的眼前一片漆黑，但内心世界却是光彩艳丽的。她的心中永远都有一抹无形的光，指引着她踏遍人生的路途。</p><p>时钟告诉我现在是凌晨四点。我舒展下筋骨，刚要起身，一只飞虫不偏不斜恰好闯入我的视线。灯光是它唯一的追寻。我不敢有任何的动作，只好也只能静静看着这只可爱的生灵。它好像不知道我是它的伙伴，也许它真的以为光亮是它唯一的追寻。但是我却欣慰于这突如其来的伙伴。光明可以带来很多东西，有时候也包括一份黑暗中的灵魂的一份安慰。我不忍打扰它与光明的约会，于是悄悄起身慢慢摸索着到了阳台。</p><p>阳台和我沉入了外面黑暗的梦乡。隐约可以听到一些不知名的昆虫在开着它们的舞会，我猜它们都端着无形的酒杯。它们在黑暗中买醉，因为明天的天明将是它们的散会。我有些感怀，也有些悲哀。</p><p>夜风股股咆哮着，我昂首顶住风头，仰望着漆黑的四周。很远很远处，灯塔若隐若现。它向来就是一头巨大的野兽，而此时它却空荡的像杯将尽的酒。它散发出柔弱的灯光在风中摇曳，忽明忽暗，像是一场与黑暗的决斗，随时都可能葬身在这黎明的前奏。</p><p>不忍心这惨烈的一幕，我踱步来到窗前。窗子很旧了，旧到已经无法再承受住时间的践踏了。可无论它多么陈旧，此时的它是神奇的——窗外黑暗窗内光。人心不也是一扇窗户吗？一半明媚一半伤。窗户把光亮的一面给了光明，人心是不是也应该把明媚的一半朝向世界呢？</p><p>屋内的灯倏忽闪了闪，我晃过神来，发现天边已经有抹淡红色了。黎明的脚步已经迈出了一半。那只与台灯约会的虫子似乎很满意，兴高采烈的向着呼之欲出的朝阳的方向窜去了。我望着它的背影，轻轻挥了挥手，心中暗念：“亲爱的朋友，恭喜你找到了属于自己的方向和追求，希望你能在光和热中接受生命的升华。”</p><p>天空见亮了，有点空灵，光晕中泛着感动。第一缕曙光穿透了云层，是的，我看到了，那一抹光，越来越近，越来越亮……</p>",
225
"content_pic_list": null,
226
"cover_avid": 0,
227
"ctime": 1497973729,
228
"dispute": null,
229
"dyn_id_str": "38554821905721204",
230
"dynamic": "It's now or never !",
231
"id": 1,
232
"image_urls": [
233
"https://i0.hdslb.com/bfs/article/d2eedf1fd338bceca10099e2f7b33fa9017c859b.jpg"
234
],
235
"is_like": false,
236
"keywords": "天空像是倾倒出的墨水，黑得静谧而深邃。黎明还远，光亮全无。夜不能寐。披衣，起床。茶香的弥漫，一盏灯的相伴。夜，你是我久别重逢的朋友，那一刹那的相见，带给了我久违的安思。如果不是梦魇的皮闹，我本不该投入",
237
"list": {
238
"apply_time": "",
239
"articles_count": 0,
240
"check_time": "",
241
"ctime": 1588601669,
242
"id": 253534,
243
"image_url": "",
244
"mid": 91221505,
245
"name": "静夜思",
246
"publish_time": 1625900652,
247
"read": 0,
248
"reason": "",
249
"state": 1,
250
"summary": "",
251
"update_time": 1625900518,
252
"words": 3059
253
},
254
"media": {
255
"area": "",
256
"cover": "",
257
"media_id": 0,
258
"score": 0,
259
"season_id": 0,
260
"spoiler": 0,
261
"title": "",
262
"type_id": 0,
263
"type_name": ""
264
},
265
"mtime": 1589209079,
266
"origin_image_urls": [
267
"https://i0.hdslb.com/bfs/article/b1e1029c08d8ad1bb06460d736839a7741dd7925.jpg"
268
],
269
"origin_template_id": 4,
270
"original": 0,
271
"private_pub": 0,
272
"publish_time": 1519913233,
273
"reprint": 0,
274
"state": 0,
275
"stats": {
276
"coin": 2543,
277
"dislike": 1,
278
"dynamic": 0,
279
"favorite": 17520,
280
"like": 32484,
281
"reply": 14399,
282
"share": 616,
283
"view": 1631212
284
},
285
"summary": "天空像是倾倒出的墨水，黑得静谧而深邃。黎明还远，光亮全无。夜不能寐。披衣，起床。茶香的弥漫，一盏灯的相伴。夜，你是我久别重逢的朋友，那一刹那的相见，带给了我久违的安思。如果不是梦魇的皮闹，我本不该投入",
286
"tags": [
287
{
288
"name": "静夜思",
289
"tid": 239416
290
}
291
],
292
"template_id": 4,
293
"title": "未知的光",
294
"top_video_info": null,
295
"total_art_num": 5,
296
"type": 0,
297
"version_id": 0,
298
"words": 1190
299
},
300
"message": "0",
301
"ttl": 1
302
}
303
```
304
</details>
305
306
<!-- Generated by json-apidoc-gen @ 2025-04-22T16:42:30.354080534Z -->