update【用户信息】【用户投稿视频】APIDoc

This commit is contained in:
SocialSisterYi
2023-05-26 12:13:49 +08:00
parent 8e2a4a9025
commit 252178292b
3 changed files with 511 additions and 426 deletions

View File

@@ -2624,12 +2624,12 @@ curl -L -X GET 'https://api.bilibili.com/x/space/like/video?vmid=15858903'
> https://api.bilibili.com/x/space/wbi/arc/search
> ~~https://api.bilibili.com/x/space/arc/search (旧 API现已不可用~~
PS旧 API 现已不可使用,活返回`code=-799`
*请求方式GET*
鉴权方式:[Wbi 签名](../misc/sign/wbi.md)
~~该接口的旧版 API https://api.bilibili.com/x/space/arc/search~~(已废弃,不建议使用)
**header字段**
必须要有 `user-agent`,且不能为 `空字符串`,以及含有 `python``node``curl` 等的字符串
@@ -2644,6 +2644,8 @@ PS旧 API 现已不可使用,活返回`code=-799`
| keyword | str | 关键词筛选 | 非必要 | 用于使用关键词搜索该UP主视频稿件 |
| pn | num | 页码 | 非必要 | |
| ps | num | 每页项数 | 非必要 | 最小 1最大 50默认 30 |
| w_rid | str | Wbi 签名 | 必要 | 详见 [Wbi 签名](../misc/sign/wbi.md) |
| wts | num | 当前时间戳 | 必要 | 详见 [Wbi 签名](../misc/sign/wbi.md) |
**json回复**
@@ -2651,28 +2653,29 @@ PS旧 API 现已不可使用,活返回`code=-799`
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0成功<br />-400请求错误<br />-412请求被拦截<br />-1200被降级过滤的请求(一种意义不明的偶发状况) |
| code | num | 返回值 | 0成功<br />-400请求错误<br />-403访问权限不足<br />-412请求被拦截<br />-1200被降级过滤的请求(一种意义不明的偶发状况) |
| message | str | 错误信息 | 默认为 0 |
| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data`对象:
| 字段 | 类型 | 内容 | 备注 |
|-----------------|------|----------|-----|
| list | obj | 列表信息 | |
| page | obj | 页面信息 | |
| episodic_button | obj | “播放全部“按钮 | |
| is_risk | bool | | |
| gaia_res_type | num | | |
| gaia_data | | | |
| 字段 | 类型 | 内容 | 备注 |
| --------------- | ---- | -------------- | ---- |
| list | obj | 列表信息 | |
| page | obj | 页面信息 | |
| episodic_button | obj | “播放全部“按钮 | |
| is_risk | bool | | |
| gaia_res_type | num | | |
| gaia_data | null | | |
`data`中的`list`对象:
| 字段 | 类型 | 内容 | 备注 |
|-------|-------|----------|-----|
| tlist | obj | 投稿视频分区索引 | |
| vlist | array | 投稿视频列表 | |
| 字段 | 类型 | 内容 | 备注 |
| ----- | ----- | ---------------- | ---- |
| tlist | obj | 投稿视频分区索引 | |
| vlist | array | 投稿视频列表 | |
| slist | array | | |
`list`中的`tlist`对象:
@@ -2701,30 +2704,31 @@ PS旧 API 现已不可使用,活返回`code=-799`
| 字段 | 类型 | 内容 | 备注 |
| ---------------- | ---- | -------------- | ------------------------------------------------------------ |
| aid | num | 稿件 avid | |
| author | str | 视频 UP 主 | 不一定为目标用户(合作视频) |
| bvid | str | 稿件 bvid | |
| comment | num | 视频评论数 | |
| copyright | str | 稿件类型 | 1原创<br />2转载 |
| created | num | 投稿时间 | 时间戳 |
| description | str | 视频简介 | |
| hide_click | bool | false | 作用尚不明确 |
| is_pay | num | 0 | 作用尚不明确 |
| is_union_video | num | 是否为合作视频 | 0<br />1是 |
| length | str | 视频长度 | MM:SS |
| mid | num | 视频 UP 主 mid | 不一定为目标用户(合作视频) |
| pic | str | 视频封面 | |
| play | num | 视频播放次数 | 如果视频基本信息API对应的状态为-403视频访问权限不足数据类型将变为str"play": "--",于mid79发表的av5132474可见 |
| review | num | 0 | 作用尚不明确 |
| subtitle | str | 空 | 作用尚不明确 |
| title | str | 视频标题 | |
| typeid | num | 视频分区 tid | |
| play | num | 视频播放次数 | 如果视频基本信息 API 对应的状态为 -403 视频访问权限不足数据类型将变为str"play": "--",),于 UID:79 发表的 av5132474 可见 |
| pic | str | 视频封面 | |
| subtitle | str | | |
| description | str | 视频简介 | |
| copyright | str | 稿件类型 | 1原创<br />2转载 |
| title | str | 视频标题 | |
| review | num | ? | |
| author | str | 视频 UP 主 | 不一定为目标用户(合作视频) |
| mid | num | 视频 UP 主 mid | 不一定为目标用户(合作视频) |
| created | num | 投稿时间 | 秒时间戳 |
| length | str | 视频长度 | MM:SS |
| video_review | num | 视频弹幕数 | |
| is_steins_gate | num | 0 | |
| is_live_playback | num | 0 | |
| meta | | | |
| is_avoided | num | 0 | |
| attribute | num | 0 | |
| aid | num | 稿件 avid | |
| bvid | str | 稿件 bvid | |
| hide_click | bool | | |
| is_pay | num | | |
| is_union_video | num | 是否为合作视频 | 0<br />1 |
| is_steins_gate | num | | |
| is_live_playback | num | 是否直播回放 | 0<br />1是 |
| meta | null | | |
| is_avoided | num | | |
| attribute | num | | |
| is_charging_arc | bool | | |
`data`中的`page`对象:
@@ -2745,13 +2749,17 @@ PS旧 API 现已不可使用,活返回`code=-799`
`pn`(页码)和`ps`(每页项数)只改变`vlist`中成员的多少与内容
以每页2项查询用户`mid=53456`的第1页投稿视频明细
以每页 5 项查询用户`mid=53456`的第 1 页投稿视频明细
Wbi 签名的 `wts``w_rid`生成方式详见 [Wbi 签名](../misc/sign/wbi.md) 文档
```shell
curl -G 'https://api.bilibili.com/x/space/wbi/arc/search' \
--data-urlencode 'mid=53456' \
--data-urlencode 'ps=2' \
--data-urlencode 'pn=1'
--data-urlencode 'ps=5' \
--data-urlencode 'pn=1' \
--data-urlencode 'wts=1685073645' \
--data-urlencode 'w_rid=2e49b69235fb3ea9340422ac9382cbc2'
```
<details>
@@ -2759,116 +2767,225 @@ curl -G 'https://api.bilibili.com/x/space/wbi/arc/search' \
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"list": {
"tlist": {
"1": {
"tid": 1,
"count": 41,
"name": "动画"
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"list": {
"tlist": {
"1": {
"tid": 1,
"count": 42,
"name": "动画"
},
"3": {
"tid": 3,
"count": 36,
"name": "音乐"
},
"4": {
"tid": 4,
"count": 85,
"name": "游戏"
},
"36": {
"tid": 36,
"count": 1,
"name": "知识"
},
"160": {
"tid": 160,
"count": 51,
"name": "生活"
},
"211": {
"tid": 211,
"count": 3,
"name": "美食"
},
"217": {
"tid": 217,
"count": 2,
"name": "动物圈"
}
},
"vlist": [
{
"comment": 2727,
"typeid": 17,
"play": 1379744,
"pic": "http://i0.hdslb.com/bfs/archive/d8745a327c56a1d8862054bf88ed1cd3d4cd2a0f.jpg",
"subtitle": "",
"description": "游戏:《塞尔达传说:王国之泪》\n真好玩一口气玩了五天到处游山玩水都没怎么顾得上推主线哈哈哈虽然没能造出高达来但胡乱折腾也很开心啦\n我的微博_warma_",
"copyright": "1",
"title": "【warma】我玩游戏太菜不要笑我",
"review": 0,
"author": "Warma",
"mid": 53456,
"created": 1684468800,
"length": "27:53",
"video_review": 7538,
"aid": 741294090,
"bvid": "BV1dk4y1L77W",
"hide_click": false,
"is_pay": 0,
"is_union_video": 0,
"is_steins_gate": 0,
"is_live_playback": 0,
"meta": null,
"is_avoided": 0,
"attribute": 0,
"is_charging_arc": false
},
{
"comment": 2959,
"typeid": 172,
"play": 1601320,
"pic": "http://i2.hdslb.com/bfs/archive/5bc6b4b78787508fec6e5545313a5aac49b420ab.jpg",
"subtitle": "",
"description": "来继续更新我的光遇之旅啦~这次也录到了好几个交到新朋友的瞬间了哈哈哈,每次被陌生人夸的时候都感觉特别不好意思但是又好开心!喜欢这里慢悠悠的氛围~最近夜行季也上线了,来欣赏美丽的月食吧!\n祝大家看得开心啦",
"copyright": "1",
"title": "【warma】这里的陌生人都热情过头了啊啊啊",
"review": 0,
"author": "Warma",
"mid": 53456,
"created": 1683434541,
"length": "21:56",
"video_review": 2552,
"aid": 570782455,
"bvid": "BV12z4y1h72d",
"hide_click": false,
"is_pay": 0,
"is_union_video": 0,
"is_steins_gate": 0,
"is_live_playback": 0,
"meta": null,
"is_avoided": 0,
"attribute": 0,
"is_charging_arc": false
},
{
"comment": 6844,
"typeid": 21,
"play": 3898109,
"pic": "http://i0.hdslb.com/bfs/archive/733239b86fe15c5f07d15872a955e1819dcc1f31.jpg",
"subtitle": "",
"description": "我想试着练习写一本从构思、正文、插画、排版到封面设计全都由自己来完成的书!\n\n虽然这本书未来还不确定但是我尽力啦~大家如果觉得有哪里做得还不够好请指出来告诉我吧,我还有很多很多需要学习的地方,请大家多多指教啦!\n如果有出版社的编辑老师正在观看此视频的话请老师们多多指教希望能够和老师们取得联系chickenfish@vip.qq.com\n\n电子书文件发在评论区啦~",
"copyright": "1",
"title": "【warma】我要写书啦",
"review": 0,
"author": "Warma",
"mid": 53456,
"created": 1680840000,
"length": "21:55",
"video_review": 15975,
"aid": 909664793,
"bvid": "BV1oM4y1y7Q4",
"hide_click": false,
"is_pay": 0,
"is_union_video": 0,
"is_steins_gate": 0,
"is_live_playback": 0,
"meta": null,
"is_avoided": 0,
"attribute": 0,
"is_charging_arc": false
},
{
"comment": 2030,
"typeid": 17,
"play": 2272296,
"pic": "http://i0.hdslb.com/bfs/archive/d0d12a011d2a3799a77fa84372372581abdc917c.jpg",
"subtitle": "",
"description": "玩到尽兴为止!\n\n录制/视频制作warma\n录制/插画:怒九",
"copyright": "1",
"title": "【warma/怒九】陪我打游戏!(胁迫)",
"review": 0,
"author": "Warma",
"mid": 53456,
"created": 1677816000,
"length": "36:42",
"video_review": 9902,
"aid": 482867257,
"bvid": "BV1XT411v76Y",
"hide_click": false,
"is_pay": 0,
"is_union_video": 1,
"is_steins_gate": 0,
"is_live_playback": 0,
"meta": null,
"is_avoided": 0,
"attribute": 0,
"is_charging_arc": false
},
{
"comment": 12666,
"typeid": 21,
"play": 1892762,
"pic": "http://i0.hdslb.com/bfs/archive/5e712811e893886fb0535a95e1609cb3ba307a39.jpg",
"subtitle": "",
"description": "你好~这是我的一期电台节目,现在也已经是第十一期啦,但是即便没看过前面几期也不会影响观看,因为这是个什么都聊聊看的日常电台嘛~\n \n这期电台内容非常友好、令人安心只是偶尔有点“问题”但好在目前还是处于能安全观看的水平请来看看吧。\n \n录音/视频制作warma\n我的微博_warma_\n \n背景插画认知Renz\n发光粒子素材K_Lacid \n【视频某处的曲子的staff】\n翻唱Warma\n曲绘不鱼\nPV祈凉_&兽人苦工\n后期白萝卜音乐工作室\n \n感谢以上老师的帮助~",
"copyright": "1",
"title": "【warma爆炸电台】曾经性格阴沉的我正在分享创作心得与日常【第十一期】",
"review": 0,
"author": "Warma",
"mid": 53456,
"created": 1674964800,
"length": "77:24",
"video_review": 68240,
"aid": 990909915,
"bvid": "BV1Ex4y177xd",
"hide_click": false,
"is_pay": 0,
"is_union_video": 0,
"is_steins_gate": 0,
"is_live_playback": 0,
"meta": {
"id": 149941,
"title": "爆炸电台",
"cover": "https://archive.biliimg.com/bfs/archive/b833b4299b3f4252ebe4d2902421aa25ba9e7ccc.jpg",
"mid": 53456,
"intro": "你好!这是我的电台节目《爆炸电台》,这是个什么都聊聊看的日常电台,内容是纯音频的,所以看不看画面都没问题~\n电台的时间比较长可以拿点零食饮料或者放在一旁慢慢听什么的都很合适~\n祝观看愉快~",
"sign_state": 0,
"attribute": 140,
"stat": {
"season_id": 149941,
"view": 11824985,
"danmaku": 363116,
"reply": 50348,
"favorite": 343639,
"coin": 665105,
"share": 50804,
"like": 1013864,
"mtime": 1685073652,
"vt": 71631635,
"vv": 0
},
"ep_count": 10,
"first_aid": 990909915,
"ptime": 1674964800,
"ep_num": 0
},
"is_avoided": 0,
"attribute": 0,
"is_charging_arc": false
}
],
"slist": []
},
"3": {
"tid": 3,
"count": 36,
"name": "音乐"
"page": {
"pn": 1,
"ps": 5,
"count": 220
},
"4": {
"tid": 4,
"count": 82,
"name": "游戏"
"episodic_button": {
"text": "播放全部",
"uri": "//www.bilibili.com/medialist/play/53456?from=space"
},
"36": {
"tid": 36,
"count": 1,
"name": "知识"
},
"160": {
"tid": 160,
"count": 49,
"name": "生活"
},
"211": {
"tid": 211,
"count": 3,
"name": "美食"
},
"217": {
"tid": 217,
"count": 2,
"name": "动物圈"
}
},
"vlist": [
{
"comment": 6729,
"typeid": 172,
"play": 2171260,
"pic": "http://i2.hdslb.com/bfs/archive/9fe04c2acb6678c9a8d1547db211e458ea70982c.jpg",
"subtitle": "",
"description": "好开心能和几千人一起看音乐会!真的震撼到我了,它给我带来的冲击感远超出了我的想象……光遇这场音乐会会一直持续到元旦哦,大家感兴趣的话也可以来试试吧~\n祝看得开心啦",
"copyright": "1",
"title": "【warma】我尝试学习交朋友",
"review": 0,
"author": "Warma",
"mid": 53456,
"created": 1671163200,
"length": "23:58",
"video_review": 7931,
"aid": 433873134,
"bvid": "BV1nG411P7hf",
"hide_click": false,
"is_pay": 0,
"is_union_video": 0,
"is_steins_gate": 0,
"is_live_playback": 0,
"meta": null,
"is_avoided": 0,
"attribute": 0
},
{
"comment": 3380,
"typeid": 31,
"play": 811600,
"pic": "http://i2.hdslb.com/bfs/archive/7e6c6ec32a0db8684abd660d599644e9d1c43ee4.jpg",
"subtitle": "",
"description": "原曲BV1iR4y1X7V9\n这首歌是今年生日的时候收到的礼物真的太好听了我也想翻唱试试~\n在翻唱中录了一些不一样的小音效比如卡祖笛和竖笛还录了些小配音……大家来听听看\n谢谢原曲staff老师们做出这么有趣的作品谢谢在这次翻唱中staff老师们的帮助PV老师甚至根据翻唱版本把曲子的PV做了些修改加了好多小细节真的超用心\n祝听得开心啦~\n \n【staff表】\n原曲staff详见BV1iR4y1X7V9\n翻唱warma\n混音白萝卜音乐工作室\nPV修改@颜一bot \n封面是根",
"copyright": "1",
"title": "【warma】来唱大家送我的歌《夏天幻游日记》",
"review": 0,
"author": "Warma",
"mid": 53456,
"created": 1670558400,
"length": "02:59",
"video_review": 2343,
"aid": 733323002,
"bvid": "BV18D4y1Y7o6",
"hide_click": false,
"is_pay": 0,
"is_union_video": 0,
"is_steins_gate": 0,
"is_live_playback": 0,
"meta": null,
"is_avoided": 0,
"attribute": 0
}
]
},
"page": {
"pn": 1,
"ps": 2,
"count": 214
},
"episodic_button": {
"text": "播放全部",
"uri": "//www.bilibili.com/medialist/play/53456?from=space"
},
"is_risk": false,
"gaia_res_type": 0,
"gaia_data": null
}
"is_risk": false,
"gaia_res_type": 0,
"gaia_data": null
}
}
```