XFE Git
XFE Studio Git
Git 首页 全局搜索
XFE 主站 文档 NuGet
公开
关注 0 Fork 0 Star 0
返回提交历史

XFEstudio/bilibili-API-collect

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

2521782
SocialSisterYi <1440239038@qq.com>
提交于
父提交 8e2a4a9

代码差异

3 个文件 +509 -424
Modified docs/misc/errcode.md +1 -0
@@ -57,4 +57,5 @@
57 57 | -688 | 地理区域限制 |
58 58 | -689 | 版权限制 |
59 59 | -701 | 扣节操失败 |
60 | -799 | 请求过于频繁，请稍后再试 |
60 61 |-8888|对不起，服务器开小差了~ (ಥ﹏ಥ)|
Modified docs/user/space.md +263 -146
@@ -2624,11 +2624,11 @@ curl -L -X GET 'https://api.bilibili.com/x/space/like/video?vmid=15858903'
2624 2624
2625 2625 > https://api.bilibili.com/x/space/wbi/arc/search
2626 2626
2627 > ~~https://api.bilibili.com/x/space/arc/search （旧 API，现已不可用）~~
2627 *请求方式：GET*
2628 2628
2629 PS：旧 API 现已不可使用，活返回`code=-799`
2629 鉴权方式：[Wbi 签名](../misc/sign/wbi.md)
2630 2630
2631 *请求方式：GET*
2631 ~~该接口的旧版 API ：https://api.bilibili.com/x/space/arc/search~~（已废弃，不建议使用）
2632 2632
2633 2633 **header字段：**
2634 2634
@@ -2644,6 +2644,8 @@ PS：旧 API 现已不可使用，活返回`code=-799`
2644 2644 | keyword | str | 关键词筛选 | 非必要 | 用于使用关键词搜索该UP主视频稿件 |
2645 2645 | pn | num | 页码 | 非必要 | |
2646 2646 | ps | num | 每页项数 | 非必要 | 最小 1，最大 50，默认 30 |
2647 | w_rid | str | Wbi 签名 | 必要 | 详见 [Wbi 签名](../misc/sign/wbi.md) |
2648 | wts | num | 当前时间戳 | 必要 | 详见 [Wbi 签名](../misc/sign/wbi.md) |
2647 2649
2648 2650 **json回复：**
2649 2651
@@ -2651,28 +2653,29 @@ PS：旧 API 现已不可使用，活返回`code=-799`
2651 2653
2652 2654 | 字段 | 类型 | 内容 | 备注 |
2653 2655 | ------- | ---- | -------- | ------------------------------------------------------------ |
2654 | code | num | 返回值 | 0：成功<br />-400：请求错误<br />-412：请求被拦截<br />-1200：被降级过滤的请求(一种意义不明的偶发状况) |
2656 | code | num | 返回值 | 0：成功<br />-400：请求错误<br />-403：访问权限不足<br />-412：请求被拦截<br />-1200：被降级过滤的请求(一种意义不明的偶发状况) |
2655 2657 | message | str | 错误信息 | 默认为 0 |
2656 2658 | ttl | num | 1 | |
2657 2659 | data | obj | 信息本体 | |
2658 2660
2659 2661 `data`对象：
2660 2662
2661 | 字段 | 类型 | 内容 | 备注 |
2662 |-----------------|------|----------|-----|
2663 | list | obj | 列表信息 | |
2664 | page | obj | 页面信息 | |
2665 | episodic_button | obj | “播放全部“按钮 | |
2666 | is_risk | bool | | |
2667 | gaia_res_type | num | | |
2668 | gaia_data | | | |
2663 | 字段 | 类型 | 内容 | 备注 |
2664 | --------------- | ---- | -------------- | ---- |
2665 | list | obj | 列表信息 | |
2666 | page | obj | 页面信息 | |
2667 | episodic_button | obj | “播放全部“按钮 | |
2668 | is_risk | bool | （？） | |
2669 | gaia_res_type | num | （？） | |
2670 | gaia_data | null | （？） | |
2669 2671
2670 2672 `data`中的`list`对象：
2671 2673
2672 | 字段 | 类型 | 内容 | 备注 |
2673 |-------|-------|----------|-----|
2674 | tlist | obj | 投稿视频分区索引 | |
2675 | vlist | array | 投稿视频列表 | |
2674 | 字段 | 类型 | 内容 | 备注 |
2675 | ----- | ----- | ---------------- | ---- |
2676 | tlist | obj | 投稿视频分区索引 | |
2677 | vlist | array | 投稿视频列表 | |
2678 | slist | array | （？） | |
2676 2679
2677 2680 `list`中的`tlist`对象：
2678 2681
@@ -2701,30 +2704,31 @@ PS：旧 API 现已不可使用，活返回`code=-799`
2701 2704
2702 2705 | 字段 | 类型 | 内容 | 备注 |
2703 2706 | ---------------- | ---- | -------------- | ------------------------------------------------------------ |
2704 | aid | num | 稿件 avid | |
2705 | author | str | 视频 UP 主 | 不一定为目标用户（合作视频） |
2706 | bvid | str | 稿件 bvid | |
2707 2707 | comment | num | 视频评论数 | |
2708 | copyright | str | 稿件类型 | 1：原创<br />2：转载 |
2709 | created | num | 投稿时间 | 时间戳 |
2710 | description | str | 视频简介 | |
2711 | hide_click | bool | false | 作用尚不明确 |
2712 | is_pay | num | 0 | 作用尚不明确 |
2713 | is_union_video | num | 是否为合作视频 | 0：否<br />1：是 |
2714 | length | str | 视频长度 | MM:SS |
2715 | mid | num | 视频 UP 主 mid | 不一定为目标用户（合作视频） |
2708 | typeid | num | 视频分区 tid | |
2709 | play | num | 视频播放次数 | 如果视频基本信息 API 对应的状态为 -403 视频访问权限不足，数据类型将变为str，如（"play": "--",），于 UID:79 发表的 av5132474 可见 |
2716 2710 | pic | str | 视频封面 | |
2717 | play | num | 视频播放次数 | 如果视频基本信息API对应的状态为-403视频访问权限不足，数据类型将变为str，如（"play": "--",），于mid79发表的av5132474可见 |
2718 | review | num | 0 | 作用尚不明确 |
2719 | subtitle | str | 空 | 作用尚不明确 |
2711 | subtitle | str | （？） | |
2712 | description | str | 视频简介 | |
2713 | copyright | str | 稿件类型 | 1：原创<br />2：转载 |
2720 2714 | title | str | 视频标题 | |
2721 | typeid | num | 视频分区 tid | |
2715 | review | num | （?） | |
2716 | author | str | 视频 UP 主 | 不一定为目标用户（合作视频） |
2717 | mid | num | 视频 UP 主 mid | 不一定为目标用户（合作视频） |
2718 | created | num | 投稿时间 | 秒时间戳 |
2719 | length | str | 视频长度 | MM:SS |
2722 2720 | video_review | num | 视频弹幕数 | |
2723 | is_steins_gate | num | 0 | |
2724 | is_live_playback | num | 0 | |
2725 | meta | | | |
2726 | is_avoided | num | 0 | |
2727 | attribute | num | 0 | |
2721 | aid | num | 稿件 avid | |
2722 | bvid | str | 稿件 bvid | |
2723 | hide_click | bool | （？） | |
2724 | is_pay | num | （？） | |
2725 | is_union_video | num | 是否为合作视频 | 0：否<br />1：是 |
2726 | is_steins_gate | num | （？） | |
2727 | is_live_playback | num | 是否直播回放 | 0：否<br />1：是 |
2728 | meta | null | （？） | |
2729 | is_avoided | num | （？） | |
2730 | attribute | num | （？） | |
2731 | is_charging_arc | bool | （？） | |
2728 2732
2729 2733 `data`中的`page`对象：
2730 2734
@@ -2745,13 +2749,17 @@ PS：旧 API 现已不可使用，活返回`code=-799`
2745 2749
2746 2750 `pn`（页码）和`ps`（每页项数）只改变`vlist`中成员的多少与内容
2747 2751
2748 以每页2项查询用户`mid=53456`的第1页投稿视频明细
2752 以每页 5 项查询用户`mid=53456`的第 1 页投稿视频明细
2753
2754 Wbi 签名的 `wts`、`w_rid`生成方式详见 [Wbi 签名](../misc/sign/wbi.md) 文档
2749 2755
2750 2756 ```shell
2751 2757 curl -G 'https://api.bilibili.com/x/space/wbi/arc/search' \
2752 2758 --data-urlencode 'mid=53456' \
2753 --data-urlencode 'ps=2' \
2754 --data-urlencode 'pn=1'
2759 --data-urlencode 'ps=5' \
2760 --data-urlencode 'pn=1' \
2761 --data-urlencode 'wts=1685073645' \
2762 --data-urlencode 'w_rid=2e49b69235fb3ea9340422ac9382cbc2'
2755 2763 ```
2756 2764
2757 2765 <details>
@@ -2759,116 +2767,225 @@ curl -G 'https://api.bilibili.com/x/space/wbi/arc/search' \
2759 2767
2760 2768 ```json
2761 2769 {
2762 "code": 0,
2763 "message": "0",
2764 "ttl": 1,
2765 "data": {
2766 "list": {
2767 "tlist": {
2768 "1": {
2769 "tid": 1,
2770 "count": 41,
2771 "name": "动画"
2772 },
2773 "3": {
2774 "tid": 3,
2775 "count": 36,
2776 "name": "音乐"
2777 },
2778 "4": {
2779 "tid": 4,
2780 "count": 82,
2781 "name": "游戏"
2782 },
2783 "36": {
2784 "tid": 36,
2785 "count": 1,
2786 "name": "知识"
2770 "code": 0,
2771 "message": "0",
2772 "ttl": 1,
2773 "data": {
2774 "list": {
2775 "tlist": {
2776 "1": {
2777 "tid": 1,
2778 "count": 42,
2779 "name": "动画"
2780 },
2781 "3": {
2782 "tid": 3,
2783 "count": 36,
2784 "name": "音乐"
2785 },
2786 "4": {
2787 "tid": 4,
2788 "count": 85,
2789 "name": "游戏"
2790 },
2791 "36": {
2792 "tid": 36,
2793 "count": 1,
2794 "name": "知识"
2795 },
2796 "160": {
2797 "tid": 160,
2798 "count": 51,
2799 "name": "生活"
2800 },
2801 "211": {
2802 "tid": 211,
2803 "count": 3,
2804 "name": "美食"
2805 },
2806 "217": {
2807 "tid": 217,
2808 "count": 2,
2809 "name": "动物圈"
2810 }
2811 },
2812 "vlist": [
2813 {
2814 "comment": 2727,
2815 "typeid": 17,
2816 "play": 1379744,
2817 "pic": "http://i0.hdslb.com/bfs/archive/d8745a327c56a1d8862054bf88ed1cd3d4cd2a0f.jpg",
2818 "subtitle": "",
2819 "description": "游戏：《塞尔达传说：王国之泪》\n真好玩！一口气玩了五天，到处游山玩水都没怎么顾得上推主线哈哈哈，虽然没能造出高达来，但胡乱折腾也很开心啦！\n我的微博：_warma_",
2820 "copyright": "1",
2821 "title": "【warma】我玩游戏太菜不要笑我！",
2822 "review": 0,
2823 "author": "Warma",
2824 "mid": 53456,
2825 "created": 1684468800,
2826 "length": "27:53",
2827 "video_review": 7538,
2828 "aid": 741294090,
2829 "bvid": "BV1dk4y1L77W",
2830 "hide_click": false,
2831 "is_pay": 0,
2832 "is_union_video": 0,
2833 "is_steins_gate": 0,
2834 "is_live_playback": 0,
2835 "meta": null,
2836 "is_avoided": 0,
2837 "attribute": 0,
2838 "is_charging_arc": false
2839 },
2840 {
2841 "comment": 2959,
2842 "typeid": 172,
2843 "play": 1601320,
2844 "pic": "http://i2.hdslb.com/bfs/archive/5bc6b4b78787508fec6e5545313a5aac49b420ab.jpg",
2845 "subtitle": "",
2846 "description": "来继续更新我的光遇之旅啦~这次也录到了好几个交到新朋友的瞬间了哈哈哈，每次被陌生人夸的时候都感觉特别不好意思但是又好开心！喜欢这里慢悠悠的氛围~最近夜行季也上线了，来欣赏美丽的月食吧！\n祝大家看得开心啦！",
2847 "copyright": "1",
2848 "title": "【warma】这里的陌生人都热情过头了啊啊啊！",
2849 "review": 0,
2850 "author": "Warma",
2851 "mid": 53456,
2852 "created": 1683434541,
2853 "length": "21:56",
2854 "video_review": 2552,
2855 "aid": 570782455,
2856 "bvid": "BV12z4y1h72d",
2857 "hide_click": false,
2858 "is_pay": 0,
2859 "is_union_video": 0,
2860 "is_steins_gate": 0,
2861 "is_live_playback": 0,
2862 "meta": null,
2863 "is_avoided": 0,
2864 "attribute": 0,
2865 "is_charging_arc": false
2866 },
2867 {
2868 "comment": 6844,
2869 "typeid": 21,
2870 "play": 3898109,
2871 "pic": "http://i0.hdslb.com/bfs/archive/733239b86fe15c5f07d15872a955e1819dcc1f31.jpg",
2872 "subtitle": "",
2873 "description": "我想试着练习写一本从构思、正文、插画、排版到封面设计全都由自己来完成的书！\n\n虽然这本书未来还不确定，但是我尽力啦~大家如果觉得有哪里做得还不够好请指出来告诉我吧，我还有很多很多需要学习的地方，请大家多多指教啦！\n如果有出版社的编辑老师正在观看此视频的话，请老师们多多指教，希望能够和老师们取得联系：chickenfish@vip.qq.com\n\n电子书文件发在评论区啦~",
2874 "copyright": "1",
2875 "title": "【warma】我要写书啦！！！",
2876 "review": 0,
2877 "author": "Warma",
2878 "mid": 53456,
2879 "created": 1680840000,
2880 "length": "21:55",
2881 "video_review": 15975,
2882 "aid": 909664793,
2883 "bvid": "BV1oM4y1y7Q4",
2884 "hide_click": false,
2885 "is_pay": 0,
2886 "is_union_video": 0,
2887 "is_steins_gate": 0,
2888 "is_live_playback": 0,
2889 "meta": null,
2890 "is_avoided": 0,
2891 "attribute": 0,
2892 "is_charging_arc": false
2893 },
2894 {
2895 "comment": 2030,
2896 "typeid": 17,
2897 "play": 2272296,
2898 "pic": "http://i0.hdslb.com/bfs/archive/d0d12a011d2a3799a77fa84372372581abdc917c.jpg",
2899 "subtitle": "",
2900 "description": "玩到尽兴为止！\n\n录制/视频制作：warma\n录制/插画：怒九",
2901 "copyright": "1",
2902 "title": "【warma/怒九】陪我打游戏！(胁迫)",
2903 "review": 0,
2904 "author": "Warma",
2905 "mid": 53456,
2906 "created": 1677816000,
2907 "length": "36:42",
2908 "video_review": 9902,
2909 "aid": 482867257,
2910 "bvid": "BV1XT411v76Y",
2911 "hide_click": false,
2912 "is_pay": 0,
2913 "is_union_video": 1,
2914 "is_steins_gate": 0,
2915 "is_live_playback": 0,
2916 "meta": null,
2917 "is_avoided": 0,
2918 "attribute": 0,
2919 "is_charging_arc": false
2920 },
2921 {
2922 "comment": 12666,
2923 "typeid": 21,
2924 "play": 1892762,
2925 "pic": "http://i0.hdslb.com/bfs/archive/5e712811e893886fb0535a95e1609cb3ba307a39.jpg",
2926 "subtitle": "",
2927 "description": "你好~这是我的一期电台节目，现在也已经是第十一期啦，但是即便没看过前面几期也不会影响观看，因为这是个什么都聊聊看的日常电台嘛~\n \n这期电台内容非常友好、令人安心，只是偶尔有点“问题”，但好在目前还是处于能安全观看的水平，请来看看吧。\n \n录音/视频制作：warma\n我的微博：_warma_\n \n背景插画：认知Renz\n发光粒子素材：K_Lacid \n【视频某处的曲子的staff】\n翻唱：Warma\n曲绘：不鱼\nPV：祈凉_&兽人苦工\n后期：白萝卜音乐工作室\n \n（感谢以上老师的帮助~）",
2928 "copyright": "1",
2929 "title": "【warma爆炸电台】曾经性格阴沉的我正在分享创作心得与日常【第十一期】",
2930 "review": 0,
2931 "author": "Warma",
2932 "mid": 53456,
2933 "created": 1674964800,
2934 "length": "77:24",
2935 "video_review": 68240,
2936 "aid": 990909915,
2937 "bvid": "BV1Ex4y177xd",
2938 "hide_click": false,
2939 "is_pay": 0,
2940 "is_union_video": 0,
2941 "is_steins_gate": 0,
2942 "is_live_playback": 0,
2943 "meta": {
2944 "id": 149941,
2945 "title": "爆炸电台",
2946 "cover": "https://archive.biliimg.com/bfs/archive/b833b4299b3f4252ebe4d2902421aa25ba9e7ccc.jpg",
2947 "mid": 53456,
2948 "intro": "你好！这是我的电台节目《爆炸电台》，这是个什么都聊聊看的日常电台，内容是纯音频的，所以看不看画面都没问题~\n电台的时间比较长，可以拿点零食饮料或者放在一旁慢慢听什么的都很合适~\n祝观看愉快~！",
2949 "sign_state": 0,
2950 "attribute": 140,
2951 "stat": {
2952 "season_id": 149941,
2953 "view": 11824985,
2954 "danmaku": 363116,
2955 "reply": 50348,
2956 "favorite": 343639,
2957 "coin": 665105,
2958 "share": 50804,
2959 "like": 1013864,
2960 "mtime": 1685073652,
2961 "vt": 71631635,
2962 "vv": 0
2963 },
2964 "ep_count": 10,
2965 "first_aid": 990909915,
2966 "ptime": 1674964800,
2967 "ep_num": 0
2968 },
2969 "is_avoided": 0,
2970 "attribute": 0,
2971 "is_charging_arc": false
2972 }
2973 ],
2974 "slist": []
2787 2975 },
2788 "160": {
2789 "tid": 160,
2790 "count": 49,
2791 "name": "生活"
2976 "page": {
2977 "pn": 1,
2978 "ps": 5,
2979 "count": 220
2792 2980 },
2793 "211": {
2794 "tid": 211,
2795 "count": 3,
2796 "name": "美食"
2981 "episodic_button": {
2982 "text": "播放全部",
2983 "uri": "//www.bilibili.com/medialist/play/53456?from=space"
2797 2984 },
2798 "217": {
2799 "tid": 217,
2800 "count": 2,
2801 "name": "动物圈"
2802 }
2803 },
2804 "vlist": [
2805 {
2806 "comment": 6729,
2807 "typeid": 172,
2808 "play": 2171260,
2809 "pic": "http://i2.hdslb.com/bfs/archive/9fe04c2acb6678c9a8d1547db211e458ea70982c.jpg",
2810 "subtitle": "",
2811 "description": "好开心能和几千人一起看音乐会！真的震撼到我了，它给我带来的冲击感远超出了我的想象……光遇这场音乐会会一直持续到元旦哦，大家感兴趣的话也可以来试试吧~\n祝看得开心啦！",
2812 "copyright": "1",
2813 "title": "【warma】我尝试学习交朋友",
2814 "review": 0,
2815 "author": "Warma",
2816 "mid": 53456,
2817 "created": 1671163200,
2818 "length": "23:58",
2819 "video_review": 7931,
2820 "aid": 433873134,
2821 "bvid": "BV1nG411P7hf",
2822 "hide_click": false,
2823 "is_pay": 0,
2824 "is_union_video": 0,
2825 "is_steins_gate": 0,
2826 "is_live_playback": 0,
2827 "meta": null,
2828 "is_avoided": 0,
2829 "attribute": 0
2830 },
2831 {
2832 "comment": 3380,
2833 "typeid": 31,
2834 "play": 811600,
2835 "pic": "http://i2.hdslb.com/bfs/archive/7e6c6ec32a0db8684abd660d599644e9d1c43ee4.jpg",
2836 "subtitle": "",
2837 "description": "原曲：BV1iR4y1X7V9\n这首歌是今年生日的时候收到的礼物，真的太好听了！我也想翻唱试试~\n在翻唱中录了一些不一样的小音效，比如卡祖笛和竖笛，还录了些小配音……大家来听听看！\n谢谢原曲staff老师们做出这么有趣的作品，谢谢在这次翻唱中staff老师们的帮助（PV老师甚至根据翻唱版本把曲子的PV做了些修改，加了好多小细节，真的超用心！）\n祝听得开心啦~\n \n【staff表】\n原曲staff：详见BV1iR4y1X7V9\n翻唱：warma\n混音：白萝卜音乐工作室\nPV修改：@颜一bot \n封面：是根",
2838 "copyright": "1",
2839 "title": "【warma】来唱大家送我的歌！《夏天幻游日记》",
2840 "review": 0,
2841 "author": "Warma",
2842 "mid": 53456,
2843 "created": 1670558400,
2844 "length": "02:59",
2845 "video_review": 2343,
2846 "aid": 733323002,
2847 "bvid": "BV18D4y1Y7o6",
2848 "hide_click": false,
2849 "is_pay": 0,
2850 "is_union_video": 0,
2851 "is_steins_gate": 0,
2852 "is_live_playback": 0,
2853 "meta": null,
2854 "is_avoided": 0,
2855 "attribute": 0
2856 }
2857 ]
2858 },
2859 "page": {
2860 "pn": 1,
2861 "ps": 2,
2862 "count": 214
2863 },
2864 "episodic_button": {
2865 "text": "播放全部",
2866 "uri": "//www.bilibili.com/medialist/play/53456?from=space"
2867 },
2868 "is_risk": false,
2869 "gaia_res_type": 0,
2870 "gaia_data": null
2871 }
2985 "is_risk": false,
2986 "gaia_res_type": 0,
2987 "gaia_data": null
2988 }
2872 2989 }
2873 2990 ```
2874 2991