From f272277d226949214bef710f570144ec90f5021b Mon Sep 17 00:00:00 2001 From: SocialSisterYi <45892418+SocialSisterYi@users.noreply.github.com> Date: Tue, 14 Jul 2020 18:44:44 +0800 Subject: [PATCH] =?UTF-8?q?=E4=BC=98=E5=8C=96=E6=96=87=E6=A1=A3=E6=A0=BC?= =?UTF-8?q?=E5=BC=8F?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- B站API.txt | 698 +++++++++++++++++++++ README.md | 8 +- article/info.md | 2 +- article/like_coin_fav.md | 6 +- bangumi/info.md | 175 ++++++ blackroom/banlist.md | 4 +- broadcast/general.md | 2 +- cheese/info.md | 4 +- cheese/videostream_url.md | 20 +- comment/action.md | 12 +- comment/comment_list.md | 22 +- creativecenter/railgun.md | 6 +- creativecenter/statistics&data.md | 14 +- danmaku/action.md | 8 +- danmaku/danmaku_xml.md | 4 +- danmaku/history.md | 4 +- danmaku/snapshot.md | 2 +- dynamic/publish.md | 4 +- electric/Bcoin.md | 2 +- electric/WeChat&Alipay.md | 4 +- electric/charge_list.md | 4 +- electric/charge_msg.md | 2 +- emote/action.md | 4 +- emote/emote_list.md | 6 +- history&toview/history.md | 12 +- history&toview/toview.md | 10 +- live/info.md | 2 +- live/info_flow.md | 169 +++++ live/live_area.md | 2 +- live/manage.md | 6 +- login/{ => login_action}/QR.md | 21 +- login/{verify => login_action}/SMS.md | 12 +- login/{verify => login_action}/password.md | 22 +- login/{verify => login_action}/readme.md | 18 +- login/login_info.md | 6 +- login/member_center.md | 14 +- message/msg.md | 2 +- message/private_msg.md | 2 +- music/coin&fav.md | 4 +- music/info.md | 8 +- music/music_list.md | 4 +- music/status_number.md | 2 +- other/API_auth.md | 4 +- other/ip.md | 2 +- other/time_stamp.md | 2 +- other/zone_online.md | 2 +- ranking&dynamic/dynamic.md | 2 +- ranking&dynamic/ranking.md | 2 +- search/search_request.md | 2 +- user/check_nickname.md | 39 +- user/info.md | 29 +- user/relation.md | 202 +++--- user/space.md | 50 +- user/status_number.md | 8 +- video/info.md | 64 +- video/like_coin_fav.md | 283 ++++++--- video/pbp.md | 2 +- video/recommend.md | 2 +- video/report.md | 8 +- video/snapshot.md | 4 +- video/status_number.md | 62 +- video/tags.md | 6 +- video/videostream_url.md | 40 +- 63 files changed, 1724 insertions(+), 424 deletions(-) create mode 100644 B站API.txt create mode 100644 bangumi/info.md create mode 100644 live/info_flow.md rename login/{ => login_action}/QR.md (94%) rename login/{verify => login_action}/SMS.md (96%) rename login/{verify => login_action}/password.md (96%) rename login/{verify => login_action}/readme.md (89%) diff --git a/B站API.txt b/B站API.txt new file mode 100644 index 0000000..a725a56 --- /dev/null +++ b/B站API.txt @@ -0,0 +1,698 @@ +#视频短网址 +b23.tv/ avID/ssID/epID/smID +跳转至 +www.bilibili.com/video/ avID +www.bilibili.com/bangumi/play/ ssID/epID +www.nicovideo.jp/watch/ smID + +#跳转至主站 +acg.tv +bilibili.cn +bilibili.tv + + +## at我的明细 + +需要登录(SESSDATA) + +访问则消去未读 + +api.bilibili.com/x/msgfeed/at + +*方式:GET* + + + +## 系统通知明细 + +需要登录(SESSDATA) + +访问则消去未读 + +message.bilibili.com/api/notify/query.sysnotify.list.do + +*方式:GET* + +在线用户 +api.bilibili.com/x/web-interface/online +方式:GET +json回复 +{ + "code":0, + "message":"0", + "ttl":1, + "data":{ + "region_count":{ + "1":6516,动画 + "11":7,电视剧 + "119":499,鬼畜 + "129":1472,舞蹈 + "13":338,番剧 + "138":7908,搞笑 + "155":2270,时尚 + "160":56943,生活 + "165":386,广告 + "167":439,国创 + "17":12698,单机游戏 + "177":957,纪录片 + "181":12761,影视 + "188":1830,数码 + "23":2,电影 + "3":10583,音乐 + "36":10074,科技 + "4":48084,游戏 + "5":10106,娱乐 + "75":3918,动物圈 + "76":3492 美食圈 + }, + "all_count":(num:), + "web_online":(num:在线人数), + "play_online":12561016 + } +} + +默认搜索 +api.bilibili.com/x/web-interface/search/default +方式:GET +json回复 +{ + "code":0, + "message":"0", + "ttl":1, + "data":{ + "seid":"12670784065342714945", + "id":9185549926650114417, + "type":0, + "show_name":(str:展示名), + "name":"", + "goto_type":1, + "goto_value":(str:内容ID), + "url":(str:内容网址) + } +} + +主页浮标 +api.bilibili.com/x/web-interface/index/icon +方式:GET +json回复 +{ + "code":0, + "message":"0", + "ttl":1, + "data":{ + "id":(num:编号), + "title":(str:名称), + "links":[(str:链接)], + "icon":(str:图标链接), + "weight":20 + } +} + + +------------------------------------------------- +#用户相关 + +获取用户空间设置 +space.bilibili.com/ajax/settings/getSettings?mid=1 +方式:GET +{ +"status":true, +"data":{ +"privacy":{ +"bangumi":1, +"bbq":1, +"channel":1, +"coins_video":0, +"comic":1, +"dress_up":1, +"fav_video":1, +"groups":1, +"likes_video":0, +"played_game":1, +"tags":0, +"user_info":1 +}, +"index_order":[{"id":1,"name":"\u6211\u7684\u7a3f\u4ef6"}, +{"id":8,"name":"\u6211\u7684\u4e13\u680f"}, +{"id":7,"name":"\u6211\u7684\u9891\u9053"}, +{"id":2,"name":"\u6211\u7684\u6536\u85cf\u5939"}, +{"id":3,"name":"\u8ba2\u9605\u756a\u5267"}, +{"id":4,"name":"\u8ba2\u9605\u6807\u7b7e"}, +{"id":5,"name":"\u6700\u8fd1\u6295\u5e01\u7684\u89c6\u9891"}, +{"id":6,"name":"\u6211\u7684\u5708\u5b50"}, +{"id":9,"name":"\u6211\u7684\u76f8\u7c3f"}, +{"id":21,"name":"\u516c\u544a"}, +{"id":22,"name":"\u76f4\u64ad\u95f4"}, +{"id":23,"name":"\u4e2a\u4eba\u8d44\u6599"}, +{"id":24,"name":"\u5b98\u65b9\u6d3b\u52a8"}, +{"id":25,"name":"\u6700\u8fd1\u73a9\u8fc7\u7684\u6e38\u620f"} +], +"theme":"default", +"theme_preview_img_path":"", +"toutu":{ +"sid":1, +"expire":2844296881, +"s_img":"bfs\/space\/768cc4fd97618cf589d23c2711a1d1a729f42235.png", +"l_img":"bfs\/space\/cb1c3ef50e22b6096fde67febe863494caefebad.png", +"android_img":"", +"iphone_img":"", +"ipad_img":"", +"thumbnail_img":"", +"platform":0 +} +} +} + +用户收藏夹预览 +api.bilibili.com/medialist/gateway/base/created?up_mid=&pn=&ps= +方式:GET +请求参数 + up_mid=(用户UID) + pn=(页码) + ps=(每页项数) + + +------------------------------------------------- +#视频相关 + +更改弹幕池 (需要登录) +api.bilibili.com/x/v2/dm/edit/pool +方式:POST +参数: +参数名 type oid pool dmids csrf +内容 视频CID 弹幕池 0普通 1字幕 弹幕ID CSRF Token(位于cookie) +必要性 必要 必要 必要 +json回复 +{"code":0,"message":"0","ttl":1} + +操作弹幕 (需要登录) +api.bilibili.com/x/v2/dm/edit/state +方式:POST +操作代码: +1删除 +2保护 +3取消保护 +参数: +参数名 type oid state dmids csrf +内容 视频CID 操作代码 弹幕ID CSRF Token(位于cookie) +必要性 必要 必要 必要 + +------------------------------------------------- +#创作中心相关 + +电磁力状态 (需要登录) +api.bilibili.com/studio/up-rating/rating/status +方式:GET +json回复 +{ + "code":0, + "message":"0", + "ttl":1, + "data":{ + "status":1, + "level":(num:电磁力等级), + "color":(str:文字颜色) + } + } + +最新回复 (需要登录) +member.bilibili.com/x/web/replies +方式:GET + +最新弹幕 (需要登录) +member.bilibili.com/x/web/danmu/recent?pn=1&ps=50 +方式:GET + +全部稿件 (需要登录) +member.bilibili.com/x/web/archives?status=is_pubing%2Cpubed%2Cnot_pubed&pn=1&ps=10&coop=1&interactive=1 +方式:GET + +全部专栏 (需要登录) +api.bilibili.com/x/article/creative/article/list?group=0&sort=&pn=1 +方式:GET + +全部申诉 (需要登录) +member.bilibili.com/x/web/appeal/list?ps=10&state=all&pn=1 +方式:GET + +收到的字幕 (需要登录) +api.bilibili.com/x/v2/dm/subtitle/search/assist?type=1&status=0&page=1&size=10 +方式:GET + +视频播放来源 (需要登录) +member.bilibili.com/x/web/data/playsource +方式:GET + +视频游客分析 (需要登录) +member.bilibili.com/x/web/data/base +方式:GET + +游客内容倾向 (需要登录) +member.bilibili.com/x/web/data/trend +方式:GET + +粉丝变化历史 (需要登录) +member.bilibili.com/x/web/data/action +方式:GET + +最新粉丝动态 (需要登录) +member.bilibili.com/x/web/data/fan +方式:GET + +------------------------------------------------- +#收藏夹与历史记录相关 +收藏夹明细 +api.bilibili.com/medialist/gateway/base/spaceDetail?media_id=&pn=&ps= +方式:GET + + +------------------------------------------------- +#TAG相关 +TAG详细信息 +api.bilibili.com/x/web-interface/channel/detail?channel_id=(TAGID) +方式:GET + +------------------------------------------------- +#番剧相关 +最新更新 +bangumi.bilibili.com/api/timeline_v2_global + +番剧状态数 +api.bilibili.com/pgc/web/season/stat?season_id= + +番剧精选短评 +api.bilibili.com/pgc/review/relate?media_id= + +------------------------------------------------- +#音频相关 +歌单简介 +www.bilibili.com/audio/music-service-c/web/menu/info?sid=10624 + +歌单明细 +www.bilibili.com/audio/music-service-c/web/song/of-menu?sid=10624&pn=1&ps=100 + +歌曲简介 +www.bilibili.com/audio/music-service-c/web/song/info?sid=1294480 + +歌曲TAG +www.bilibili.com/audio/music-service-c/web/tag/song?sid=1294480 + +歌曲制作组 +www.bilibili.com/audio/music-service-c/web/member/song?sid=1294480 + +歌曲相似推荐 +www.bilibili.com/audio/music-service-c/web/song/similar?sid=1294480 + +音乐用户简介 +www.bilibili.com/audio/music-service-c/web/user/info?uid= + +音乐用户状态数 +www.bilibili.com/audio/music-service-c/web/stat/user?uid=8775742 + +音乐获取地址 +www.bilibili.com/audio/music-service-c/web/url?sid=1294480 + +音频榜单 +www.bilibili.com/audio/music-service-c/web/home/list-rank?pn=1&ps=10 + +音频榜单明细 +www.bilibili.com/audio/music-service-c/web/home/hit-rank + +{ + "code":0, + "msg":"success", + "data":[ + #新歌榜歌单 + { + "menuId":10624, + "uid":32708543, + "uname":"大家的音乐姬", + "title":"每日新曲推荐(每日11:00更新)", + "cover":"http://i0.hdslb.com/bfs/music/a32c1ed4f6ec3f74f8240f4486a750dda3a509e5.jpg", + "intro":"每天11:00更新,为你推送最新音乐", + "type":2, + "off":0, + "ctime":1501209433, + "curtime":1582165425, + "statistic":{ + "sid":10624, + "play":1969454, + "collect":17525, + "comment":973, + "share":453 + }, + "snum":20, + "attr":0, + "isDefault":0, + "collectionId":0, + "audios":[ + { + "id":817499, + "title":"【ゆう十】好想爱这个世界啊", + "duration":264 + }, + #向下扩展 + ] + }, + #热歌榜歌单 + { + "menuId":10627, + "uid":32708543, + "uname":"大家的音乐姬", + "title":"热歌榜(每日11:00更新)", + "cover":"http://i0.hdslb.com/bfs/music/bc735b32ab123f7ddc602b9194defae2cd66062f.jpg", + "intro":"每日上午11:00更新,精选三日内热门投稿作品。", + "type":2, + "off":0, + "ctime":1501211353, + "curtime":1582165425, + "statistic":{ + "sid":10627, + "play":1536399, + "collect":8661, + "comment":323, + "share":145 + }, + "snum":19, + "attr":0, + "isDefault":0, + "collectionId":0, + "audios":[ + { + "id":829642, + "title":"曙光", + "duration":287 + }, + #向下扩展 + ] + }, + #原创榜歌单 + { + "menuId":10628, + "uid":32708543, + "uname":"大家的音乐姬", + "title":"原创榜(每日11:00更新)", + "cover":"http://i0.hdslb.com/bfs/music/58782504cefb307878d12422fd365ed7f971fad1.jpg", + "intro":"每日上午11:00更新,精选三日内原创投稿音乐。", + "type":2, + "off":0, + "ctime":1501211627, + "curtime":1582165425, + "statistic":{ + "sid":10628, + "play":262030, + "collect":1962, + "comment":260, + "share":71 + }, + "snum":20, + "attr":0, + "isDefault":0, + "collectionId":0, + "audios":[ + { + "id":829642, + "title":"曙光", + "duration":287 + }, + #向下扩展 + ] + } + ] +} + +------------------------------------------------- +#专栏相关 + +文集基本信息 +api.bilibili.com/x/article/list/web/articles?id= + +点赞专栏 (需要登录) +api.bilibili.com/x/article/like +方式:POST +参数: +参数名 aid type csrf +内容 专栏cvID 1点赞 2取消赞 CSRF Token(位于cookie) +必要性 必要 必要 必要 +{ + "code":0, + "message":"0", + "ttl":1 +} + +投币专栏 (需要登录) +api.bilibili.com/x/web-interface/coin/add +方式:POST +参数: +参数名 aid multiply upid avtype csrf +内容 专栏cvID 投币数量 上限为2 作者UID 必须为2 CSRF Token(位于cookie) +必要性 必要 必要 必要 必要 必要 +json回复 +{ + "code":0, + "message":"0", + "ttl":1, + "data":{ + "like":false + } +} + +收藏专栏 (需要登录) +api.bilibili.com/x/article/favorites/add +方式:POST +参数: +参数名 aid csrf +内容 专栏cvID CSRF Token(位于cookie) +必要性 必要 必要 +json回复 +{ + "code":0, + "message":"0", + "ttl":1 +} + + +------------------------------------------------- +#动态相关 +未读动态数 (需要登录) +api.vc.bilibili.com/dynamic_svr/v1/dynamic_svr/dynamic_num?rsp_type=1&uid=293793435&update_num_dy_id=360462659397144349&type_list=8,512 + +动态内容 (仅自己可见时需要登录) +api.vc.bilibili.com/dynamic_svr/v1/dynamic_svr/get_dynamic_detail +方式:GET +参数名 dynamic_id +内容 动态ID +必要性 必要 + +发表文字动态 (需要登录) +api.vc.bilibili.com/dynamic_svr/v1/dynamic_svr/create +方式:POST +参数: +type=必须为4 必要 +content=文字内容 必要 +extension=%7B%22emoji_type%22%3A1%7D 必要 +at_uids=需要at的uid 非必要 +ctrl=%5B%5D 非必要 + +{ + "code":(num:0成功 -6账号未登录 500103无内容), + "msg":(str:错误信息 默认为空), + "message":(str:错误信息 默认为空), + "data":{ + "result":0, + "errmsg":";Create dynamic 362109538834657119 OK, result:1; Push create kafka:0; Register comment result:0; Add outbox result:1; Send at_msg result:0", + "dynamic_id":(num:动态ID), + "create_result":1, + "dynamic_id_str":(str:动态ID), + "_gt_":0 + } +} + +发表相簿动态 (需要登录) +api.vc.bilibili.com/dynamic_svr/v1/dynamic_svr/create_draw +方式:POST +biz=必须为3 +category=必须为3 +type=必须为0 +pictures=%5B%7B%22img_src%22%3A%22http%3A%2F%2Fi0.hdslb.com%2Fbfs%2Falbum%2Fd0431e47263b56d1d0f6b59af0e5fedaefb5de74.jpg%22%2C%22img_width%22%3A695%2C%22img_height%22%3A1000%2C%22img_size%22%3A686.537109375%7D%2C%7B%22img_src%22%3A%22http%3A%2F%2Fi0.hdslb.com%2Fbfs%2Falbum%2F918db3bcacef6793c3ad2fe84dd804750c2052f5.png%22%2C%22img_width%22%3A1000%2C%22img_height%22%3A688%2C%22img_size%22%3A516.90625%7D%5D +title= +tags= +description=文字内容 +content=文字内容 +setting=%7B%22copy_forbidden%22%3A0%2C%22cachedTime%22%3A0%7D +from=必须为create.dynamic.web +extension=%7B%22emoji_type%22%3A1%7D +at_uids=需要at的uid 非必要 +at_control=%5B%5D +csrf_token=5e8178eeedd85fdae78a47cabad198a7 + +{ + "code":0, + "msg":"", + "message":"", + "data":{ + "doc_id":"59718150", + "dynamic_id":362117390040148339, + "dynamic_id_str":"362117390040148339", + "_gt_":0 + } +} + +发起投票 +api.vc.bilibili.com/vote_svr/v1/vote_svr/create_vote + + +发表定时动态 (需要登录) +api.vc.bilibili.com/dynamic_draft/v1/dynamic_draft/add_draft +方式:POST +type=4 +publish_time=1583159280 +request=%7B%22dynamic_id%22%3A0%2C%22type%22%3A4%2C%22rid%22%3A0%2C%22content%22%3A%22%E6%B5%8B%E8%AF%95%22%2C%22extension%22%3A%22%7B%5C%22emoji_type%5C%22%3A1%7D%22%2C%22at_uids%22%3A%22%22%2C%22ctrl%22%3A%22%5B%5D%22%7D&csrf_token=5e8178eeedd85fdae78a47cabad198a7 +{ + "code":0, + "msg":"", + "message":"", + "data":{ + "errmsg":"add draft succ.", + "draft_id":52393, + "_gt_":0 + } +} + +删除定时动态 (需要登录) +api.vc.bilibili.com/dynamic_draft/v1/dynamic_draft/rm_draft + +转载动态 (需要登录) +api.vc.bilibili.com/dynamic_repost/v1/dynamic_repost/repost +方式:POST +uid=293793435 +dynamic_id=362041815795291620 +content=%E5%B9%B2%E5%BE%97%E6%BC%82%E4%BA%AE%EF%BC%81 +extension=%7B%22emoji_type%22%3A1%7D +at_uids= +ctrl=%5B%5D +csrf_token=5e8178eeedd85fdae78a47cabad198a7 + +{ + "code":0, + "msg":"", + "message":"", + "data":{ + "result":0, + "errmsg":"符合条件,允许发布", + "_gt_":0 + } +} + + +删除动态 (需要登录) +api.vc.bilibili.com/dynamic_svr/v1/dynamic_svr/rm_dynamic +方式:POST +参数: +参数名 dynamic_id +内容 动态ID +必要性 必要 +json回复 +{ + "code":(num:0成功 -6账号未登录 500003参数错误 500404不能重复删除 500405动态ID不合法), + "msg":(str:错误信息 默认为空), + "message":(str:错误信息 默认为空), + "data":{ + "_gt_":0 + } +} + +点赞动态 (需要登录) +api.vc.bilibili.com/dynamic_like/v1/dynamic_like/thumb +方式:POST +uid=293793435 +dynamic_id=362113743614996443 +up=1 +csrf_token=5e8178eeedd85fdae78a47cabad198a7 +{ + "code":0, + "msg":"", + "message":"", + "data":{ + "_gt_":0 + } +} + +置顶动态 (需要登录) +api.vc.bilibili.com/dynamic_mix/v1/dynamic_mix/space_top_set +方式:GET +参数: +参数名 dynamic_id +内容 动态ID +必要性 必要 +无返回 + +取消置顶动态 (需要登录) +api.vc.bilibili.com/dynamic_mix/v1/dynamic_mix/space_top_rm +方式:GET +参数: +参数名 dynamic_id +内容 动态ID +必要性 必要 +无返回 + +搜索用户昵称 +api.vc.bilibili.com/dynamic_repost/v1/dynamic_repost/name_search?keyword= + +昵称转换UID +api.vc.bilibili.com/dynamic_mix/v1/dynamic_mix/name_to_uid?names=%E5%B0%8F%E6%9E%97%E5%AE%B6%E7%9A%84%E5%9E%83%E5%9C%BE%E7%8E%8BR&teenagers_mode=0 + +------------------------------------------------- +#直播相关 +最热直播间 +api.live.bilibili.com/room/v1/RoomRecommend/biliIndexRecList + +小图标 +https://www.bilibili.com/index/index-icon.json + +上传稿件封面 +POST +http://member.bilibili.com/x/vu/web/cover/up +data +cover: +csrf: + +活动 +GET +https://member.bilibili.com/x/app/h5/mission/type/v2?tid=194&from=0 + +验证TAG +GET +https://member.bilibili.com/x/app/h5/archive/tag/info?tag_name= + +提交投稿 +https://member.bilibili.com/x/vu/web/add +POST +url +csrf: +data +json: +{ + "copyright":1, + "videos":[ + { + "filename":"m200524a23m79uhneooxzh3q99xe8xsq", + "title":"【SN76489音源】异度侵入ID INVADED OP(ミスターフィクサー)_1", + "desc":"" + } + ], + "no_reprint":1, + "interactive":0, + "tid":分区tID, + "cover":"封面", + "title":"标题", + "tag":"TAG", + "desc_format_id":0, + "desc":"简介", + "dynamic":"同步动态内容", + "open_elec":允许充电, + "subtitle":{ + "open":允许提交字幕, + "lan":"" + } +} \ No newline at end of file diff --git a/README.md b/README.md index 39604df..2010db8 100644 --- a/README.md +++ b/README.md @@ -29,16 +29,16 @@ --- -计划整理分类&目录:(√代表已完成,x代表正在施工...) +计划整理分类&目录:(√代表已完成,x代表正在施工...)二级目录正在建设中..... - [API认证与鉴权(APP与Cookie方式)](other/API_auth.md)× - [图片格式化](other/picture.md)√ - [登录](login) - - [二维码登录](login/QR.md)√ - - [验证码登录](login/verify)√ + - [登录操作](login/login_action)√ + [短信登录](login/verify/SMS.md)√ + [密码登录](login/verify/password.md)√ - - qq&微博登录 + + [二维码登录](login/QR.md)√ + + SNS登录(QQ&微博) - [登录基本信息](login/login_info.md)√ - [个人中心](login/member_center.md)× - [消息中心](message) diff --git a/article/info.md b/article/info.md index 7948a35..c242d1a 100644 --- a/article/info.md +++ b/article/info.md @@ -4,7 +4,7 @@ > http://api.bilibili.com/x/article/viewinfo -*方式:GET* +*请求方式:GET* **url参数:** diff --git a/article/like_coin_fav.md b/article/like_coin_fav.md index f4d8ba3..0e8d19b 100644 --- a/article/like_coin_fav.md +++ b/article/like_coin_fav.md @@ -8,7 +8,7 @@ > http://api.bilibili.com/x/article/like -*方式:POST* +*请求方式:POST* **正文参数( application/x-www-form-urlencoded ):** @@ -50,7 +50,7 @@ curl -b "SESSDATA=xxx" -d "id=5806746&type=1&csrf=xxx" "http://api.bilibili.com/ > http://api.bilibili.com/x/web-interface/coin/add -*方式:POST* +*请求方式:POST* **正文参数( application/x-www-form-urlencoded ):** @@ -102,7 +102,7 @@ curl -b "SESSDATA=xxx" -d "aid=5806746&multiply=1&csrf=xxx" "http://api.bilibili >http://api.bilibili.com/x/article/favorites/add -*方式:POST* +*请求方式:POST* **正文参数( application/x-www-form-urlencoded ):** diff --git a/bangumi/info.md b/bangumi/info.md new file mode 100644 index 0000000..ae01132 --- /dev/null +++ b/bangumi/info.md @@ -0,0 +1,175 @@ +# 番剧基本信息 + +> http://api.bilibili.com/pgc/view/web/season + +*请求方式:GET* + +**参数:** + +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| --------- | ---- | -------- | ------ | ------------------------ | +| season_id | url | 番剧ssID | 非必要 | season_id与ep_id任选其一 | +| ep_id | url | 剧集epID | 非必要 | season_id与ep_id任选其一 | + +**json回复:** + +根对象: + +| 字段 | 类型 | 内容 | 备注 | +| ------- | ---- | -------- | ----------------------- | +| code | num | 返回值 | 0:成功
-404:错误 | +| message | str | 错误信息 | 默认为success | +| ttl | num | 1 | 作用尚不明确 | +| result | obj | 信息本体 | | + +`result`对象: + +| 字段 | 类型 | 内容 | 备注 | +| --------------- | ------ | -------------------------- | ------------------------------------------ | +| activity | obj | 参与的活动 | | +| alias | str | 空 | 作用尚不明确 | +| bkg_cover | str | 背景图片url | 无则为空 | +| cover | str | 封面图片url | | +| episodes | array | 剧集列表 | | +| evaluate | str | 简介 | | +| jp_title | str | 空 | 作用尚不明确 | +| link | str | 简介网址url | | +| media_id | num | 番剧mdID | | +| mode | num | | | +| new_ep | obj | 更新信息 | | +| payment | obj | 会员&付费信息 | 若无相关内容则无此项 | +| positive | obj | | | +| publish | obj | 发布信息 | | +| rating | obj | 评分信息 | 若无相关内容则无此项 | +| record | str | 备案号 | 无则为空 | +| rights | obj | 属性标志信息 | | +| season_id | num | 番剧ssID | | +| season_title | str | 标题 | | +| seasons | array | 同系列其他季 | 无则为空 | +| section | array | 花絮、PV、番外等非正片内容 | 若无相关内容则无此项 | +| series | obj | 系列信息 | | +| share_copy | str | 《标题》+签名 | | +| share_sub_title | str | 签名 | 无则为空 | +| share_url | str | 番剧播放页面url | | +| show | obj | 网页全屏标志 | | +| square_cover | str | 方形封面图片url | 若无相关内容则无此项 | +| stat | obj | 状态数 | | +| status | num | | | +| subtitle | str | 观看次数文字介绍 | | +| title | str | 标题 | | +| total | num | 总计集数 | 未完结:大多为-1
已完结:大多为正整数 | +| type | num | | | +| up_info | obj | UP主信息 | 若无相关内容则无此项 | + +`result`中的`activity`对象: + +| 字段 | 类型 | 内容 | 备注 | +| ----------- | ---- | -------- | ------------ | +| head_bg_url | str | 空 | 作用尚不明确 | +| id | num | 活动id | | +| title | str | 活动标题 | | + +`result`中的`episodes`数组: + + + +`result`中的`new_ep`对象: + +| 字段 | 类型 | 内容 | 备注 | +| ------ | ---- | ------------ | ---------------- | +| desc | str | 更新备注 | | +| id | num | 最新一话epID | | +| is_new | num | 是否最新发布 | 0:否
1:是 | +| title | str | 最新一话标题 | | + +`result`中的`payment`对象: + + + +`result`中的`positive`对象: + +| 字段 | 类型 | 内容 | 备注 | +| ----- | ---- | ---- | ---- | +| id | num | | | +| title | str | | | + +`result`中的`publish`对象: + +| 字段 | 类型 | 内容 | 备注 | +| --------------- | ---- | ---------------- | ------------------------ | +| is_finish | num | 完结状态 | 0:未完结
1:已完结 | +| is_started | num | 是否发布 | 0:未发布
1:已发布 | +| pub_time | str | 发布时间 | YYYY-MM-DDD hh:mm:ss | +| pub_time_show | str | 发布时间文字介绍 | | +| unknow_pub_date | num | 0 | 作用尚不明确 | +| weekday | num | 0 | 作用尚不明确 | + +`result`中的`rating`对象: + +| 字段 | 类型 | 内容 | 备注 | +| ----- | ---- | ------------ | ---- | +| count | num | 总计评分人数 | | +| score | num | 评分 | | + +`result`中的`rights`对象: + +| 字段 | 类型 | 内容 | 备注 | +| ----------------- | ---- | -------- | ------------------------------- | +| allow_bp | num | | | +| allow_bp_rank | num | | | +| allow_download | num | | | +| allow_review | num | | | +| area_limit | num | | | +| ban_area_show | num | | | +| can_watch | num | | | +| copyright | str | 版权标志 | bilibili:授权
dujia:独家 | +| forbid_pre | num | | | +| is_cover_show | num | | | +| is_preview | num | | | +| only_vip_download | num | | | +| resource | str | | | +| watch_platform | num | | | + +`result`中的`seasons`数组: + + + +`result`中的`section`数组: + + + +`result`中的`series`对象: + + + +`result`中的`show`对象: + +| 字段 | 类型 | 内容 | 备注 | +| ----------- | ---- | ------ | -------------------- | +| wide_screen | num | 投币数 | 0:正常
1:全屏 | + +`result`中的`stat`对象: + +| 字段 | 类型 | 内容 | 备注 | +| --------- | ---- | ------ | ---- | +| coins | num | 投币数 | | +| danmakus | num | 弹幕数 | | +| favorites | num | 收藏数 | | +| reply | num | 评论数 | | +| share | num | 分享数 | | +| views | num | 播放数 | | + +`result`中的`up_info`对象: + +| 字段 | 类型 | 内容 | 备注 | +| ----------- | ---- | ----------- | ---- | +| avatar | str | 头像图片url | | +| follower | num | 粉丝数 | | +| is_follow | num | | | +| mid | num | UP主UID | | +| pendant | obj | | | +| theme_type | num | | | +| uname | str | | | +| verify_type | num | | | +| vip_status | num | | | +| vip_type | num | | | \ No newline at end of file diff --git a/blackroom/banlist.md b/blackroom/banlist.md index ab67a99..dcff653 100644 --- a/blackroom/banlist.md +++ b/blackroom/banlist.md @@ -32,7 +32,7 @@ > http://api.bilibili.com/x/credit/blocked/list -*方式:GET* +*请求方式:GET* 每页最多10项 @@ -168,7 +168,7 @@ http://api.bilibili.com/x/credit/blocked/list?btype=&otype=0&pn=1 > http://api.bilibili.com/x/credit/blocked/info -*方式:GET* +*请求方式:GET* **url参数:** diff --git a/broadcast/general.md b/broadcast/general.md index dab0284..5bd709d 100644 --- a/broadcast/general.md +++ b/broadcast/general.md @@ -4,7 +4,7 @@ > http://api.bilibili.com/x/web-interface/broadcast/servers -*方式:GET* +*请求方式:GET* **url参数:** diff --git a/cheese/info.md b/cheese/info.md index 70441d0..39b98f5 100644 --- a/cheese/info.md +++ b/cheese/info.md @@ -16,7 +16,7 @@ > http://api.bilibili.com/pugv/view/web/season -*方式:GET* +*请求方式:GET* **url参数:** @@ -442,7 +442,7 @@ http://api.bilibili.com/pugv/view/web/season?season_id=61 > http://api.bilibili.com/pugv/view/web/ep/list -*方式:GET* +*请求方式:GET* **url参数:** diff --git a/cheese/videostream_url.md b/cheese/videostream_url.md index 415881a..bcd9c6a 100644 --- a/cheese/videostream_url.md +++ b/cheese/videostream_url.md @@ -6,7 +6,7 @@ > http://api.bilibili.com/pugv/player/web/playurl -*方式:GET* +*请求方式:GET* 本接口为课程视频专用,故与普通视频不互通 @@ -26,6 +26,7 @@ | ep_id | num | 课程epID | 必要 | | | cid | num | 视频CID | 必要 | | | qn | num | 视频清晰度选择 | 非必要 | 未登录默认32(480P)
登录默认64(720P)
**值含义见下表** | +| fourk | num | 是否允许4K视频 | 非必要 | 默认为0
画质最高1080P:0
画质最高4K:1 | 分辨率代码: @@ -131,7 +132,14 @@ 获取课程`ep790`(CID=`132105993`,avID=`76973173`)的视频流url,清晰度为1080P60 -http://api.bilibili.com/pugv/player/web/playurl?ep_id=790&avid=76973173&cid=132105993&qn=116 +```shell +curl -G 'http://api.bilibili.com/pugv/player/web/playurl'\ +--data-urlencode 'ep_id=790'\ +--data-urlencode 'avid=76973173'\ +--data-urlencode 'cid=132105993'\ +--data-urlencode 'qn=116'\ +-b 'SESSDATA=xxx' +``` ```json { @@ -234,6 +242,10 @@ http://api.bilibili.com/pugv/player/web/playurl?ep_id=790&avid=76973173&cid=1321 **以上述视频url为例:** -wget --referer "http://www.bilibili.com" "https://upos-sz-mirrorks3c.bilivideo.com/upgcxcode/93/59/132105993/132105993_da2-1-116.flv?e=ig8euxZM2rNcNbNghzTBhwdlhbNz7bUVhoNvNC8BqJIzNbfqXBvEqxTEto8BTrNvN0GvT90W5JZMkX_YN0MvXg8gNEV4NC8xNEV4N03eN0B5tZlqNxTEto8BTrNvNeZVuJ10Kj_g2UB02J0mN0B5tZlqNCNEto8BTrNvNC7MTX502C8f2jmMQJ6mqF2fka1mqx6gqj0eN0B599M=&uipk=5&nbs=1&deadline=1591596728&gen=playurl&os=ks3cbv&oi=606633803&trid=76bea9a9e56f4cb89a9aff2f8213c9acu&platform=pc&upsig=b271bf493bff32ffe62969582c8d18b4&uparams=e,uipk,nbs,deadline,gen,os,oi,trid,platform&mid=0&orderid=1,2&logo=40000000" -O video.flv +```shell +wget 'https://upos-sz-mirrorks3c.bilivideo.com/upgcxcode/93/59/132105993/132105993_da2-1-116.flv?e=ig8euxZM2rNcNbNghzTBhwdlhbNz7bUVhoNvNC8BqJIzNbfqXBvEqxTEto8BTrNvN0GvT90W5JZMkX_YN0MvXg8gNEV4NC8xNEV4N03eN0B5tZlqNxTEto8BTrNvNeZVuJ10Kj_g2UB02J0mN0B5tZlqNCNEto8BTrNvNC7MTX502C8f2jmMQJ6mqF2fka1mqx6gqj0eN0B599M=&uipk=5&nbs=1&deadline=1591596728&gen=playurl&os=ks3cbv&oi=606633803&trid=76bea9a9e56f4cb89a9aff2f8213c9acu&platform=pc&upsig=b271bf493bff32ffe62969582c8d18b4&uparams=e,uipk,nbs,deadline,gen,os,oi,trid,platform&mid=0&orderid=1,2&logo=40000000'\ +-e 'https://www.bilibili.com'\ +-O 'Download_video.flv' +``` -回复正文将返回一个flv文件的数据 \ No newline at end of file +响应正文将返回一个flv文件 \ No newline at end of file diff --git a/comment/action.md b/comment/action.md index 32dee0c..4a8bd47 100644 --- a/comment/action.md +++ b/comment/action.md @@ -8,7 +8,7 @@ > http://api.bilibili.com/x/v2/reply/add -*方式:POST* +*请求方式:POST* **正文参数( application/x-www-form-urlencoded ):** @@ -218,7 +218,7 @@ curl -b "SESSDATA=xxx" -d "type=1&oid=243322853&message=%E6%B5%8B%E8%AF%95test%5 > http://api.bilibili.com/x/v2/reply/action -*方式:POST* +*请求方式:POST* 点赞成功后会同时消去该评论的点踩 @@ -262,7 +262,7 @@ curl -b "SESSDATA=xxx" -d "type=1&oid=243322853&rpid=3039053308&action=1&csrf=xx > http://api.bilibili.com/x/v2/reply/hate -*方式:POST* +*请求方式:POST* 点踩成功后会同时消去该评论的点赞 @@ -306,7 +306,7 @@ curl -b "SESSDATA=xxx" -d "type=1&oid=243322853&rpid=3039053308&action=1&csrf=xx > http://api.bilibili.com/x/v2/reply/del -*方式:POST* +*请求方式:POST* 只能删除自己的评论,或自己管理的评论区下的评论 @@ -349,7 +349,7 @@ curl -b "SESSDATA=xxx" -d "type=1&oid=243322853&rpid=3039053308&csrf=xxx" "http: > http://api.bilibili.com/x/v2/reply/top -*方式:POST* +*请求方式:POST* 只能置顶自己管理的评论区中的一级评论 @@ -393,7 +393,7 @@ curl -b "SESSDATA=xxx" -d "type=1&oid=243322853&rpid=2940645593&action=1&csrf=xx > http://api.bilibili.com/x/v2/reply/report -*方式:POST* +*请求方式:POST* **正文参数( application/x-www-form-urlencoded ):** diff --git a/comment/comment_list.md b/comment/comment_list.md index b2764ef..49cd341 100644 --- a/comment/comment_list.md +++ b/comment/comment_list.md @@ -20,11 +20,11 @@ | 22 | 漫画 | 漫画mcID | | 33 | 课程 | 课程epID | -## 获取评论区明细1(无楼层号 web端) +## 获取评论区明细1(web端)(无楼层号) > http://api.bilibili.com/x/v2/reply -*方式:GET* +*请求方式:GET* **url参数:** @@ -2324,11 +2324,11 @@ -## 获取评论区明细2(带有楼层号 APP端) +## 获取评论区明细2(APP端)(带有楼层号 ) > http://api.bilibili.com/x/v2/reply/main -*方式:GET* +*请求方式:GET* **url参数:** @@ -4690,11 +4690,11 @@ http://api.bilibili.com/x/v2/reply/main?type=1&oid=2&mode=3&next=0&ps=5 -## 获取指定评论条目及二级回复明细1(分离结构 无楼层号 web端) +## 获取指定评论条目及二级回复明细1(web端)(分离结构 无楼层号) > http://api.bilibili.com/x/v2/reply/reply -*方式:GET* +*请求方式:GET* 按照热度排列 @@ -5412,11 +5412,11 @@ http://api.bilibili.com/x/v2/reply/reply?type=1&oid=2&root=476670&pn=1&ps=5 -## 获取指定评论条目及二级回复明细2(嵌套结构 带有楼层号 APP端) +## 获取指定评论条目及二级回复明细2(APP端)(嵌套结构 带有楼层号) > http://api.bilibili.com/x/v2/reply/detail -*方式:GET* +*请求方式:GET* 按照楼层排列 @@ -6155,11 +6155,11 @@ http://api.bilibili.com/x/v2/reply/reply?type=1&oid=2&root=476670&pn=1&ps=5 -## 获取指定评论对话树(带有楼层 客户端) +## 获取指定评论对话树(APP端)(带有楼层) > http://api.bilibili.com/x/v2/reply/dialog/cursor -*方式:GET* +*请求方式:GET* 按照楼层排列 @@ -7009,7 +7009,7 @@ data`对象: > http://api.bilibili.com/x/v2/reply/count -*方式:GET* +*请求方式:GET* **url参数:** diff --git a/creativecenter/railgun.md b/creativecenter/railgun.md index 0b909cd..efd380c 100644 --- a/creativecenter/railgun.md +++ b/creativecenter/railgun.md @@ -8,7 +8,7 @@ > http://member.bilibili.com/x/web/elec/user -*方式:GET* +*请求方式:GET* **json回复:** @@ -52,7 +52,7 @@ http://member.bilibili.com/x/web/elec/user > http://api.bilibili.com/studio/up-rating/rating/summary -*方式:GET* +*请求方式:GET* **json回复:** @@ -129,7 +129,7 @@ http://api.bilibili.com/studio/up-rating/rating/summary > http://api.bilibili.com/studio/up-rating/rating/history -*方式:GET* +*请求方式:GET* **url参数:** diff --git a/creativecenter/statistics&data.md b/creativecenter/statistics&data.md index 481ae63..e60e569 100644 --- a/creativecenter/statistics&data.md +++ b/creativecenter/statistics&data.md @@ -8,7 +8,7 @@ > http://member.bilibili.com/x/web/index/stat -*方式:GET* +*请求方式:GET* **json回复:** @@ -160,7 +160,7 @@ http://member.bilibili.com/x/web/index/stat > http://member.bilibili.com/x/web/data/article -*方式:GET* +*请求方式:GET* **json回复:** @@ -222,7 +222,7 @@ http://member.bilibili.com/x/web/data/article > http://member.bilibili.com/x/web/data/article/thirty -*方式:GET* +*请求方式:GET* 数据为前30天 @@ -313,7 +313,7 @@ http://member.bilibili.com/x/web/data/pandect?type=1 > http://member.bilibili.com/x/web/data/article/thirty -*方式:GET* +*请求方式:GET* 数据为前30天 @@ -399,7 +399,7 @@ http://member.bilibili.com/x/web/data/article/thirty?type=1 > http://member.bilibili.com/x/web/data/survey -*方式:GET* +*请求方式:GET* 数据为上一天的 @@ -531,7 +531,7 @@ http://member.bilibili.com/x/web/data/survey?type=1 > http://member.bilibili.com/x/web/data/playsource -*方式:GET* +*请求方式:GET* **json回复:** @@ -607,7 +607,7 @@ http://member.bilibili.com/x/web/data/playsource > http://member.bilibili.com/x/web/data/base -*方式:GET* +*请求方式:GET* **json回复:** diff --git a/danmaku/action.md b/danmaku/action.md index fde0030..6d94eab 100644 --- a/danmaku/action.md +++ b/danmaku/action.md @@ -4,7 +4,7 @@ > http://api.bilibili.com/x/v2/dm/post -*方式:POST* +*请求方式:POST* 需要登录(SESSDATA) @@ -73,7 +73,7 @@ curl -b "SESSDATA=xxx" -d "type=1&oid=62131&msg=%e5%89%8d%e6%9d%a5%e8%80%83%e5%8 > http://api.bilibili.com/x/dm/recall -*方式:POST* +*请求方式:POST* 仅能撤回自己两分钟内的弹幕,且每天只有3次机会 @@ -116,7 +116,7 @@ curl -b "SESSDATA=xxx" -d "dmid=32310301474947077&cid=168901231&csrf=xxx" "http: > http://api.bilibili.com/x/dm/adv/buy -*方式:POST* +*请求方式:POST* 需要登录(SESSDATA) @@ -159,7 +159,7 @@ curl -b "SESSDATA=xxx" -d "mode=sp&cid=168901231&csrf=xxx" "http://api.bilibili. > http://api.bilibili.com/x/dm/adv/state -*方式:GET* +*请求方式:GET* 需要登录(SESSDATA) diff --git a/danmaku/danmaku_xml.md b/danmaku/danmaku_xml.md index 3d9e0b1..89c612c 100644 --- a/danmaku/danmaku_xml.md +++ b/danmaku/danmaku_xml.md @@ -6,7 +6,7 @@ > http://api.bilibili.com/x/v1/dm/list.so -*方式:GET* +*请求方式:GET* **使用deflate压缩,注意解码** @@ -24,7 +24,7 @@ http://api.bilibili.com/x/v1/dm/list.so?oid=144541892 > http://comment.bilibili.com/{cid}.xml -*方式:GET* +*请求方式:GET* 效果与前者相同 diff --git a/danmaku/history.md b/danmaku/history.md index 51ff93d..5793fe9 100644 --- a/danmaku/history.md +++ b/danmaku/history.md @@ -6,7 +6,7 @@ > http://api.bilibili.com/x/v2/dm/history/index -*方式:GET* +*请求方式:GET* **url参数:** @@ -79,7 +79,7 @@ http://api.bilibili.com/x/v2/dm/history/index?type=1&oid=144541892&month=2019-12 > http://api.bilibili.com/x/v2/dm/history -*方式:GET* +*请求方式:GET* 结果为标准xml格式弹幕 diff --git a/danmaku/snapshot.md b/danmaku/snapshot.md index 45f7ff3..7e22ae0 100644 --- a/danmaku/snapshot.md +++ b/danmaku/snapshot.md @@ -4,7 +4,7 @@ > http://api.bilibili.com/x/v2/dm/ajax -*方式:GET* +*请求方式:GET* 最近产生的几条弹幕内容,**最多20条** diff --git a/dynamic/publish.md b/dynamic/publish.md index f3d5760..65a7e1a 100644 --- a/dynamic/publish.md +++ b/dynamic/publish.md @@ -1,10 +1,10 @@ # 发布动态 -## 为动态(画友)上传图片 +## 为图片动态(相簿)上传图片 > http://api.vc.bilibili.com/api/v1/drawImage/upload -*方式:POST* +*请求方式:POST* 需要登录(SESSDATA) diff --git a/electric/Bcoin.md b/electric/Bcoin.md index f225955..ebcf9d3 100644 --- a/electric/Bcoin.md +++ b/electric/Bcoin.md @@ -6,7 +6,7 @@ > http://api.bilibili.com/x/ugcpay/trade/elec/pay/quick -*方式:POST* +*请求方式:POST* 需要登录(SESSDATA) diff --git a/electric/WeChat&Alipay.md b/electric/WeChat&Alipay.md index a494946..4b155d8 100644 --- a/electric/WeChat&Alipay.md +++ b/electric/WeChat&Alipay.md @@ -18,7 +18,7 @@ > http://api.bilibili.com/x/ugcpay/trade/elec/pay/qr_code/create -*方式:POST* +*请求方式:POST* 秘钥有效时间为10分钟 @@ -77,7 +77,7 @@ curl -b "SESSDATA=xxx" -d "up_mid=23215368&elec_num=10&is_bp_remains_prior=false > http://api.bilibili.com/x/ugcpay/trade/elec/pay/order/status -*方式:GET* +*请求方式:GET* **url参数:** diff --git a/electric/charge_list.md b/electric/charge_list.md index e65d373..8b4bf9b 100644 --- a/electric/charge_list.md +++ b/electric/charge_list.md @@ -4,7 +4,7 @@ > http://elec.bilibili.com/api/query.rank.do -*方式:GET* +*请求方式:GET* **url参数:** @@ -135,7 +135,7 @@ > http://api.bilibili.com/x/web-interface/elec/show -*方式:GET* +*请求方式:GET* **url参数:** diff --git a/electric/charge_msg.md b/electric/charge_msg.md index 212158a..2672f68 100644 --- a/electric/charge_msg.md +++ b/electric/charge_msg.md @@ -2,7 +2,7 @@ > http://api.bilibili.com/x/ugcpay/trade/elec/message -*方式:POST* +*请求方式:POST* 需要登录(SESSDATA) diff --git a/emote/action.md b/emote/action.md index 4025b54..e63f4ff 100644 --- a/emote/action.md +++ b/emote/action.md @@ -6,7 +6,7 @@ > http://api.bilibili.com/x/emote/package/add -*方式:POST* +*请求方式:POST* 只能添加有会员权限或已购买的表情包 @@ -48,7 +48,7 @@ curl -b "SESSDATA=xxx" -d "package_id=25&business=reply&csrf=xxx" "http://api.bi > http://api.bilibili.com/x/emote/package/remove -*方式:POST* +*请求方式:POST* **正文参数( application/x-www-form-urlencoded ):** diff --git a/emote/emote_list.md b/emote/emote_list.md index 46303cb..b3ed6c5 100644 --- a/emote/emote_list.md +++ b/emote/emote_list.md @@ -4,7 +4,7 @@ > http://api.bilibili.com/x/emote/user/panel/web -*方式:GET* +*请求方式:GET* 使用登录(SESSDATA)进行会员专属及已购买表情包的分发,否则为免费表情包 @@ -211,7 +211,7 @@ > http://api.bilibili.com/x/emote/package -*方式:GET* +*请求方式:GET* **url参数:** @@ -497,7 +497,7 @@ > http://api.bilibili.com/x/emote/setting/panel -*方式:GET* +*请求方式:GET* 需要登录(SESSDATA) diff --git a/history&toview/history.md b/history&toview/history.md index 6569889..dbec1a7 100644 --- a/history&toview/history.md +++ b/history&toview/history.md @@ -8,7 +8,7 @@ >http://api.bilibili.com/x/web-interface/history/cursor -*方式:GET* +*请求方式:GET* **url参数:** @@ -339,7 +339,7 @@ > http://api.bilibili.com/x/v2/history -*方式:GET* +*请求方式:GET* **url参数:** @@ -702,7 +702,7 @@ http://api.bilibili.com/x/v2/history?ps=5&pn=1 > http://api.bilibili.com/x/v2/history/delete -*方式:POST* +*请求方式:POST* **正文参数( application/x-www-form-urlencoded ):** @@ -741,7 +741,7 @@ curl -b "SESSDATA=xxx" -d "kid=archive_540580868&csrf=xxx" "http://api.bilibili. > http://api.bilibili.com/x/v2/history/clear -*方式:POST* +*请求方式:POST* **正文参数( application/x-www-form-urlencoded ):** @@ -779,7 +779,7 @@ curl -b "SESSDATA=xxx" -d "csrf=xxx" "http://api.bilibili.com/x/v2/history/clear > http://api.bilibili.com/x/v2/history/shadow/set -*方式:POST* +*请求方式:POST* 该操作不会影响原有历史记录 @@ -820,7 +820,7 @@ curl -b "SESSDATA=xxx" -d "switch=true&csrf=xxx" "http://api.bilibili.com/x/v2/h > http://api.bilibili.com/x/v2/history/shadow -*方式:GET* +*请求方式:GET* **json回复:** diff --git a/history&toview/toview.md b/history&toview/toview.md index b4bb4c4..81a34bd 100644 --- a/history&toview/toview.md +++ b/history&toview/toview.md @@ -6,7 +6,7 @@ >http://api.bilibili.com/x/v2/history/toview/add -*方式:POST* +*请求方式:POST* 需要登录(SESSDATA) @@ -52,7 +52,7 @@ curl -b "SESSDATA=xxx" -d "aid=41687433&csrf=xxx" "http://api.bilibili.com/x/v2/ > http://space.bilibili.com/ajax/channel/addAllToView -*方式:POST* +*请求方式:POST* 需要登录(SESSDATA) @@ -100,7 +100,7 @@ curl --referer "http://.bilibili.com" -b "SESSDATA=xxx;DedeUserID=1;DedeUserID__ > http://api.bilibili.com/x/v2/history/toview -*方式:GET* +*请求方式:GET* 需要登录(SESSDATA) @@ -378,7 +378,7 @@ http://api.bilibili.com/x/v2/history/toview > http://api.bilibili.com/x/v2/history/toview/del -*方式:POST* +*请求方式:POST* 需要登录(SESSDATA) @@ -432,7 +432,7 @@ curl -b "SESSDATA=xxx" -d "viewed=true&csrf=xxx" "http://api.bilibili.com/x/v2/h > http://api.bilibili.com/x/v2/history/toview/clear -*方式:POST* +*请求方式:POST* 需要登录(SESSDATA) diff --git a/live/info.md b/live/info.md index 424a471..f9b9c56 100644 --- a/live/info.md +++ b/live/info.md @@ -4,7 +4,7 @@ > http://api.live.bilibili.com/room/v1/Room/getRoomInfoOld -*方式:GET* +*请求方式:GET* **url参数:** diff --git a/live/info_flow.md b/live/info_flow.md new file mode 100644 index 0000000..d87a550 --- /dev/null +++ b/live/info_flow.md @@ -0,0 +1,169 @@ +# 直播间信息流 + + + +## 数据包格式 + +数据包为websocket,格式为头部数据+正文数据 + +操作流程: + +发送认证包->接收认证包回应->接收普通包&(每30秒发送心跳包->接收心跳回应) + +头部格式: + +| 偏移量 | 长度 | 类型 | 含义 | +| ------ | ---- | ------ | ------------------------------------------------------------ | +| 0 | 4 | uint32 | 封包总大小(头部大小+正文大小) | +| 4 | 2 | uint16 | 头部大小(一般为0x0010,16字节) | +| 6 | 2 | uint16 | 协议版本:
0普通包正文不使用压缩
1心跳及认证包正文不使用压缩
2普通包正文使用zlib压缩 | +| 8 | 4 | uint32 | 操作码(封包类型) | +| 12 | 4 | uint32 | sequence,可以取常数1 | + +操作码: + +| 代码 | 含义 | +| ---- | -------------------- | +| 2 | 心跳包 | +| 3 | 心跳包回复(人气值) | +| 5 | 普通包(命令) | +| 7 | 认证包 | +| 8 | 认证包回复 | + +### 认证包 + +方式:(上行) + +连接成功后5秒内发送,否则强制断开连接 + +正文: + +json格式 + +| 字段 | 类型 | 内容 | 备注 | +| --------- | ---- | ------------ | -------------- | +| uid | num | 用户UID | 不可为0 | +| roomid | num | 加入房间的ID | | +| protover | num | 协议版本 | 现在是2 | +| platform | str | 平台标识 | 可为"web" | +| clientver | str | 客户端版本 | 现在是"1.10.3" | +| type | num | 必须为2 | | +| key | str | 认证秘钥 | | + +示例: + +``` +00000000 00 00 00 f0 00 10 00 01 00 00 00 07 00 00 00 01 |................| +00000010 7b 22 75 69 64 22 3a 32 39 33 37 39 33 34 33 35 |{"uid":293793435| +00000020 2c 22 72 6f 6f 6d 69 64 22 3a 32 31 36 38 36 32 |,"roomid":216862| +00000030 33 37 2c 22 70 72 6f 74 6f 76 65 72 22 3a 32 2c |37,"protover":2,| +00000040 22 70 6c 61 74 66 6f 72 6d 22 3a 22 77 65 62 22 |"platform":"web"| +00000050 2c 22 63 6c 69 65 6e 74 76 65 72 22 3a 22 31 2e |,"clientver":"1.| +00000060 31 30 2e 33 22 2c 22 74 79 70 65 22 3a 32 2c 22 |10.3","type":2,"| +00000070 6b 65 79 22 3a 22 43 6f 4b 68 5f 61 49 46 42 6c |key":"CoKh_aIFBl| +00000080 51 32 4c 57 77 64 79 4e 43 6b 2d 69 5f 42 76 72 |Q2LWwdyNCk-i_Bvr| +00000090 64 72 72 55 4d 32 78 57 6c 74 62 35 77 6b 54 50 |drrUM2xWltb5wkTP| +000000a0 4e 72 44 55 49 2d 73 46 32 41 56 56 4f 44 78 43 |NrDUI-sF2AVVODxC| +000000b0 52 42 39 69 64 76 74 34 46 32 4d 50 31 45 4a 6c |RB9idvt4F2MP1EJl| +000000c0 4d 68 49 57 6b 31 5a 69 73 67 6e 32 67 67 66 6c |MhIWk1Zisgn2ggfl| +000000d0 68 72 65 6e 4f 4b 65 39 7a 56 65 6d 78 35 7a 5f |hrenOKe9zVemx5z_| +000000e0 5a 4d 43 61 55 77 4c 31 65 70 6d 7a 5a 53 22 7d |ZMCaUwL1epmzZS"}| +``` + + + +### 认证包回复 + +方式:(下行) + +在认证包发送成功后就会收到 + +json格式 + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ------ | --------- | +| code | num | 返回值 | 0认证成功 | + +示例: + +``` +00000000 00 00 00 1a 00 10 00 01 00 00 00 08 00 00 00 01 |................| +00000010 7b 22 63 6f 64 65 22 3a 30 7d |{"code":0}| +``` + + + +### 心跳包 + +方式:(上行) + +30秒左右发送一次,否则60秒后会被强制断开连接 + +正文: + +特定字符 + +[object Object] + +示例: + +``` +00000000 00 00 00 1f 00 10 00 01 00 00 00 02 00 00 00 01 |................| +00000010 5b 6f 62 6a 65 63 74 20 4f 62 6a 65 63 74 5d |[object Object]| +``` + +### 心跳回应(人气值) + +方式:(下行) + +在心跳包发送成功后就会收到 + +正文: + +uint32整数,代表房间当前的人气值 + +示例: + +``` +00000000 00 00 00 14 00 10 00 01 00 00 00 03 00 00 00 01 |................| +00000010 00 00 14 83 |....| +``` + +可见房间内人气值为5251人 + +### 普通包 + +方式:(下行) + +#### 弹幕 + + + +#### 送礼 + + + +#### 欢迎加入房间 + + + +#### 欢迎房管加入房间 + + + +#### 系统消息 + + + +#### 主播准备中 + + + +#### 直播开始 + + + +#### 直播状态更新 + + + diff --git a/live/live_area.md b/live/live_area.md index 335f6d9..0b3eb9a 100644 --- a/live/live_area.md +++ b/live/live_area.md @@ -4,7 +4,7 @@ > http://api.live.bilibili.com/room/v1/Area/getList -*方式:GET* +*请求方式:GET* 直播分区共有两级,分别是父分区和子分区 diff --git a/live/manage.md b/live/manage.md index ca3b26a..1dca523 100644 --- a/live/manage.md +++ b/live/manage.md @@ -6,7 +6,7 @@ > http://api.live.bilibili.com/room/v1/Room/update -*方式:POST* +*请求方式:POST* 还需验证cookie中`bili_jct`的值正确并与`csrf`相同 @@ -50,7 +50,7 @@ curl -b "SESSDATA=xxx;bili_jct=xxx" -d "room_id=10352053&title=%E6%B5%8B%E8%AF%9 > http://api.live.bilibili.com/room/v1/Room/startLive -*方式:POST* +*请求方式:POST* 还需验证cookie中`bili_jct`的值正确并与`csrf`相同 @@ -179,7 +179,7 @@ curl -b "SESSDATA=xxx;bili_jct=xxx" -d "room_id=10352053&area_v2=27&platform=pc& > http://api.live.bilibili.com/room/v1/Room/stopLive -*方式:POST* +*请求方式:POST* 还需验证cookie中`bili_jct`的值正确并与`csrf`相同 diff --git a/login/QR.md b/login/login_action/QR.md similarity index 94% rename from login/QR.md rename to login/login_action/QR.md index b3cdb7f..1def912 100644 --- a/login/QR.md +++ b/login/login_action/QR.md @@ -17,7 +17,7 @@ > http://passport.bilibili.com/qrcode/getLoginUrl -*方式:GET* +*请求方式:GET* 密钥超时为180秒 @@ -43,7 +43,10 @@ 用申请到的`data`.`url`中的值生成二维码,等待手机客户端扫描,并将`data`.`oauthKey`保存等待使用 -http://passport.bilibili.com/qrcode/getLoginUrl +```shell +curl 'http://passport.bilibili.com/qrcode/getLoginUrl' +``` + ```json { "code": 0, @@ -56,13 +59,11 @@ http://passport.bilibili.com/qrcode/getLoginUrl } ``` - - -## 验证二维码登录 +## 使用扫码登录(验证扫码状态) > http://passport.bilibili.com/qrcode/getLoginInfo -*方式:POST* +*请求方式:POST* 密钥超时为180秒 @@ -96,7 +97,13 @@ data 对象: **示例:** -curl -d "oauthKey=xxx" "http://passport.bilibili.com/qrcode/getLoginInfo" +例如扫码秘钥为`23333` + +```shell +curl "http://passport.bilibili.com/qrcode/getLoginInfo"\ +--data-urlencode 'oauthKey=23333'\ +-c 'cookie.txt' +``` 当密钥正确时但未扫描时`status`为`false`,`data`为num值`-4` diff --git a/login/verify/SMS.md b/login/login_action/SMS.md similarity index 96% rename from login/verify/SMS.md rename to login/login_action/SMS.md index c27120e..e6d5bcb 100644 --- a/login/verify/SMS.md +++ b/login/login_action/SMS.md @@ -10,7 +10,7 @@ web端短信登录流程: > http://passport.bilibili.com/web/generic/country/list -*方式:GET* +*请求方式:GET* **json回复:** @@ -90,7 +90,7 @@ curl 'http://passport.bilibili.com/web/generic/country/list' > http://passport.bilibili.com/web/sms/general/v2/send -*方式:POST* +*请求方式:POST* 短信发送CD时间为60s @@ -123,7 +123,7 @@ curl 'http://passport.bilibili.com/web/generic/country/list' 例如手机号为`13888888888`,国际ID为`1(中国大陆)`,登录秘钥为`aabbccdd`,极验challenge为`2333`,极验结果为`666666`,进行发送短信验证码操作 ```shell -curl --request POST 'http://passport.bilibili.com/web/sms/general/v2/send' \ +curl 'http://passport.bilibili.com/web/sms/general/v2/send' \ --data-urlencode 'tel=13888888888'\ --data-urlencode 'cid=1'\ --data-urlencode 'type=21'\ @@ -140,11 +140,11 @@ curl --request POST 'http://passport.bilibili.com/web/sms/general/v2/send' \ } ``` -## 验证短信登录操作(web端) +## 使用短信验证码登录(web端) > http://passport.bilibili.com/web/login/rapid -*方式:POST* +*请求方式:POST* 验证登录成功后会进行设置以下cookie项: @@ -182,7 +182,7 @@ curl --request POST 'http://passport.bilibili.com/web/sms/general/v2/send' \ 使用手机号`13888888888`,短信验证码为`123456`,进行验证登录操作 ```shell -curl --request POST 'https://passport.bilibili.com/web/login/rapid' +curl 'https://passport.bilibili.com/web/login/rapid' --data-urlencode 'cid=1'\ --data-urlencode 'tel=13888888888'\ --data-urlencode 'smsCode=123456' diff --git a/login/verify/password.md b/login/login_action/password.md similarity index 96% rename from login/verify/password.md rename to login/login_action/password.md index 3f876a3..c264f04 100644 --- a/login/verify/password.md +++ b/login/login_action/password.md @@ -10,7 +10,7 @@ web端密码登录流程: > http://passport.bilibili.com/login?act=getkey -*方式:GET* +*请求方式:GET* **json回复:** @@ -38,7 +38,7 @@ curl 'http://passport.bilibili.com/login?act=getkey' > http://passport.bilibili.com/api/oauth2/getKey -*方式:POST* +*请求方式:POST* **正文参数( application/x-www-form-urlencoded ):** @@ -59,7 +59,7 @@ curl 'http://passport.bilibili.com/login?act=getkey' **示例:** ```shell -curl --request POST 'http://passport.bilibili.com/api/oauth2/getKey'\ +curl 'http://passport.bilibili.com/api/oauth2/getKey'\ --data-urlencode 'appkey=1d8b6e7d45233436'\ --data-urlencode 'sign=17004c193f688f0b5665c1068e733aff' ``` @@ -75,7 +75,7 @@ curl --request POST 'http://passport.bilibili.com/api/oauth2/getKey'\ **注:RSA公钥一般为固定值** -```plaintext +``` -----BEGIN PUBLIC KEY----- MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDjb4V7EidX/ym28t2ybo0U6t0n 6p4ej8VjqKHg100va6jkNbNTrLQqMCQCAYtXMXXp2Fwkk6WR+12N9zknLjf+C9sx @@ -86,19 +86,19 @@ Xl69GV6klzgxW6d2xQIDAQAB 例如登录密码为: -```plaintext +``` BiShi22332323 ``` 获取到的盐值为: -```plaintext +``` 8e0db05c46f4052c ``` 那么按照`盐值`+`密码字串`连接二者得到: -```plaintext +``` 8e0db05c46f4052cBiShi22332323 ``` @@ -106,15 +106,15 @@ BiShi22332323 因为公钥的**无法解密性**和盐值的**超时机制**,故无法本地验证加密结果 -```plaintext +``` YgpjxAQ22pKa9socHIKPCZX0a/NS6Ng9Zzy+rp16b0LJGT6RHw2ERs3+ijCpG96PKTY1Baavwf0xgotmNvpl25l1KO5y4AjcqeWTzNTSVn6ejonBXGmBMybHHYawJ0aMPn1eDGpKrbI91mrF+h2x+fsnnpuZ1gheiYGzFmtshUc= ``` -## 验证密码登录操作(web端) +## 使用账号密码登录(web端) > http://passport.bilibili.com/web/login/v2 -*方式:POST* +*请求方式:POST* 验证登录成功后会进行设置以下cookie项: @@ -164,7 +164,7 @@ YgpjxAQ22pKa9socHIKPCZX0a/NS6Ng9Zzy+rp16b0LJGT6RHw2ERs3+ijCpG96PKTY1Baavwf0xgotm 例如用户账号为`12345678900`,加密后的密码为`xxx`,登录秘钥为`aabbccdd`,极验challenge为`2333`,极验结果为`666666`,进行验证登录操作 ```shell -curl --request POST 'https://passport.bilibili.com/web/login/v2'\ +curl 'https://passport.bilibili.com/web/login/v2'\ --data-urlencode 'captchaType=6'\ --data-urlencode 'username=12345678900'\ --data-urlencode 'password=xxx'\ diff --git a/login/verify/readme.md b/login/login_action/readme.md similarity index 89% rename from login/verify/readme.md rename to login/login_action/readme.md index cb03e38..e6707c7 100644 --- a/login/verify/readme.md +++ b/login/login_action/readme.md @@ -1,7 +1,15 @@ -# 验证码登录 +# 登录操作 人机验证方式登录包含**账号密码登录**与手**机短信验证码登录** +**注:扫码登录**不需要进行**人机验证**,故**不使用**以下接口 + +## 扫码登录 + +- [扫码登录](QR.md) + +## 验证登录 + 人机验证流程: 1. 请求验证码参数,得到登录密钥`key`与极验ID`gt`和极验KEY`challenge` @@ -9,11 +17,11 @@ 3. 返回验证结果`validate`与`seccode`,进行短信或密码登录 -## 申请验证码参数 +### 申请验证码参数 > http://passport.bilibili.com/web/captcha/combine?plat=6 -*方式:GET* +*请求方式:GET* **json回复:** @@ -61,7 +69,7 @@ curl 'https://passport.bilibili.com/web/captcha/combine?plat=6' ``` -## 进行验证 +### 进行验证 本文档为Bilibili文档,验证码为geetest极验提供,故不提供api @@ -74,7 +82,7 @@ curl 'https://passport.bilibili.com/web/captcha/combine?plat=6' 4. 使用最开始获得到的`key`、`challenge`和刚获得到的`validate`、`seccode`继续之后的登录操作 -## 继续登录 +### 继续登录 - [短信登录](SMS.md) - [密码登录](password.md) diff --git a/login/login_info.md b/login/login_info.md index cdf4c30..38683c8 100644 --- a/login/login_info.md +++ b/login/login_info.md @@ -8,7 +8,7 @@ > > http://api.bilibili.com/x/web-interface/nav (原始数据) -*方式:GET* +*请求方式:GET* **json回复:** @@ -179,7 +179,7 @@ http://api.bilibili.com/x/web-interface/nav > http://account.bilibili.com/home/userInfo -*方式:GET* +*请求方式:GET* 需要验证DedeUserID存在且不为0 @@ -257,7 +257,7 @@ http://account.bilibili.com/home/userInfo > http://api.bilibili.com/x/web-interface/nav/stat -*方式:GET* +*请求方式:GET* **json回复:** diff --git a/login/member_center.md b/login/member_center.md index 3fb9ff9..b1993b3 100644 --- a/login/member_center.md +++ b/login/member_center.md @@ -6,7 +6,7 @@ > http://api.bilibili.com/x/member/web/account -*方式:GET* +*请求方式:GET* **json回复:** @@ -60,7 +60,7 @@ http://api.bilibili.com/x/member/web/account > http://api.bilibili.com/x/member/web/exp/reward -*方式:GET* +*请求方式:GET* **json回复:** @@ -114,7 +114,7 @@ http://api.bilibili.com/x/member/web/exp/reward > http://api.bilibili.com/x/vip/web/user/info -*方式:GET* +*请求方式:GET* **json回复:** @@ -164,7 +164,7 @@ http://api.bilibili.com/x/vip/web/user/info > http://passport.bilibili.com/web/site/user/info -*方式:GET* +*请求方式:GET* 需要验证`DedeUserID`存在且不为0 @@ -260,7 +260,7 @@ http://passport.bilibili.com/web/site/user/info > http://api.bilibili.com/x/member/realname/status -*方式:GET* +*请求方式:GET* **json回复:** @@ -302,7 +302,7 @@ http://api.bilibili.com/x/member/realname/status > http://api.bilibili.com/x/member/realname/apply/status -*方式:GET* +*请求方式:GET* **json回复:** @@ -348,7 +348,7 @@ http://api.bilibili.com/x/member/realname/apply/status > http://api.bilibili.com/x/member/web/coin/log -*方式:GET* +*请求方式:GET* 仅能查询最近一周的情况 diff --git a/message/msg.md b/message/msg.md index 348e5c2..615a73a 100644 --- a/message/msg.md +++ b/message/msg.md @@ -6,7 +6,7 @@ > http://api.bilibili.com/x/msgfeed/unread -*方式:GET* +*请求方式:GET* **json回复:** diff --git a/message/private_msg.md b/message/private_msg.md index da53232..b1a5342 100644 --- a/message/private_msg.md +++ b/message/private_msg.md @@ -6,7 +6,7 @@ > http://api.vc.bilibili.com/session_svr/v1/session_svr/single_unread -*方式:GET* +*请求方式:GET* **json回复:** diff --git a/music/coin&fav.md b/music/coin&fav.md index 8b3c84b..38e50be 100644 --- a/music/coin&fav.md +++ b/music/coin&fav.md @@ -6,7 +6,7 @@ > http://www.bilibili.com/audio/music-service-c/web/collections/songs-coll -*方式:GET* +*请求方式:GET* **url参数:** @@ -44,7 +44,7 @@ http://www.bilibili.com/audio/music-service-c/web/collections/songs-coll?sid=135 > http://www.bilibili.com/audio/music-service-c/web/coin/audio -*方式:GET* +*请求方式:GET* **url参数:** diff --git a/music/info.md b/music/info.md index 45fb2d8..d039a7a 100644 --- a/music/info.md +++ b/music/info.md @@ -4,7 +4,7 @@ > http://www.bilibili.com/audio/music-service-c/web/song/info -*方式:GET* +*请求方式:GET* **url参数:** @@ -138,7 +138,7 @@ http://www.bilibili.com/audio/music-service-c/web/song/info?sid=13598 > http://www.bilibili.com/audio/music-service-c/web/tag/song -*方式:GET* +*请求方式:GET* **url参数:** @@ -230,7 +230,7 @@ http://www.bilibili.com/audio/music-service-c/web/tag/song?sid=15664 > http://www.bilibili.com/audio/music-service-c/web/member/song -*方式:GET* +*请求方式:GET* **url参数:** @@ -360,7 +360,7 @@ http://www.bilibili.com/audio/music-service-c/web/member/song?sid=815861 > http://www.bilibili.com/audio/music-service-c/web/song/lyric -*方式:GET* +*请求方式:GET* 同「查询歌曲基本信息」中的lrc歌词 diff --git a/music/music_list.md b/music/music_list.md index 5813292..d75c350 100644 --- a/music/music_list.md +++ b/music/music_list.md @@ -4,7 +4,7 @@ > https://www.bilibili.com/audio/music-service-c/web/collections/list -*方式:GET* +*请求方式:GET* 需要登录(SESSDATA)及验证DedeUserID存在且不为0 @@ -162,7 +162,7 @@ > https://www.bilibili.com/audio/music-service-c/web/collections/info -*方式:GET* +*请求方式:GET* 需要登录(SESSDATA)及验证DedeUserID存在且不为0 diff --git a/music/status_number.md b/music/status_number.md index d2cb596..8bcdaaa 100644 --- a/music/status_number.md +++ b/music/status_number.md @@ -4,7 +4,7 @@ >http://www.bilibili.com/audio/music-service-c/web/stat/song -*方式:GET* +*请求方式:GET* 唯缺投币数2333333 diff --git a/other/API_auth.md b/other/API_auth.md index 971ea08..b750343 100644 --- a/other/API_auth.md +++ b/other/API_auth.md @@ -1,6 +1,6 @@ # API认证与鉴权 -## cookie方式 +## Cookie方式 cookie中的值在访问登录接口成功登录时,用`set-cookie`写入 @@ -15,7 +15,7 @@ Token有效期为1月,更改密码或过期失效 | SESSDATA | 登录Token | 用于用户识别与鉴权
作用同`access_key` | | bili_jct | CSRF Token | 用于操作性接口 | -## app方式 +## APP方式 | 参数 | 含义 | 备注 | | ------------- | ---------------- | -------------- | diff --git a/other/ip.md b/other/ip.md index c821ada..0b7331a 100644 --- a/other/ip.md +++ b/other/ip.md @@ -2,7 +2,7 @@ > http://api.bilibili.com/x/web-interface/zone -*方式:GET* +*请求方式:GET* **json回复:** diff --git a/other/time_stamp.md b/other/time_stamp.md index 6b5b94a..1f635da 100644 --- a/other/time_stamp.md +++ b/other/time_stamp.md @@ -2,7 +2,7 @@ > http://api.bilibili.com/x/report/click/now -*方式:GET* +*请求方式:GET* **json回复:** diff --git a/other/zone_online.md b/other/zone_online.md index 6df3c40..ccebf3e 100644 --- a/other/zone_online.md +++ b/other/zone_online.md @@ -2,7 +2,7 @@ > http://api.bilibili.com/x/web-interface/online -*方式:GET* +*请求方式:GET* **json回复:** diff --git a/ranking&dynamic/dynamic.md b/ranking&dynamic/dynamic.md index 3a976dd..2df39b2 100644 --- a/ranking&dynamic/dynamic.md +++ b/ranking&dynamic/dynamic.md @@ -4,7 +4,7 @@ > http://api.bilibili.com/x/web-interface/dynamic/region -*方式:GET* +*请求方式:GET* **url参数:** diff --git a/ranking&dynamic/ranking.md b/ranking&dynamic/ranking.md index 3a67687..4d690b7 100644 --- a/ranking&dynamic/ranking.md +++ b/ranking&dynamic/ranking.md @@ -6,7 +6,7 @@ >http://api.bilibili.com/x/web-interface/ranking/region -*方式:GET* +*请求方式:GET* 获取相应时间段内播放量增速为前11的视频 diff --git a/search/search_request.md b/search/search_request.md index d2abd82..fb4179b 100644 --- a/search/search_request.md +++ b/search/search_request.md @@ -4,7 +4,7 @@ > http://api.bilibili.com/x/web-interface/search/type -*方式:GET* +*请求方式:GET* 根据关键词进行搜索,返回结果每页20项 diff --git a/user/check_nickname.md b/user/check_nickname.md index d0268fc..f8cdde7 100644 --- a/user/check_nickname.md +++ b/user/check_nickname.md @@ -1,10 +1,10 @@ # 检查昵称是否可注册 也可用于判断指定昵称的用户是否存在 -### 请求地址 +### > http://passport.bilibili.com/web/generic/check/nickname -*方式:GET* +*请求方式:GET* **url参数:** @@ -35,9 +35,12 @@ **示例:** -查询昵称 `xijinping` 是否被使用 +查询昵称 `xijinping` 是否被使用: -http://passport.bilibili.com/web/generic/check/nickname?nickName=xijinping +```shell +curl -G 'http://passport.bilibili.com/web/generic/check/nickname'\ +--data-urlencode 'nickName=xijinping' +``` ```json { @@ -46,9 +49,12 @@ http://passport.bilibili.com/web/generic/check/nickname?nickName=xijinping } ``` -查询昵称 `//` 是否被使用 +查询昵称 `//` 是否被使用: -http://passport.bilibili.com/web/generic/check/nickname?nickName=%2F%2F +```shell +curl -G 'http://passport.bilibili.com/web/generic/check/nickname'\ +--data-urlencode 'nickName=//' +``` ```json { @@ -57,9 +63,12 @@ http://passport.bilibili.com/web/generic/check/nickname?nickName=%2F%2F } ``` -查询昵称 `test0000000000000 ` 是否被使用 +查询昵称 `test0000000000000 ` 是否被使用: - http://passport.bilibili.com/web/generic/check/nickname?nickName=test0000000000000 +```shell +curl -G 'http://passport.bilibili.com/web/generic/check/nickname'\ +--data-urlencode 'nickName=test0000000000000 ' +``` ```json { @@ -68,9 +77,12 @@ http://passport.bilibili.com/web/generic/check/nickname?nickName=%2F%2F } ``` -查询昵称 `0` 是否被使用 +查询昵称 `0` 是否被使用: - http://passport.bilibili.com/web/generic/check/nickname?nickName=0 +```shell +curl -G 'http://passport.bilibili.com/web/generic/check/nickname'\ +--data-urlencode 'nickName=0' +``` ```json { @@ -79,9 +91,12 @@ http://passport.bilibili.com/web/generic/check/nickname?nickName=%2F%2F } ``` -查询昵称 `test` 是否被使用 +查询昵称 `test` 是否被使用: -http://passport.bilibili.com/web/generic/check/nickname?nickName=test +```shell +curl -G 'http://passport.bilibili.com/web/generic/check/nickname'\ +--data-urlencode 'nickName=test' +``` ```json { diff --git a/user/info.md b/user/info.md index 535ad42..0c2fed0 100644 --- a/user/info.md +++ b/user/info.md @@ -5,7 +5,7 @@ ## 用户详细信息1 (用于空间) > http://api.bilibili.com/x/space/acc/info -*方式:GET* +*请求方式:GET* **url参数:** @@ -99,7 +99,12 @@ 查询用户`UID=2`的详细信息 -http://api.bilibili.com/x/space/acc/info?mid=2 +```shell +curl -G 'http://api.bilibili.com/x/space/acc/info'\ +--data-urlencode 'mid=2'\ +-b 'SESSDATA=xxx' +``` + ```json { "code": 0, @@ -202,7 +207,7 @@ http://i2.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png > http://api.bilibili.com/x/web-interface/card -*方式:GET* +*请求方式:GET* **url参数:** @@ -325,7 +330,13 @@ http://i2.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png **示列:** -http://api.bilibili.com/x/web-interface/card?mid=2&photo=true +```shell +curl -G 'api.bilibili.com/x/web-interface/card'\ +--data-urlencode 'mid=2'\ +--data-urlencode 'photo=true'\ +-b 'SESSDATA=xxx' +``` + ```json { "code": 0, @@ -402,13 +413,11 @@ http://api.bilibili.com/x/web-interface/card?mid=2&photo=true } ``` - - ## 本用户详细信息 > http://api.bilibili.com/x/space/myinfo -*方式:GET* +*请求方式:GET* 需要登录(SESSDATA) @@ -509,7 +518,11 @@ http://api.bilibili.com/x/web-interface/card?mid=2&photo=true **示例:** -http://api.bilibili.com/x/space/myinfo +```shell +curl -G 'api.bilibili.com/x/space/myinfo'\ +-b 'SESSDATA=xxx' +``` + ```json { "code": 0, diff --git a/user/relation.md b/user/relation.md index 1781fa3..e1e089a 100644 --- a/user/relation.md +++ b/user/relation.md @@ -6,7 +6,7 @@ > http://api.bilibili.com/x/relation/followers -*方式:GET* +*请求方式:GET* 登录(SESSDATA)可看自己全部 @@ -90,7 +90,13 @@ 以每页2项的方式获取`UID=293793435`的用户的第1页的粉丝明细 -http://api.bilibili.com/x/relation/followers?vmid=293793435&ps=2&pn=1 +```shell +curl -G 'http://api.bilibili.com/x/relation/followers'\ +--data-urlencode 'vmid=293793435'\ +--data-urlencode 'ps=2'\ +--data-urlencode 'pn=1'\ +-b 'SESSDATA=xxx' +``` ```json { @@ -155,15 +161,13 @@ http://api.bilibili.com/x/relation/followers?vmid=293793435&ps=2&pn=1 } ``` - - ## 查询用户关注明细 > http://api.bilibili.com/x/relation/followings -*方式:GET* +*请求方式:GET* 登录(SESSDATA)可看自己全部 @@ -255,7 +259,13 @@ data 对象: 以每页2项的方式获取`UID=293793435`的用户的第1页的关注明细 -http://api.bilibili.com/x/relation/followings?vmid=293793435&ps=2&pn=1 +```shell +curl -G 'http://api.bilibili.com/x/relation/ollowings'\ +--data-urlencode 'vmid=293793435'\ +--data-urlencode 'ps=2'\ +--data-urlencode 'pn=1'\ +-b 'SESSDATA=xxx' +``` ```json { @@ -320,26 +330,24 @@ http://api.bilibili.com/x/relation/followings?vmid=293793435&ps=2&pn=1 } ``` - - ## 操作用户关系(关注/取关 等) > http://api.bilibili.com/x/relation/modify -*方式:POST* +*请求方式:POST* 需要登录(SESSDATA) **正文参数( application/x-www-form-urlencoded ):** -| 参数名 | 类型 | 内容 | 必要性 | 备注 | -| ------ | ---- | ------------------------ | ------ | ------------------ | -| fid | num | 目标用户UID | 必要 | | -| act | num | 操作代码 | 必要 | **操作代码见下表** | -| re_src | num | 必须为11 | 必要 | | -| csrf | str | CSRF Token(位于cookie) | 必要 | | +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| ------ | ---- | ------------------------ | ------ | ------------------------------------- | +| fid | num | 目标用户UID | 必要 | | +| act | num | 操作代码 | 必要 | **操作代码见下表** | +| re_src | num | 关注来源代码 | 必要 | 空间:11
视频:14
文章:115 | +| csrf | str | CSRF Token(位于cookie) | 必要 | | 操作代码`act`: @@ -367,7 +375,14 @@ http://api.bilibili.com/x/relation/followings?vmid=293793435&ps=2&pn=1 关注`UID=14082`的用户 -curl -b SESSDATA=xxx -d "fid=14082&act=1&re_src=11&csrf=xxx" "http://api.bilibili.com/x/relation/modify" +```shell +curl 'http://http://api.bilibili.com/x/relation/modify'\ +--data-urlencode 'fid=14082'\ +--data-urlencode 'act=1'\ +--data-urlencode 're_src=11'\ +--data-urlencode 'csrf=xxx'\ +-b 'SESSDATA=xxx' +``` ```json { @@ -377,13 +392,11 @@ curl -b SESSDATA=xxx -d "fid=14082&act=1&re_src=11&csrf=xxx" "http://api.bilibil } ``` - - ## 查询用户与自己关系1 (仅查关注) > http://api.bilibili.com/x/relation -*方式:GET* +*请求方式:GET* 需要登录(SESSDATA) @@ -426,7 +439,11 @@ curl -b SESSDATA=xxx -d "fid=14082&act=1&re_src=11&csrf=xxx" "http://api.bilibil 可得对于`UID=258150656`的用户,在`2018/10/28 0:51:41`时关注,且设为特别关注,并位于ID为`-10`分组中 -http://api.bilibili.com/x/relation?fid=258150656 +```shell +curl -G 'http://http://api.bilibili.com/x/relation'\ +--data-urlencode 'fid=258150656'\ +-b 'SESSDATA=xxx' +``` ```json { @@ -443,13 +460,11 @@ http://api.bilibili.com/x/relation?fid=258150656 } ``` - - ## 查询用户与自己关系2(互相) > http://api.bilibili.com/x/space/acc/relation -*方式:GET* +*请求方式:GET* 需要登录(SESSDATA) @@ -509,7 +524,11 @@ http://api.bilibili.com/x/relation?fid=258150656 可得对于`UID=15858903`的用户,在`2019/1/24 14:24:19`时关注了对方,且互相关注,自己将对方特别关注,并同时位于ID为`-10`和`194110`的分组中,对方也将自己设为特别关注,并同时位于ID为`-10`和`56502`的分组中(虽然我看不到) -http://api.bilibili.com/x/space/acc/relation?mid=15858903 +```shell +curl -G 'http://api.bilibili.com/x/space/acc/relation'\ +--data-urlencode 'mid=15858903'\ +-b 'SESSDATA=xxx' +``` ```json { @@ -537,15 +556,13 @@ http://api.bilibili.com/x/space/acc/relation?mid=15858903 } ``` - - ## 关注分组相关 ### 查询关注分组列表 > http://api.bilibili.com/x/relation/tags -*方式:GET* +*请求方式:GET* 需要登录(SESSDATA) @@ -581,7 +598,10 @@ http://api.bilibili.com/x/space/acc/relation?mid=15858903 查询所有的分组的名字以及ID -http://api.bilibili.com/x/relation/tags +```shell +curl 'http://api.bilibili.com/x/relation/tags'\ +-b 'SESSDATA=xxx' +``` ```json { @@ -606,13 +626,11 @@ http://api.bilibili.com/x/relation/tags } ``` - - ### 查询关注分组明细 > http://api.bilibili.com/x/relation/tag -*方式:GET* +*请求方式:GET* 需要登录(SESSDATA) @@ -684,7 +702,13 @@ http://api.bilibili.com/x/relation/tags 以每页2项的方式获取了ID为`207542`分组的第1页的粉丝明细 -http://api.bilibili.com/x/relation/tag?tagid=207542&ps=2&pn=1 +```shell +curl -G 'http://api.bilibili.com/x/relation/tag'\ +--data-urlencode 'tagid=207542'\ +--data-urlencode 'ps=2'\ +--data-urlencode 'pn=1'\ +-b 'SESSDATA=xxx' +``` ```json { @@ -737,13 +761,11 @@ http://api.bilibili.com/x/relation/tag?tagid=207542&ps=2&pn=1 } ``` - - ### 查询目标用户所在的分组 > http://api.bilibili.com/x/relation/tag/user -*方式:GET* +*请求方式:GET* 需要登录(SESSDATA) @@ -776,7 +798,11 @@ http://api.bilibili.com/x/relation/tag?tagid=207542&ps=2&pn=1 查询用户`UID=319214221`存在的所有分组ID和名称 -http://api.bilibili.com/x/relation/tag/user?fid=319214221 +```shell +curl -G 'http://api.bilibili.com/x/relation/tag/user'\ +--data-urlencode 'fid=319214221'\ +-b 'SESSDATA=xxx' +``` ```json { @@ -790,12 +816,12 @@ http://api.bilibili.com/x/relation/tag/user?fid=319214221 } ``` - - ### 查询所有特别关注的UID > http://api.bilibili.com/x/relation/tag/special +*请求方式:GET* + 需要登录(SESSDATA) **json回复:** @@ -819,7 +845,10 @@ http://api.bilibili.com/x/relation/tag/user?fid=319214221 **示例:** -http://api.bilibili.com/x/relation/tag/special +```shell +curl 'http://api.bilibili.com/x/relation/tag/special'\ +-b 'SESSDATA=xxx' +``` ```json { @@ -849,15 +878,13 @@ http://api.bilibili.com/x/relation/tag/special } ``` - - -### 创建关注分组 +### 创建分组 > http://api.bilibili.com/x/relation/tag/create -*方式:POST* +*请求方式:POST* 需要登录(SESSDATA) @@ -887,9 +914,14 @@ http://api.bilibili.com/x/relation/tag/special **示例:** -创建了名为`vUP`的分组,得到ID为`216677` +创建了名为`测试`的分组,得到ID为`216677` -curl -b SESSDATA=xxx -d "tag=vUP&csrf=xxx" "http://api.bilibili.com/x/relation/tag/create" +```shell +curl 'http://api.bilibili.com/x/relation/tag/create'\ +--data-urlencode 'tag=测试'\ +--data-urlencode 'csrf=xxx'\ +-b 'SESSDATA=xxx' +``` ```json { @@ -902,13 +934,11 @@ curl -b SESSDATA=xxx -d "tag=vUP&csrf=xxx" "http://api.bilibili.com/x/relation/t } ``` - - -### 重命名关注分组 +### 重命名分组 > http://api.bilibili.com/x/relation/tag/update -*方式:POST* +*请求方式:POST* 需要登录(SESSDATA) @@ -934,7 +964,13 @@ curl -b SESSDATA=xxx -d "tag=vUP&csrf=xxx" "http://api.bilibili.com/x/relation/t 把ID为`194112`的分组更名为`膜法师` -curl -b SESSDATA=xxx -d "tagid=194112&name=%e8%86%9c%e6%b3%95%e5%b8%88&csrf=xxx" "http://api.bilibili.com/x/relation/tag/update" +```shell +curl 'http://api.bilibili.com/x/relation/tag/update'\ +--data-urlencode 'tagid=194112'\ +--data-urlencode 'name=膜法师'\ +--data-urlencode 'csrf=xxx'\ +-b 'SESSDATA=xxx' +``` ```json { @@ -944,15 +980,13 @@ curl -b SESSDATA=xxx -d "tagid=194112&name=%e8%86%9c%e6%b3%95%e5%b8%88&csrf=xxx" } ``` - - -### 删除关注分组 +### 删除分组 > http://api.bilibili.com/x/relation/tag/del -*方式:POST* +*请求方式:POST* 需要登录(SESSDATA) @@ -977,7 +1011,12 @@ curl -b SESSDATA=xxx -d "tagid=194112&name=%e8%86%9c%e6%b3%95%e5%b8%88&csrf=xxx" 删除分组ID为`216699`的分组 -curl -b SESSDATA=xxx -d "tagid=216699&csrf=xxx" "http://api.bilibili.com/x/relation/tag/del" +```shell +curl 'http://api.bilibili.com/x/relation/tag/del'\ +--data-urlencode 'tagid=216699'\ +--data-urlencode 'csrf=xxx'\ +-b 'SESSDATA=xxx' +``` ```json { @@ -987,15 +1026,13 @@ curl -b SESSDATA=xxx -d "tagid=216699&csrf=xxx" "http://api.bilibili.com/x/relat } ``` - - -### 修改用户分组关系(添加/删除) +### 修改分组成员(添加/删除) > http://api.bilibili.com/x/relation/tags/addUsers -*方式:POST* +*请求方式:POST* 需要登录(SESSDATA) @@ -1021,7 +1058,13 @@ curl -b SESSDATA=xxx -d "tagid=216699&csrf=xxx" "http://api.bilibili.com/x/relat 把关注用户`UID=205631797`同时添加分组关系到ID为`-10`和`207542`的分组中 -curl -b SESSDATA=xxx -d "fids=205631797&tagids=-10%2C207542&csrf=xxx" "http://api.bilibili.com/x/relation/tags/addUsers" +```shell +curl 'http://api.bilibili.com/x/relation/tags/addUsers'\ +--data-urlencode 'fids=205631797'\ +--data-urlencode 'tagids=-10,207542'\ +--data-urlencode 'csrf=xxx'\ +-b 'SESSDATA=xxx' +``` ```json { @@ -1031,13 +1074,11 @@ curl -b SESSDATA=xxx -d "fids=205631797&tagids=-10%2C207542&csrf=xxx" "http://ap } ``` - - -### 批量复制关注用户到分组 +### 复制关注到分组 > http://api.bilibili.com/x/relation/tags/copyUsers -*方式:POST* +*请求方式:POST* 需要登录(SESSDATA) @@ -1045,8 +1086,8 @@ curl -b SESSDATA=xxx -d "fids=205631797&tagids=-10%2C207542&csrf=xxx" "http://ap | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ------------------------ | ------ | -------------------------- | -| fids | nums | 目标用户UID | 必要 | 每个ID之间用","(%2C)间隔 | -| tagids | nums | 分组ID | 必要 | 每个ID之间用","(%2C)间隔 | +| fids | nums | 待复制的用户UID | 必要 | 每个ID之间用","(%2C)间隔 | +| tagids | nums | 目标分组ID | 必要 | 每个ID之间用","(%2C)间隔 | | csrf | str | CSRF Token(位于cookie) | 必要 | | **json回复:** @@ -1063,7 +1104,13 @@ curl -b SESSDATA=xxx -d "fids=205631797&tagids=-10%2C207542&csrf=xxx" "http://ap 把关注用户`UID=4856007`和`UID=326499679`同时复制到ID为`231305`的分组中 -curl -b SESSDATA=xxx -d "fids=4856007%2C326499679&tagids=231305&csrf=xxx" "http://api.bilibili.com/x/relation/tags/copyUsers" +```shell +curl 'http://api.bilibili.com/x/relation/tags/copyUsers'\ +--data-urlencode 'fids=4856007,326499679'\ +--data-urlencode 'tagids=231305'\ +--data-urlencode 'csrf=xxx'\ +-b 'SESSDATA=xxx' +``` ```json { @@ -1073,13 +1120,11 @@ curl -b SESSDATA=xxx -d "fids=4856007%2C326499679&tagids=231305&csrf=xxx" "http: } ``` - - -### 批量移动关注用户到分组 +### 移动关注到分组 > http://api.bilibili.com/x/relation/tags/moveUsers -*方式:POST* +*请求方式:POST* 需要登录(SESSDATA) @@ -1089,7 +1134,7 @@ curl -b SESSDATA=xxx -d "fids=4856007%2C326499679&tagids=231305&csrf=xxx" "http: | ------------ | ---- | ------------------------ | ------ | -------------------------- | | beforeTagids | nums | 原分组ID | 必要 | 每个ID之间用","(%2C)间隔 | | afterTagids | nums | 新分组ID | 必要 | 每个ID之间用","(%2C)间隔 | -| fids | nums | 目标用户UID | 必要 | 每个ID之间用","(%2C)间隔 | +| fids | nums | 待移动的用户UID | 必要 | 每个ID之间用","(%2C)间隔 | | csrf | str | CSRF Token(位于cookie) | 必要 | | **json回复:** @@ -1104,11 +1149,16 @@ curl -b SESSDATA=xxx -d "fids=4856007%2C326499679&tagids=231305&csrf=xxx" "http: **示例:** -把关注用户`UID=3211734 -69`和`UID=327086920`同时从ID为`207542`的分组移动到ID为`231305`的分组中 +把关注用户`UID=321173469`和`UID=327086920`同时从ID为`207542`的分组移动到ID为`231305`的分组中 -curl -b SESSDATA=xxx -d "beforeTagids=207542&afterTagids=231305&fids=3211734 -69%2C327086920&csrf=xxx" "http://api.bilibili.com/x/relation/tags/moveUsers" +```shell +curl 'http://api.bilibili.com/x/relation/tags/moveUsers'\ +--data-urlencode 'beforeTagids=207542'\ +--data-urlencode 'afterTagids=23130'\ +--data-urlencode 'fids=321173469,327086920'\ +--data-urlencode 'csrf=xxx'\ +-b 'SESSDATA=xxx' +``` ```json { diff --git a/user/space.md b/user/space.md index ab268d7..8709f43 100644 --- a/user/space.md +++ b/user/space.md @@ -6,7 +6,7 @@ >http://api.bilibili.com/x/space/top/arc -*方式:GET* +*请求方式:GET* 粉丝在其主页上可见 @@ -183,7 +183,7 @@ http://api.bilibili.com/x/space/top/arc?vmid=23215368 > http://api.bilibili.com/x/space/masterpiece -*方式:GET* +*请求方式:GET* 新访客在其主页上可见 @@ -410,7 +410,7 @@ http://api.bilibili.com/x/space/masterpiece?vmid=23215368 > http://api.bilibili.com/x/space/arc/search -*方式:GET* +*请求方式:GET* **url参数:** @@ -596,7 +596,7 @@ http://api.bilibili.com/x/space/arc/search?mid=53456&ps=2&pn=1 > http://space.bilibili.com/ajax/Bangumi/getList -*方式:GET* +*请求方式:GET* 带有转义,且只能获取最多15条 @@ -701,7 +701,7 @@ http://space.bilibili.com/ajax/Bangumi/getList?mid=14082 > http://api.bilibili.com/x/space/bangumi/follow/list -*方式:GET* +*请求方式:GET* 如设置隐私查看自己的需要登录(SESSDATA) @@ -949,7 +949,7 @@ http://api.bilibili.com/x/space/bangumi/follow/list?vmid=14082&pn=1&ps=2&type=1 > http://space.bilibili.com/ajax/tags/getSubList -*方式:GET* +*请求方式:GET* 带有转义 @@ -1039,7 +1039,7 @@ http://space.bilibili.com/ajax/tags/getSubList?mid=2 > http://api.bilibili.com/x/space/album/index -*方式:GET* +*请求方式:GET* 所有类型的相簿 @@ -1161,7 +1161,7 @@ http://api.bilibili.com/x/space/album/index?mid=53456&ps=2 > http://api.vc.bilibili.com/link_draw/v1/doc/doc_list -*方式:GET* +*请求方式:GET* **url参数:** @@ -1298,7 +1298,7 @@ http://api.vc.bilibili.com/link_draw/v1/doc/doc_list?uid=2&page_num=1&page_size= > http://api.bilibili.com/x/space/channel/list -*方式:GET* +*请求方式:GET* **url参数:** @@ -1416,7 +1416,7 @@ http://api.bilibili.com/x/space/channel/list?mid=53456 > http://api.bilibili.com/x/space/channel/video -*方式:GET* +*请求方式:GET* **url参数:** @@ -1626,7 +1626,7 @@ http://api.bilibili.com/x/space/channel/video?mid=53456&cid=170&ps=2&pn=1 > http://api.bilibili.com/x/space/notice -*方式:GET* +*请求方式:GET* **url参数:** @@ -1666,7 +1666,7 @@ http://api.bilibili.com/x/space/notice?mid=53456 > http://api.bilibili.com/x/space/acc/tags -*方式:GET* +*请求方式:GET* 上限5条,且内容由用户自定义 @@ -1735,7 +1735,7 @@ http://api.bilibili.com/x/space/acc/tags?mid=53456 > http://api.bilibili.com/x/space/lastplaygame -*方式:GET* +*请求方式:GET* **url参数:** @@ -1817,7 +1817,7 @@ http://api.bilibili.com/x/space/acc/tags?mid=53456 > http://api.bilibili.com/x/v3/fav/folder/created/list-all -*方式:GET* +*请求方式:GET* 查看私有收藏夹时需要登录(SESSDATA) @@ -1935,7 +1935,7 @@ http://api.bilibili.com/x/v3/fav/folder/created/list-all?up_mid=7792521 > http://api.bilibili.com/x/v3/fav/folder/collected/list -*方式:GET* +*请求方式:GET* **url参数:** @@ -2070,7 +2070,7 @@ http://api.bilibili.com/x/v3/fav/folder/created/list-all?up_mid=7792521 > http://api.bilibili.com/x/member/web/sign/update -*方式:POST* +*请求方式:POST* 签名最多支持70个字 @@ -2115,7 +2115,7 @@ curl -b "SESSDATA=xxx" -d "user_sign=%E9%AB%98%E4%B8%AD%E6%8A%80%E6%9C%AF%E5%AE% > http://api.bilibili.com/x/space/notice/set -*方式:POST* +*请求方式:POST* 需要登录(SESSDATA) @@ -2156,7 +2156,7 @@ curl -b "sessdata=xxx" -d "csrf=xxx¬ice=%E9%B8%BD%E5%AD%90" "http://api.bilib > http://space.bilibili.com/ajax/settings/setPrivacy -*方式:POST* +*请求方式:POST* 需要登录(SESSDATA) @@ -2203,7 +2203,7 @@ curl --referer "http://.bilibili.com" -b "SESSDATA=xxx;DedeUserID=1;DedeUserID__ > http://space.bilibili.com/ajax/settings/setIndexOrder -*方式:POST* +*请求方式:POST* 需要登录(SESSDATA) @@ -2273,7 +2273,7 @@ curl --referer "http://.bilibili.com" -b "SESSDATA=xxx;DedeUserID=1;DedeUserID__ > http://api.bilibili.com/x/space/acc/tags/set -*方式:POST* +*请求方式:POST* 需要登录(SESSDATA) @@ -2312,11 +2312,11 @@ curl -b "SESSDATA=xxx;DedeUserID=1" -d "csrf=xxx&tags=minecraft%2C%E6%8A%80%E6%9 -### 修改(添加)置顶视频 +### 添加置顶视频 > http://api.bilibili.com/x/space/top/arc/set -*方式:POST* +*请求方式:POST* 需要登录(SESSDATA) @@ -2361,7 +2361,7 @@ curl -b "SESSDATA=xxx" -b "aid=98948772&csrf=xxx" "http://api.bilibili.com/x/spa > http://api.bilibili.com/x/space/top/arc/cancel -*方式:POST* +*请求方式:POST* 需要登录(SESSDATA) @@ -2399,7 +2399,7 @@ curl -b "SESSDATA=xxx" -d "csrf=xxx" "http://api.bilibili.com/x/space/top/arc/ca > http://api.bilibili.com/x/space/masterpiece/add -*方式:POST* +*请求方式:POST* 需要登录(SESSDATA) @@ -2446,7 +2446,7 @@ curl -b "SESSDATA=xxx" -d "csrf=xxx&aid=94916552" "http://api.bilibili.com/x/spa > http://api.bilibili.com/x/space/masterpiece/cancel -*方式:POST* +*请求方式:POST* 需要登录(SESSDATA) diff --git a/user/status_number.md b/user/status_number.md index 9125adf..244a0f4 100644 --- a/user/status_number.md +++ b/user/status_number.md @@ -3,7 +3,7 @@ ## 关系状态数 > http://api.bilibili.com/x/relation/stat -*方式:GET* +*请求方式:GET* **url参数:** @@ -59,7 +59,7 @@ http://api.bilibili.com/x/relation/stat?vmid=332704117 > http://api.bilibili.com/x/space/upstat -*方式:GET* +*请求方式:GET* **url参数:** @@ -126,7 +126,7 @@ http://api.bilibili.com/x/space/upstat?mid=456664753 > http://api.bilibili.com/x/space/navnum -*方式:GET* +*请求方式:GET* **url参数:** @@ -213,7 +213,7 @@ http://api.bilibili.com/x/space/navnum?mid=239202390 > http://api.vc.bilibili.com/link_draw/v1/doc/upload_count -*方式:GET* +*请求方式:GET* **url参数:** diff --git a/video/info.md b/video/info.md index 12ed153..3d4e316 100644 --- a/video/info.md +++ b/video/info.md @@ -6,7 +6,7 @@ > http://api.bilibili.com/x/web-interface/view -*方式:GET* +*请求方式:GET* **url参数:** @@ -113,19 +113,19 @@ | --------- | ---- | --------------- | ------------------------------------ | | cid | num | 当前分P CID | | | page | num | 当前分P | | -| from | str | 视频来源 | vupload:用户上传
hunan:芒果TV | +| from | str | 视频来源 | vupload:普通上传
hunan:芒果TV | | part | str | 当前分P标题 | | | duration | num | 当前分P持续时间 | 单位为秒 | | vid | str | 空 | 作用尚不明确 | | weblink | str | 空 | 作用尚不明确 | -| dimension | obj | 当前分P分辨率 | | +| dimension | obj | 当前分P分辨率 | 有部分视频无法获取分辨率 | `pages`数组中的对象中的`dimension`对象(同`data`中的`dimension`对象): | 字段 | 类型 | 内容 | 备注 | | ------ | ---- | ------------ | ------------ | -| width | num | 当前分P 宽度 | 可能为0 | -| height | num | 当前分P 高度 | 可能为0 | +| width | num | 当前分P 宽度 | | +| height | num | 当前分P 高度 | | | rotate | num | 0 | 作用尚不明确 | `subtitle`对象: @@ -208,9 +208,19 @@ **示例:** -http://api.bilibili.com/x/web-interface/view?aid=85440373 +avID方式: -同http://api.bilibili.com/x/web-interface/view?bvid=BV117411r7R1 +```shell +curl -G 'http://api.bilibili.com/x/web-interface/view'\ +--data-urlencode 'aid=85440373' +``` + +bvID方式: + +```shell +curl -G 'http://api.bilibili.com/x/web-interface/view'\ +--data-urlencode 'bvid=BV117411r7R1' +``` ```json { @@ -353,7 +363,7 @@ http://i0.hdslb.com/bfs/face/5387950a59be8038daaae3f66dfb5a85e20d5737.jpg > http://api.bilibili.com/x/web-interface/archive/desc -*方式:GET* +*请求方式:GET* **url参数:** @@ -377,9 +387,19 @@ http://i0.hdslb.com/bfs/face/5387950a59be8038daaae3f66dfb5a85e20d5737.jpg 查看视频~~(教主的咕鸽)~~`av39330059`/`BV1Bt411z799`的简介 -http://api.bilibili.com/x/web-interface/archive/desc?aid=39330059 +avID方式: -同http://api.bilibili.com/x/web-interface/archive/desc?bvid=BV1Bt411z799 +```shell +curl -G 'http://api.bilibili.com/x/archive/desc'\ +--data-urlencode 'aid=39330059' +``` + +bvID方式: + +```shell +curl -G 'http://api.bilibili.com/x/archive/desc'\ +--data-urlencode 'bvid=BV1Bt411z799' +``` ```json { @@ -396,7 +416,7 @@ http://api.bilibili.com/x/web-interface/archive/desc?aid=39330059 > http://api.bilibili.com/x/player/pagelist -*方式:GET* +*请求方式:GET* **url参数:** @@ -430,28 +450,38 @@ http://api.bilibili.com/x/web-interface/archive/desc?aid=39330059 | --------- | ---- | --------------- | ------------------------------------ | | cid | num | 当前分P CID | | | page | num | 当前分P | | -| from | str | 视频来源 | vupload:用户上传
hunan:芒果TV | +| from | str | 视频来源 | vupload:普通上传
hunan:芒果TV | | part | str | 当前分P标题 | | | duration | num | 当前分P持续时间 | 单位为秒 | | vid | str | 空 | 作用尚不明确 | | weblink | str | 空 | 作用尚不明确 | -| dimension | obj | 当前分P分辨率 | | +| dimension | obj | 当前分P分辨率 | 有部分视频无法获取分辨率 | 数组`data`中的对象中的`dimension`对象: | 字段 | 类型 | 内容 | 备注 | | ------ | ---- | ------------ | ------------ | -| width | num | 当前分P 宽度 | 可能为0 | -| height | num | 当前分P 高度 | 可能为0 | +| width | num | 当前分P 宽度 | | +| height | num | 当前分P 高度 | | | rotate | num | 0 | 作用尚不明确 | **示例:** 查询视频`av13502509`/`BV1ex411J7GE`的分P列表 -http://api.bilibili.com/x/player/pagelist?aid=13502509 +avID方式: -同http://api.bilibili.com/x/player/pagelist?bvid=BV1ex411J7GE +```shell +curl -G 'http://api.bilibili.com/x/player/pagelist'\ +--data-urlencode 'aid=13502509' +``` + +bvID方式: + +```shell +curl -G 'http://api.bilibili.com/x/player/pagelist'\ +--data-urlencode 'bvid=BV1ex411J7GE' +``` ```json { diff --git a/video/like_coin_fav.md b/video/like_coin_fav.md index 6277d70..a795f16 100644 --- a/video/like_coin_fav.md +++ b/video/like_coin_fav.md @@ -1,16 +1,18 @@ # 视频点赞&投币&收藏 -**本页所有操作均需登录(SESSDATA)** +**本页所有操作均需登录(Cookie或APP)** ## 操作 -### 点赞视频 +### 点赞视频(web端) > http://api.bilibili.com/x/web-interface/archive/like -*方式:POST* +*请求方式:POST* + +认证&鉴权方式:仅可Cookie **正文参数( application/x-www-form-urlencoded ):** @@ -33,11 +35,27 @@ **示例:** -为视频av79677524/BV1uJ411r7hL点赞 +为视频`av79677524`/`BV1uJ411r7hL`点赞 -curl -b "SESSDATA=xxx" -d "aid=79677524&like=1&csrf=xxx" "http://api.bilibili.com/x/web-interface/archive/like" +avID方式: -同curl -b "SESSDATA=xxx" -d "aid=BV1uJ411r7hL&like=1&csrf=xxx" "http://api.bilibili.com/x/web-interface/archive/like" +```shell +curl 'http://api.bilibili.com/x/web-interface/archive/like'\ +--data-urlencode 'aid=79677524'\ +--data-urlencode 'like=1'\ +--data-urlencode 'csrf=xxx'\ +-b 'SESSDATA=xxx' +``` + +bvID方式: + +```shell +curl 'http://api.bilibili.com/x/web-interface/archive/like'\ +--data-urlencode 'bvid=BV1uJ411r7hL'\ +--data-urlencode 'like=1'\ +--data-urlencode 'csrf=xxx'\ +-b 'SESSDATA=xxx' +``` ```json { @@ -47,15 +65,15 @@ curl -b "SESSDATA=xxx" -d "aid=79677524&like=1&csrf=xxx" "http://api.bilibili.co } ``` - - -### 投币视频 +### 投币视频(web端) > http://api.bilibili.com/x/web-interface/coin/add -*方式:POST* +*请求方式:POST* + +认证&鉴权方式:仅可Cookie **正文参数( application/x-www-form-urlencoded ):** @@ -86,11 +104,29 @@ data 对象: **示例:** + + 为视频`av90671873`/`BV1N7411A7wC`投币2枚 -curl -b "SESSDATA=xxx" -d "aid=90671873&select_like=1&multiply=2&csrf=xxx" "http://api.bilibili.com/x/web-interface/coin/add" +avID方式: -同curl -b "SESSDATA=xxx" -d "bvid=BV1N7411A7wC&select_like=1&multiply=2&csrf=xxx" "http://api.bilibili.com/x/web-interface/coin/add" +```shell +curl 'http://api.bilibili.com/x/web-interface/coin/add'\ +--data-urlencode 'aid=90671873'\ +--data-urlencode 'select_like=1'\ +--data-urlencode 'multiply=2'\ +--data-urlencode 'csrf=xxx'\ +-b 'SESSDATA=xxx' +``` + +```shell +curl 'http://api.bilibili.com/x/web-interface/coin/add'\ +--data-urlencode 'bvid=BV1N7411A7wC'\ +--data-urlencode 'select_like=1'\ +--data-urlencode 'multiply=2'\ +--data-urlencode 'csrf=xxx'\ +-b 'SESSDATA=xxx' +``` ```json { @@ -103,27 +139,25 @@ curl -b "SESSDATA=xxx" -d "aid=90671873&select_like=1&multiply=2&csrf=xxx" "http } ``` - - ### 收藏视频(暂不支持bvID) > http://api.bilibili.com/medialist/gateway/coll/resource/deal -*方式:POST* +*请求方式:POST* -需要验证`referer`为 `http://www.bilibili.com`或`https://www.bilibili.com`域名下 +需要验证`referer`为 `.bilibili.com`域名下 **正文参数( application/x-www-form-urlencoded ):** -| 参数名 | 类型 | 内容 | 必要性 | 备注 | -| ------------- | ---- | ------------------------ | ------ | ----------------------- | -| rid | num | 视频avID | 必要 | | -| type | num | 必须为2 | 必要 | | -| add_media_ids | nums | 需要加入的收藏夹ID | 非必要 | 同时添加多个,用`,`分隔 | -| del_media_ids | nums | 需要取消的收藏夹ID | 非必要 | 同时取消多个,用`,`分隔 | -| csrf | str | CSRF Token(位于cookie) | 必要 | | +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| ------------- | ---- | ------------------------ | ------ | ------------------------------ | +| rid | num | 视频avID | 必要 | | +| type | num | 必须为2 | 必要 | | +| add_media_ids | nums | 需要加入的收藏夹ID | 非必要 | 同时添加多个,用`,`(%2C)分隔 | +| del_media_ids | nums | 需要取消的收藏夹ID | 非必要 | 同时取消多个,用`,`(%2C)分隔 | +| csrf | str | CSRF Token(位于cookie) | 必要 | | **json回复:** @@ -145,7 +179,16 @@ curl -b "SESSDATA=xxx" -d "aid=90671873&select_like=1&multiply=2&csrf=xxx" "http 将视频`av49166435`添加到收藏夹`49166435`中 -curl --referer "http://www.bilibili.com" -b "SESSDATA=xxx" -d "rid=90671873&type=2&add_media_ids=49166435&del_media_ids=&csrf=xxx" "http://api.bilibili.com/medialist/gateway/coll/resource/deal" +```shell +curl 'http://api.bilibili.com/medialist/gateway/coll/resource/deal'\ +--data-urlencode 'rid=90671873'\ +--data-urlencode 'type=2'\ +--data-urlencode 'add_media_ids=49166435'\ +--data-urlencode 'del_media_ids='\ +--data-urlencode 'csrf=xxx'\ +-b 'SESSDATA=xxx' +-e 'https://www.bilibili.com' +``` ```json { @@ -157,15 +200,13 @@ curl --referer "http://www.bilibili.com" -b "SESSDATA=xxx" -d "rid=90671873&type } ``` - - -### 一键三连视频 +### 一键三连视频(web端) > http://api.bilibili.com/x/web-interface/archive/like/triple -*方式:POST* +*请求方式:POST* 同时点赞投币收藏视频,收藏于默认收藏夹中 @@ -190,20 +231,34 @@ curl --referer "http://www.bilibili.com" -b "SESSDATA=xxx" -d "rid=90671873&type `data`对象: -| 字段 | 类型 | 内容 | 备注 | -| -------- | ---- | ------------ | ------- | -| like | bool | 是否点赞成功 | | -| coin | bool | 是否投币成功 | | -| fav | bool | 是否收藏成功 | | -| multiply | num | 投币枚数 | 默认为2 | +| 字段 | 类型 | 内容 | 备注 | +| -------- | ---- | ------------ | --------------------------- | +| like | bool | 是否点赞成功 | true:成功
false:失败 | +| coin | bool | 是否投币成功 | true:成功
false:失败 | +| fav | bool | 是否收藏成功 | true:成功
false:失败 | +| multiply | num | 投币枚数 | 默认为2 | **示例:** 将视频`av91003840`/`BV1Wj411f79U`一键三连 -curl -b "SESSDATA=xxx" -d "aid=91003840&csrf=xxx" "http://api.bilibili.com/x/web-interface/archive/like/triple" +avID方式: -同curl -b "SESSDATA=xxx" -d "bvid=BV1Wj411f79U&csrf=xxx" "http://api.bilibili.com/x/web-interface/archive/like/triple" +```shell +curl 'http://api.bilibili.com/x/web-interface/archive/like/triple'\ +--data-urlencode 'aid=91003840'\ +--data-urlencode 'csrf=xxx'\ +-b 'SESSDATA=xxx' +``` + +bvID方式: + +```shell +curl 'http://api.bilibili.com/x/web-interface/archive/like/triple'\ +--data-urlencode 'bvid=BV1Wj411f79U'\ +--data-urlencode 'csrf=xxx'\ +-b 'SESSDATA=xxx' +``` ```json { @@ -219,71 +274,15 @@ curl -b "SESSDATA=xxx" -d "aid=91003840&csrf=xxx" "http://api.bilibili.com/x/web } ``` - - ## 判断状态 -### 视频是否被收藏 - - - -> http://api.bilibili.com/x/v2/fav/video/favoured - -*方式:GET* - -**url参数:** - -| 参数名 | 类型 | 内容 | 必要性 | 备注 | -| ------ | -------- | ------------------ | ------ | ---- | -| aid | num或str | 视频avID或视频bvID | 必要 | | - -**json回复:** - -根对象: - -| 字段 | 类型 | 内容 | 备注 | -| ------- | ---- | -------- | ------------------------------------------------- | -| code | num | 返回值 | 0:成功
-400:请求错误
-101:账号未登录 | -| message | str | 错误信息 | 默认为0 | -| ttl | num | 1 | 作用尚不明确 | -| data | obj | 信息本体 | | - -data 对象: - -| 字段 | 类型 | 内容 | 备注 | -| -------- | ---- | -------- | ------------------------------- | -| count | num | 1 | 作用尚不明确 | -| favoured | bool | 是否收藏 | true:已收藏
false:未收藏 | - -**示例:** - -视频`av46281123`/`BV1Bb411H7Dv`的状态为已收藏 - -http://api.bilibili.com/x/v2/fav/video/favoured?aid=46281123 - -同http://api.bilibili.com/x/v2/fav/video/favoured?aid=BV1Bb411H7Dv - -```json -{ - "code": 0, - "message": "0", - "ttl": 1, - "data": { - "count": 1, - "favoured": true - } -} -``` - - - ### 视频是否被点赞 > http://api.bilibili.com/x/web-interface/archive/has/like -*方式:GET* +*请求方式:GET* **url参数:** @@ -307,9 +306,21 @@ http://api.bilibili.com/x/v2/fav/video/favoured?aid=46281123 视频`av39330059`/`BV1Bt411z799`的状态为已点赞 -http://api.bilibili.com/x/web-interface/archive/has/like?aid=39330059 +avID方式: -同http://api.bilibili.com/x/web-interface/archive/has/like?bvid=BV1Bt411z799 +```shell +curl -G 'http://api.bilibili.com/x/web-interface/archive/has/like'\ +--data-urlencode 'aid=39330059'\ +-b 'SESSDATA=xxx' +``` + +bvID方式: + +```shell +curl -G 'api.bilibili.com/x/web-interface/archive/has/like'\ +--data-urlencode 'bvid=BV1Bt411z799'\ +-b 'SESSDATA=xxx' +``` ```json { @@ -320,15 +331,13 @@ http://api.bilibili.com/x/web-interface/archive/has/like?aid=39330059 } ``` - - ### 视频是否被投币 > http://api.bilibili.com/x/web-interface/archive/coins -*方式:GET* +*请求方式:GET* **url参数:** @@ -358,9 +367,21 @@ http://api.bilibili.com/x/web-interface/archive/has/like?aid=39330059 视频`av37896701`/`BV18t411q7zz`的投币数为2枚 -http://api.bilibili.com/x/web-interface/archive/coins?aid=37896701 +avID方式: -同http://api.bilibili.com/x/web-interface/archive/coins?bvid=BV18t411q7zz +```shell +curl -G 'api.bilibili.com/x/web-interface/archive/coins'\ +--data-urlencode 'aid=37896701'\ +-b 'SESSDATA=xxx' +``` + +bvID方式: + +```shell +curl -G 'api.bilibili.com/x/web-interface/archive/coins'\ +--data-urlencode 'bvid=BV18t411q7zz'\ +-b 'SESSDATA=xxx' +``` ```json { @@ -373,5 +394,67 @@ http://api.bilibili.com/x/web-interface/archive/coins?aid=37896701 } ``` +### 视频是否被收藏 + + +> http://api.bilibili.com/x/v2/fav/video/favoured + +*请求方式:GET* + +**url参数:** + +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| ------ | -------- | ------------------ | ------ | ---- | +| aid | num或str | 视频avID或视频bvID | 必要 | | + +**json回复:** + +根对象: + +| 字段 | 类型 | 内容 | 备注 | +| ------- | ---- | -------- | ------------------------------------------------- | +| code | num | 返回值 | 0:成功
-400:请求错误
-101:账号未登录 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | 作用尚不明确 | +| data | obj | 信息本体 | | + +data 对象: + +| 字段 | 类型 | 内容 | 备注 | +| -------- | ---- | -------- | ------------------------------- | +| count | num | 1 | 作用尚不明确 | +| favoured | bool | 是否收藏 | true:已收藏
false:未收藏 | + +**示例:** + +视频`av46281123`/`BV1Bb411H7Dv`的状态为已收藏 + +avID方式: + +```shell +curl -G 'http://api.bilibili.com/x/v2/fav/video/favoured'\ +--data-urlencode 'aid=46281123'\ +-b 'SESSDATA=xxx' +``` + +bvID方式: + +```shell +curl -G 'http://api.bilibili.com/x/v2/fav/video/favoured'\ +--data-urlencode 'aid=BV1Bb411H7Dv'\ +-b 'SESSDATA=xxx' +``` + +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "count": 1, + "favoured": true + } +} +``` diff --git a/video/pbp.md b/video/pbp.md index 20d5340..3b189d5 100644 --- a/video/pbp.md +++ b/video/pbp.md @@ -8,7 +8,7 @@ > http://api.bilibili.com/pbp/data -*方式:GET* +*请求方式:GET* **url参数:** diff --git a/video/recommend.md b/video/recommend.md index ac7ff66..12edf19 100644 --- a/video/recommend.md +++ b/video/recommend.md @@ -4,7 +4,7 @@ > http://api.bilibili.com/x/web-interface/archive/related -*方式:GET* +*请求方式:GET* 最多获取40条推荐视频 diff --git a/video/report.md b/video/report.md index bae9469..61e4c7a 100644 --- a/video/report.md +++ b/video/report.md @@ -1,12 +1,12 @@ # 视频观看数据上报 -**本页所有操作均需登录(SESSDATA)** +**本页所有操作均需登录(Cookie或APP)** -## 上报观看进度(暂不支持bvID) +## 上报观看进度(APP端)(暂不支持bvID) > http://api.bilibili.com/x/v2/history/report -*方式:POST* +*请求方式:POST* **正文参数( application/x-www-form-urlencoded ):** @@ -47,7 +47,7 @@ curl -b "SESSDATA=xxx" -d "aid=13662970&cid=126654047&progress=1248&csrf=xxx" "h > http://api.bilibili.com/x/click-interface/web/heartbeat -*方式:POST* +*请求方式:POST* 默认间隔15秒一次 diff --git a/video/snapshot.md b/video/snapshot.md index 4f9bd26..f6d2e7d 100644 --- a/video/snapshot.md +++ b/video/snapshot.md @@ -9,7 +9,7 @@ ## 获取视频快照1(用于进度条预览) > http://api.bilibili.com/x/player/videoshot -*方式:GET* +*请求方式:GET* **url参数:** @@ -89,7 +89,7 @@ http://api.bilibili.com/x/player/videoshot?aid=26273789&index=1 > http://api.bilibili.com/pvideo -*方式:GET* +*请求方式:GET* 内容与「获取视频快照1」加参数「index」=1相同,但url带有转义,仅限第1P diff --git a/video/status_number.md b/video/status_number.md index 6af8fcd..c9d63b7 100644 --- a/video/status_number.md +++ b/video/status_number.md @@ -1,9 +1,9 @@ # 视频状态数 -## 视频状态数1(备用 不封python 暂不支持bvID) +## 视频状态数1(仅avID) > http://api.bilibili.com/archive_stat/stat -*方式:GET* +*请求方式:GET* **url参数:** @@ -44,7 +44,12 @@ 查询视频`av91572143`的状态数 -http://api.bilibili.com/archive_stat/stat?aid=91572143 +avID方式: + +```shell +curl -G 'http://api.bilibili.com/archive_stat/stat'\ +--data-urlencode 'aid=91572143' +``` ```json { @@ -71,17 +76,13 @@ http://api.bilibili.com/archive_stat/stat?aid=91572143 -## 视频状态数2(常用 封杀python) +## 视频状态数2(禁python) > http://api.bilibili.com/x/web-interface/archive/stat -*方式:GET* +*请求方式:GET* -**此API克python,UA中只要存在\*python\*字眼就无法获取正确内容,如用py请改UA** - -**此API克python,UA中只要存在\*python\*字眼就无法获取正确内容,如用py请改UA** - -**此API克python,UA中只要存在\*python\*字眼就无法获取正确内容,如用py请改UA** +此接口请求头中UA值存在`python`字串,会返回-412错误 **url参数:** @@ -94,12 +95,12 @@ http://api.bilibili.com/archive_stat/stat?aid=91572143 根对象: -| 字段 | 类型 | 内容 | 备注 | -| ------- | ---- | -------- | ----------------------------------------------- | -| code | num | 返回值 | 0:成功
-400:请求错误
40003:无视频 | -| message | str | 错误信息 | 默认为0 | -| ttl | num | 1 | 作用尚不明确 | -| data | obj | 信息本体 | | +| 字段 | 类型 | 内容 | 备注 | +| ------- | ---- | -------- | ------------------------------------------------------------ | +| code | num | 返回值 | 0:成功
-400:请求错误
-412:请求被拦截
40003:无视频 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | 作用尚不明确 | +| data | obj | 信息本体 | | `data`对象: @@ -126,9 +127,19 @@ http://api.bilibili.com/archive_stat/stat?aid=91572143 查询视频`av2271112`/`BV1es411D7sW`的状态数 -http://api.bilibili.com/x/web-interface/archive/stat?aid=2271112 +avID方式: -同http://api.bilibili.com/x/web-interface/archive/stat?bvid=BV1es411D7sW +```shell +curl -G 'http://api.bilibili.com/x/web-interface/archive/stat'\ +--data-urlencode 'aid=2271112' +``` + +bvID方式: + +```shell +curl -G 'http://api.bilibili.com/x/web-interface/archive/stat'\ +--data-urlencode 'bvid=BV1es411D7sW' +``` ```json { @@ -155,5 +166,20 @@ http://api.bilibili.com/x/web-interface/archive/stat?aid=2271112 } ``` +当UA为`2333python2333`时,则无法访问此接口: +```shell +curl -G 'http://api.bilibili.com/x/web-interface/archive/stat'\ +--data-urlencode 'aid=2271112'\ +-A '2333python2333' +``` + +```json +{ + "code":-412, + "message":"请求被拦截", + "ttl":1, + "data":null +} +``` diff --git a/video/tags.md b/video/tags.md index ea639c4..e5cb381 100644 --- a/video/tags.md +++ b/video/tags.md @@ -4,7 +4,7 @@ > http://https://api.bilibili.com/x/tag/archive/tags -*方式:GET* +*请求方式:GET* **url参数:** @@ -189,7 +189,7 @@ http://api.bilibili.com/x/tag/archive/tags?aid=89772773 > http://api.bilibili.com/x/tag/archive/like2 -*方式:POST* +*请求方式:POST* 需要登录(SESSDATA) @@ -233,7 +233,7 @@ curl -b "SESSDATA=xxx" -d "csrf=xxx&aid=89772773&tag_id=12620189" "http://api.bi > http://api.bilibili.com/x/tag/archive/hate2 -*方式:POST* +*请求方式:POST* 需要登录(SESSDATA) diff --git a/video/videostream_url.md b/video/videostream_url.md index b1feda3..0d3cc23 100644 --- a/video/videostream_url.md +++ b/video/videostream_url.md @@ -6,7 +6,7 @@ > http://api.bilibili.com/x/player/playurl -*方式:GET* +*请求方式:GET* 获取会员专属视频及720P以上清晰度视频时需要登录(SESSDATA) @@ -114,13 +114,29 @@ **示例:** -**视频无分段时** +**视频无分段时:** 获取视频`av99999999`/`BV1y7411Q7Eq`中的1P(CID=`171776208`)的视频流url,清晰度为1080P+ - http://api.bilibili.com/x/player/playurl?avid=99999999&cid=171776208&qn=112 +avID方式: - 同http://api.bilibili.com/x/player/playurl?bvid=BV1y7411Q7Eq&cid=171776208&qn=112 +```shell +curl -G 'http://api.bilibili.com/x/player/playurl'\ +--data-urlencode 'avid=99999999'\ +--data-urlencode 'cid=171776208'\ +--data-urlencode 'qn=112'\ +-b 'SESSDATA=xxx' +``` + + bvID方式: + +```shell +curl -G 'http://api.bilibili.com/x/player/playurl'\ +--data-urlencode 'bvid=BV1y7411Q7Eq'\ +--data-urlencode 'cid=171776208'\ +--data-urlencode 'qn=112'\ +-b 'SESSDATA=xxx' +``` ```json { @@ -169,13 +185,7 @@ } ``` -**视频有分段时** - -获取视频`av138284`/`BV1Tx411w7PX`中的2P(CID=`872498`)的视频流url,清晰度为1080P - - http://api.bilibili.com/x/player/playurl?avid=138284&cid=872498&qn=80 - - 同http://api.bilibili.com/x/player/playurl?bvid=BV1Tx411w7PX&cid=872498&qn=80 +**视频有分段时:** ```json { @@ -265,6 +275,10 @@ **以上述视频url为例:** -wget --referer "http://www.bilibili.com" "http://upos-sz-mirrorhw.bilivideo.com/upgcxcode/08/62/171776208/171776208-1-112.flv?e=ig8euxZM2rNcNbhMnwhVhwdlhzK3hzdVhoNvNC8BqJIzNbfqXBvEqxTEto8BTrNvN0GvT90W5JZMkX_YN0MvXg8gNEV4NC8xNEV4N03eN0B5tZlqNxTEto8BTrNvNeZVuJ10Kj_g2UB02J0mN0B5tZlqNCNEto8BTrNvNC7MTX502C8f2jmMQJ6mqF2fka1mqx6gqj0eN0B599M=&uipk=5&nbs=1&deadline=1589565412&gen=playurl&os=hwbv&oi=606631998&trid=e0fa5f9a7610440a871279a28fae85aau&platform=pc&upsig=5f469cb4c190ed54b89bd40cc37eddff&uparams=e,uipk,nbs,deadline,gen,os,oi,trid,platform&mid=293793435&logo=80000000" -O video.flv +```shell +wget 'http://upos-sz-mirrorhw.bilivideo.com/upgcxcode/08/62/171776208/171776208-1-112.flv?e=ig8euxZM2rNcNbhMnwhVhwdlhzK3hzdVhoNvNC8BqJIzNbfqXBvEqxTEto8BTrNvN0GvT90W5JZMkX_YN0MvXg8gNEV4NC8xNEV4N03eN0B5tZlqNxTEto8BTrNvNeZVuJ10Kj_g2UB02J0mN0B5tZlqNCNEto8BTrNvNC7MTX502C8f2jmMQJ6mqF2fka1mqx6gqj0eN0B599M=&uipk=5&nbs=1&deadline=1589565412&gen=playurl&os=hwbv&oi=606631998&trid=e0fa5f9a7610440a871279a28fae85aau&platform=pc&upsig=5f469cb4c190ed54b89bd40cc37eddff&uparams=e,uipk,nbs,deadline,gen,os,oi,trid,platform&mid=293793435&logo=80000000'\ +-e 'https://www.bilibili.com'\ +-O 'Download_video.flv' +``` -回复正文将返回一个flv文件的数据 \ No newline at end of file +响应正文将返回一个flv文件 \ No newline at end of file