返回提交历史
Modified
docs/user/space.md
+296
-0
XFEstudio/bilibili-API-collect
增加了无需wbi鉴权的用户投稿明细查询接口
49247a3
代码差异
1 个文件
+296
-0
@@ -2778,6 +2778,302 @@ curl -G 'https://api.bilibili.com/x/space/arc/search' \
2778
2778
2779
2779
</details>
2780
2780
2781
2782
### 查询用户投稿明细(APP、无需wbi鉴权)
2783
2784
<details>
2785
2786
> https://app.biliapi.com/x/v2/space/archive/cursor
2787
2788
*请求方式:GET*
2789
2790
可以获取APP端可获得的用户空间投稿所有信息
2791
APP端请求对web端包容度最高,无需Cookie以外的任何认证,只需填写vmid即可查询
2792
认证方式:Cookie 或 APP
2793
2794
**url参数:**
2795
2796
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
2797
| ------------- | ---- | ----------------------- | -------------- | ------------- |
2798
| vmid | num | 目标用户mid | 必要 | |
2799
| aid | num | 请求返回起始视频 | 首次请求不需要 | 填写上次请求返回最后视频的aid |
2800
| order | str | 排序方式 | 非必要 | `click`代表最多播放,`pubdate`代表最新发布 |
2801
| sort | str | 确有影响,但这是什么呢? | 非必要 | 创建时间: asc<br />修改时间: desc |
2802
| access_key | str | APP登录Token | APP方式必要 | |
2803
| appkey | str | APP密钥 | APP方式必要 | |
2804
| build | num | 版本 | APP方式必要 | 可为`8130300` |
2805
| c_locale | str | 语言 | 非必要 | zh_CN |
2806
| channel | num | 频道 | 非必要 | |
2807
| fnval | num | 视频流类型 | 非必要 | |
2808
| fnver | num | 请求时提供的fnver | 非必要 | 可为 0 |
2809
| force_host | num | 源url类型 | 非必要 | 0:无限制 1:使用http 2:使用https |
2810
| fourk | num | 是否允许 4K 视频 | 非必要 | 画质最高 1080P:0(默认)<br />画质最高 4K:1 |
2811
| include_cursor| bool | 未知 | 非必要 | 可为false |
2812
| mobi_app | str | 平台标识 | 非必要 | 可为 `web`、`android` 等 |
2813
| platform | str | 平台 | 非必要 | 可为`web` |
2814
| ps | int | 每页条数 | 非必要 | 默认为 `20` |
2815
| pn | int | 似乎不是页码 | 非必要 | 默认为 `32` |
2816
| pn_policy | int | 未知 | 非必要 | 可为 `1` |
2817
| s_locale | str | 语言 | 非必要 | zh_CN |
2818
| statistics | str | 位置 | 非必要 | 可为{"appId":1,"platform":3,"version":"8.13.0","abtest":""} |
2819
| ts | num | 秒级时间戳 | 非必要 | |
2820
| voice_balance | num | 未知 | 非必要 | 默认为 `1` |
2821
| sign | str | APP签名 | APP方式必要 | |
2822
2823
**json回复:**
2824
2825
| 字段 | 类型 | 内容 | 备注 |
2826
| ------- | ---- | -------- | ---------------------------- |
2827
| code | num | 返回值 | 0:成功<br />-400:请求错误 |
2828
| message | str | 错误信息 | 默认为0 |
2829
| ttl | num | 1 | |
2830
| data | obj | 视频信息 | |
2831
2832
`data`对象:
2833
2834
| 字段 | 类型 | 内容 | 备注 |
2835
| --------------------- | ------ | ------------- | ----------------------------- |
2836
| count | num | 总数 | 0:成功<br />-400:请求错误 |
2837
| episodic_button | obj | 播放按钮 | 播放按钮的显示文字与跳转链接 |
2838
| has_next | bool | 有无后续 | true:有;false:没有 |
2839
| has_prev | bool | 有无前置 | true:有;false:没有 |
2840
| item | array | 视频列表 | 注意是item没有复数 |
2841
| last_watched_locator | obj | 上次播放定位 | 上次播放定位的一些信息 |
2842
| order | array | 排列方式 | 排列方式的显示与值 |
2843
2844
`episodic_button`对象
2845
2846
| 字段 | 类型 | 内容 | 备注 |
2847
| ----- | ------ | ----------------- | ------ |
2848
| text | str | 四个大字“播放全部” | |
2849
| uri | str | 跳转链接 | |
2850
2851
`item`数组:
2852
2853
| 项 | 类型 | 内容 | 备注 |
2854
| ---- | ---- | ------------ | ---- |
2855
| 0 | obj | 视频信息1 | |
2856
| n | obj | 视频信息(n+1) | |
2857
| …… | obj | …… | …… |
2858
2859
`item`数组元素:
2860
2861
| 参数名 | 类型 | 内容 | 备注 |
2862
| ----------------- | ----- | ----------------------- | ------------------------ |
2863
| author | str | 作者昵称 | |
2864
| bvid | str | 视频bv号 | |
2865
| cover | str | 封面url | |
2866
| cover_icon | str | 封面icon?未知 | |
2867
| ctime | num | 应该是发布时间秒级时间戳 | |
2868
| cursor_attr | obj | 上次观看标记 | |
2869
| danmaku | num | 弹幕数 | |
2870
| duration | num | 视频时长 | |
2871
| first_cid | num | 首个频道cid | |
2872
| goto | str | 应该是跳转去向类型 | 已知av为视频 |
2873
| icon_type | num | icon类型?未知 | |
2874
| is_cooperation | bool | 是否为合作视频 | 如果true会有粉色合作视频标签 |
2875
| is_fold | bool | 是否折叠?未知 | |
2876
| is_live_playback | bool | 是否为直播回放 | 如果true会有粉色直播回放标签 |
2877
| is_onself | bool | 是否自己?未知 | |
2878
| is_pgc | bool | 是否开pgc | |
2879
| is_popular | bool | 是否上热门 | 如果true会有热门标签 |
2880
| is_pugv | bool | 未知 | |
2881
| is_steins | bool | 未知 | |
2882
| is_ugcpay | bool | 未知 | |
2883
| length | num | 长度?未知 | |
2884
| param | str | 参数,实际为视频aid | |
2885
| play | num | 播放量 | |
2886
| publish_time_text | str | 发布时间汉字字符串版 | |
2887
| state | bool | 状态?未知 | |
2888
| subtitle | str | 子标题 | |
2889
| three_points | array | 三点按钮内容 | 关于稍后再看和分享的显示内容 |
2890
| title | str | 标题 | |
2891
| tname | str | tag的name | |
2892
| ugc_pay | num | ugc支付?未知 | |
2893
| uri | str | APP 跳转 uri | |
2894
| video | num | 未知 | |
2895
| view_content | str | 播放量字符串版 | |
2896
2897
`item`元素中的`cursor_attr`对象:
2898
2899
| 参数名 | 类型 | 内容 | 备注 |
2900
| ------------------- | ---- | ----------------------- | -------------------------------------- |
2901
| is_last_watched_arc | bool | 是否为上次播放 | 如果ture则封面笼罩一层写有“上次播放”的灰幕 |
2902
| rank | num | 视频所处该列表排名 | |
2903
2904
`last_watched_locator`对象:
2905
2906
| 字段 | 类型 | 内容 | 备注 |
2907
| ------------------ | ----- | ----------------- | ------ |
2908
| display_threshold | num | 显示阈值 | |
2909
| insert_ranking | num | 嵌入排名 | |
2910
| text | str | 定位上次观看字样 | |
2911
2912
`order`数组:
2913
2914
| 项 | 类型 | 内容 | 备注 |
2915
| ---- | ---- | ------------ | ----------------- |
2916
| 0 | obj | 最新发布的内容 | 内包括文字和值 |
2917
| 1 | obj | 最多播放的内容 | 内包括文字和值 |
2918
2919
**示例:**
2920
2921
查询用户mid=1240283469的稿件
2922
以播放量排序,显示3个稿件,但假设aid=1301087872及以前稿件已经加载过
2923
2924
> https://app.biliapi.com/x/v2/space/archive/cursor?vmid=1240283469&order=click&ps=3&aid=1301087872
2925
输入浏览器
2926
2927
<details>
2928
<summary>查看响应示例:</summary>
2929
2930
```json
2931
2932
{
2933
"code": 0,
2934
"message": "0",
2935
"ttl": 1,
2936
"data": {
2937
"episodic_button": {
2938
"text": "播放全部",
2939
"uri": "bilibili://music/playlist/spacepage/1240283469?desc=1\u0026offset=0\u0026oid=0\u0026order=time\u0026page_type=1\u0026playlist_intro=UP%E4%B8%BB%E7%9A%84%E5%85%A8%E9%83%A8%E8%A7%86%E9%A2%91\u0026ps=20\u0026sort_field=2\u0026sort_hidden=1\u0026total_count=33\u0026user_name=%E7%A5%9E%E5%9D%A1%E5%86%9C%E8%8E%AB"
2940
},
2941
"order": [
2942
{
2943
"title": "最新发布",
2944
"value": "pubdate"
2945
},
2946
{
2947
"title": "最多播放",
2948
"value": "click"
2949
}
2950
],
2951
"count": 33,
2952
"item": [
2953
{
2954
"title": "【神坡农二】后半段更是天籁!汉堡仙人神坡农二吃完快餐深情演唱《樱花树下的约定》",
2955
"subtitle": "",
2956
"tname": "搞笑",
2957
"cover": "http://i2.hdslb.com/bfs/archive/3e5d02f50b2e0a756cc5e3dd7f705abc58c3a439.jpg",
2958
"cover_icon": "",
2959
"uri": "bilibili://video/1351875564?history_progress=0\u0026player_height=1920\u0026player_rotate=0\u0026player_width=1080",
2960
"param": "1351875564",
2961
"goto": "av",
2962
"length": "",
2963
"duration": 45,
2964
"is_popular": false,
2965
"is_steins": false,
2966
"is_ugcpay": false,
2967
"is_cooperation": false,
2968
"is_pgc": false,
2969
"is_live_playback": false,
2970
"is_pugv": false,
2971
"is_fold": false,
2972
"is_oneself": false,
2973
"play": 1248,
2974
"danmaku": 1,
2975
"ctime": 1710518403,
2976
"ugc_pay": 0,
2977
"author": "神坡农莫",
2978
"state": false,
2979
"bvid": "BV1H6421w7Gy",
2980
"videos": 1,
2981
"three_point": [
2982
{
2983
"type": "addtoview",
2984
"icon": "https://i0.hdslb.com/bfs/app/25cc01346574a601dafd45c94226d92a67eed79a.png",
2985
"text": "添加至稍后再看"
2986
},
2987
{
2988
"type": "share",
2989
"icon": "https://i0.hdslb.com/bfs/app/a5787f586c72f2d6f6ade4b33c64908938c4a01f.png",
2990
"text": "分享",
2991
"share_succ_toast": "分享成功",
2992
"share_fail_toast": "分享失败",
2993
"share_path": "pages/video/video?avid=1351875564",
2994
"short_link": "https://b23.tv/BV1H6421w7Gy"
2995
}
2996
],
2997
"first_cid": 1471110689,
2998
"cursor_attr": {
2999
"is_last_watched_arc": false,
3000
"rank": 1
3001
},
3002
"view_content": "1248",
3003
"icon_type": 0,
3004
"publish_time_text": "3月16日"
3005
},
3006
{
3007
"title": "【迪迦奥特曼】亲自配音?迪迦超战神联合网络新星神坡农二!共同打造奥特曼大电影!",
3008
"subtitle": "",
3009
"tname": "搞笑",
3010
"cover": "http://i0.hdslb.com/bfs/archive/c6c94d16aeeefca148c1694e45fd352b22cac3fb.jpg",
3011
"cover_icon": "",
3012
"uri": "bilibili://video/1950389780?history_progress=0\u0026player_height=1080\u0026player_rotate=0\u0026player_width=1920",
3013
"param": "1950389780",
3014
"goto": "av",
3015
"length": "",
3016
"duration": 101,
3017
"is_popular": false,
3018
"is_steins": false,
3019
"is_ugcpay": false,
3020
"is_cooperation": false,
3021
"is_pgc": false,
3022
"is_live_playback": false,
3023
"is_pugv": false,
3024
"is_fold": false,
3025
"is_oneself": false,
3026
"play": 1184,
3027
"danmaku": 0,
3028
"ctime": 1707431804,
3029
"ugc_pay": 0,
3030
"author": "神坡农莫",
3031
"state": false,
3032
"bvid": "BV1fC411x7uf",
3033
"videos": 1,
3034
"three_point": [
3035
{
3036
"type": "addtoview",
3037
"icon": "https://i0.hdslb.com/bfs/app/25cc01346574a601dafd45c94226d92a67eed79a.png",
3038
"text": "添加至稍后再看"
3039
},
3040
{
3041
"type": "share",
3042
"icon": "https://i0.hdslb.com/bfs/app/a5787f586c72f2d6f6ade4b33c64908938c4a01f.png",
3043
"text": "分享",
3044
"share_succ_toast": "分享成功",
3045
"share_fail_toast": "分享失败",
3046
"share_path": "pages/video/video?avid=1950389780",
3047
"short_link": "https://b23.tv/BV1fC411x7uf"
3048
}
3049
],
3050
"first_cid": 1434820367,
3051
"cursor_attr": {
3052
"is_last_watched_arc": false,
3053
"rank": 2
3054
},
3055
"view_content": "1184",
3056
"icon_type": 0,
3057
"publish_time_text": "2月9日"
3058
}
3059
],
3060
"last_watched_locator": {
3061
"display_threshold": 10,
3062
"insert_ranking": 6,
3063
"text": "定位至上次观看"
3064
},
3065
"has_next": true,
3066
"has_prev": true
3067
}
3068
}
3069
3070
```
3071
3072
</details>
3073
3074
</details>
3075
3076
2781
3077
### 查询用户投稿相簿预览
2782
3078
2783
3079
<details>