返回提交历史
Modified
bangumi/info.md
+143
-74
XFEstudio/bilibili-API-collect
修改剧集基本信息
f44fd54
代码差异
1 个文件
+143
-74
@@ -1,15 +1,151 @@
1
# 番剧基本信息
1
# 剧集基本信息
2
3
## 剧集基本信息（mdID方式）
4
5
6
> http://api.bilibili.com/pgc/review/user
7
8
*请求方式：GET*
9
10
鉴权方式：Cookie（SESSDATA）或APP
11
12
**url参数：**
13
14
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
15
| -------- | ---- | -------- | ------ | ---- |
16
| media_id | str | 剧集mdID | 必要 | |
17
18
**json回复：**
19
20
根对象：
21
22
| 字段 | 类型 | 内容 | 备注 |
23
| ------- | ---- | -------- | ------------------------------------------- |
24
| code | num | 返回值 | 0：成功<br />-400：请求错误<br />-404：错误 |
25
| message | str | 错误信息 | 默认为success |
26
| result | obj | 信息本体 | |
27
28
`result`对象：
29
30
| 字段 | 类型 | 内容 | 备注 |
31
| ------ | ---- | ------------ | ---------------- |
32
| media | obj | 剧集信息 | |
33
| review | obj | 用户操作信息 | 仅登录时存在此项 |
34
35
`result`中的`media`对象：
36
37
| 字段 | 类型 | 内容 | 备注 |
38
| --------- | ----- | -------------- | -------------------------- |
39
| areas | array | 地区 | |
40
| cover | str | 封面图片url | |
41
| media_id | num | 剧集mdID | |
42
| new_ep | obj | 最新一话信息 | |
43
| rating | obj | 评分信息 | |
44
| season_id | int | 剧集ssID | |
45
| share_url | url | 剧集详情页连接 | |
46
| title | str | 标题 | |
47
| type_name | str | 剧集类型 | `番剧`、`国创`、`电影`等等 |
48
49
`media`中的`areas`数组：
50
51
| 项 | 类型 | 内容 | 备注 |
52
| ---- | ---- | --------------- | ---- |
53
| 0 | obj | 地区信息1 | |
54
| n | obj | 地区信息（n+1） | |
55
| …… | obj | …… | |
56
57
`areas`数组中的对象：
58
59
| 字段 | 类型 | 内容 | 备注 |
60
| ---- | ---- | ------------ | ------------------------------------------------------------ |
61
| id | num | 所属地区编号 | 1：中国大陆<br />2：日本<br />3：美国<br />4：英国<br />6：中国香港<br />8：韩国<br />9：法国<br />10：泰国<br />13：西班牙<br />15：德国<br />35：意大利<br />39：新西兰<br />43：澳大利亚 |
62
| name | str | 所属地区名称 | |
63
64
`media`中的`new_ep`对象：
65
66
| 字段 | 类型 | 内容 | 备注 |
67
| ---------- | ---- | ---------------- | -------------------------- |
68
| id | int | 最新一话的epID | |
69
| index | str | 最新一话名称 | |
70
| index_show | str | 最新一话显示名称 | eg. `第1话`、`更新至第4话` |
71
72
`media`中的`rating`对象：
73
74
| 字段 | 类型 | 内容 | 备注 |
75
| ----- | ---- | ------------ | ---- |
76
| count | num | 总计评分人数 | |
77
| score | num | 评分 | |
78
79
`result`中的`review`对象：
80
81
| 字段 | 类型 | 内容 | 备注 |
82
| ------- | ---- | ---- | ------------ |
83
| is_coin | num | 0 | 作用尚不明确 |
84
| is_open | num | 1 | 作用尚不明确 |
85
86
**示例：**
87
88
查询剧集`md28220978`的基本信息
89
90
```shell
91
curl -G 'http://api.bilibili.com/pgc/review/user' \
92
--data-urlencode 'media_id=28220978' \
93
-b 'SESSDATA=xxx'
94
```
95
96
<details>
97
<summary>查看响应示例：</summary>
98
99
```json
100
{
101
"code": 0,
102
"message": "success",
103
"result": {
104
"media": {
105
"areas": [
106
{
107
"id": 2,
108
"name": "日本"
109
}
110
],
111
"cover": "http://i0.hdslb.com/bfs/bangumi/8aa0bfce050c72c6626b63d3093a88527c251026.jpg",
112
"media_id": 28220978,
113
"new_ep": {
114
"id": 21278,
115
"index": "14",
116
"index_show": "全14话"
117
},
118
"rating": {
119
"count": 53376,
120
"score": 9.9
121
},
122
"season_id": 1172,
123
"share_url": "https://www.bilibili.com/bangumi/media/md28220978",
124
"title": "轻音少女 第一季",
125
"type_name": "番剧"
126
},
127
"review": {
128
"is_coin": 0,
129
"is_open": 1
130
}
131
}
132
}
133
```
134
135
</details>
136
137
## 获取剧集明细（web端）（ssID/epID方式）
2
138
3
139
> http://api.bilibili.com/pgc/view/web/season
4
140
5
141
*请求方式：GET*
6
142
7
**参数：**
143
**url参数：**
8
144
9
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
10
| --------- | ---- | -------- | ------ | ------------------------ |
11
| season_id | url | 番剧ssID | 非必要 | season_id与ep_id任选其一 |
12
| ep_id | url | 剧集epID | 非必要 | season_id与ep_id任选其一 |
145
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
146
| --------- | ---- | -------- | ------------ | ------------------------ |
147
| season_id | num | 番剧ssID | 必要（可选） | season_id与ep_id任选其一 |
148
| ep_id | num | 剧集epID | 必要（可选） | season_id与ep_id任选其一 |
13
149
14
150
**json回复：**
15
151
@@ -278,71 +414,4 @@
278
414
| vip_status | num | | |
279
415
| vip_type | num | | |
280
416
281
> http://api.bilibili.com/pgc/review/user
282
283
*请求方式：GET*
284
285
**参数：**
286
287
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
288
| --------- | ---- | -------- | ------ | ---- |
289
| media_id | url | 番剧mID | 必要 | |
290
291
**json回复：**
292
293
根对象：
294
295
| 字段 | 类型 | 内容 | 备注 |
296
| ------- | ---- | -------- | ----------------------- |
297
| code | num | 返回值 | 0：成功<br />-404：错误 |
298
| message | str | 错误信息 | 默认为success |
299
| result | obj | 信息本体 | |
300
301
`result`对象：
302
303
| 字段 | 类型 | 内容 | 备注 |
304
| ----- | ---- | -------- | ---- |
305
| media | obj | 番剧信息 | |
306
307
`result`中的`media`对象：
308
309
| 字段 | 类型 | 内容 | 备注 |
310
| --------- | ------ | ---------- | ------------------------- |
311
| areas | array | 地区 | |
312
| cover | url | 封面 | |
313
| media_id | int | 番剧mID | |
314
| new_ep | obj | 最新一话 | |
315
| rating | obj | 评分 | |
316
| season_id | int | 番剧ssID | |
317
| share_url | url | 分享链接 | |
318
| title | str | 标题 | |
319
| type_name | str | "番剧" | 还有其他什么用这个api吗？ |
320
321
`media`中的`areas`数组：
322
323
| 项 | 类型 | 内容 | 备注 |
324
| ---- | ---- | -------- | ---------------------- |
325
| 0 | obj | 地区信息 | |
326
| …… | obj | | 暂时没有看到有第二项的 |
327
328
`areas`数组中的对象：
329
330
| 字段 | 类型 | 内容 | 备注 |
331
| ---- | ---- | -------- | ------------ |
332
| id | int | 2 | 作用暂不明确 |
333
| name | str | 番剧地区 | |
334
335
`media`中的`new_ep`对象：
336
337
| 字段 | 类型 | 内容 | 备注 |
338
| ---------- | ---- | -------------------------- | ---------------------- |
339
| id | int | 最新一话的epID | |
340
| index | str | 这一话是第几话 | |
341
| index_show | str | 该怎么显示最新一话的字符串 | e.g. "第1话"、"全12话" |
342
343
`media`中的`rating`对象：
344
345
| 字段 | 类型 | 内容 | 备注 |
346
| ----- | ----- | -------- | ---- |
347
| count | int | 评分总数 | |
348
| score | float | 评分 | |
417
##