From a7a743dffdb0e22ef735a8639dd3c3ead82665e4 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E7=A4=BE=E4=BC=9A=E6=98=93=E5=A7=90QwQ?= <45892418+SocialSisterYi@users.noreply.github.com> Date: Mon, 12 Jul 2021 21:31:27 +0800 Subject: [PATCH] =?UTF-8?q?=E7=BB=9F=E4=B8=80=E2=80=9Cid=E2=80=9D=E4=B8=BA?= =?UTF-8?q?=E5=B0=8F=E5=86=99=EF=BC=8C=E5=B9=B6=E5=B0=86=E2=80=9CUID?= =?UTF-8?q?=E2=80=9D=E6=94=B9=E4=B8=BA=E2=80=9Cmid=E2=80=9D=EF=BC=8C?= =?UTF-8?q?=E8=B0=83=E6=95=B4=E3=80=90=E8=A7=86=E9=A2=91=E5=B1=9E=E6=80=A7?= =?UTF-8?q?=E6=95=B0=E6=8D=AE=E3=80=91=E6=96=87=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- APP_widget/splash.md | 6 +- README.md | 3 +- album/action.md | 12 +- album/info.md | 10 +- album/list.md | 10 +- album/recommend_author.md | 2 +- article/articles.md | 10 +- article/info.md | 8 +- article/like_coin_fav.md | 6 +- audio/coin&fav.md | 4 +- audio/info.md | 30 ++-- audio/music_list.md | 32 ++-- audio/musicstream_url.md | 10 +- audio/status_number.md | 4 +- bangumi/info.md | 42 ++--- blackroom/banlist.md | 14 +- blackroom/jury/action.md | 4 +- blackroom/jury/judgement_info.md | 26 +-- broadcast/video_room.md | 6 +- cheese/info.md | 34 ++-- cheese/videostream_url.md | 8 +- clientinfo/ip.md | 2 +- comment/action.md | 52 +++--- comment/list.md | 46 +++--- comment/readme.md | 58 +++---- creativecenter/railgun.md | 2 +- creativecenter/statistics&data.md | 4 +- danmaku/action.md | 90 +++++------ danmaku/danmaku_proto.md | 12 +- danmaku/danmaku_view_proto.md | 38 ++--- danmaku/danmaku_xml.md | 10 +- danmaku/history.md | 10 +- danmaku/snapshot.md | 6 +- dynamic/content.md | 2 +- dynamic/get_dynamic_detail.md | 4 +- dynamic/tag_dynamics.md | 8 +- electric/Bcoin.md | 20 +-- electric/WeChat&Alipay.md | 6 +- electric/charge_list.md | 26 +-- emoji/action.md | 8 +- emoji/list.md | 12 +- fav/info.md | 18 +-- fav/list.md | 12 +- garb/color.md | 4 +- garb/skin.md | 6 +- history&toview/history.md | 40 ++--- history&toview/toview.md | 24 +-- live/info.md | 22 +-- live/live_area.md | 10 +- live/live_stream.md | 2 +- live/manage.md | 10 +- live/message_stream.md | 4 +- login/login_action/QR.md | 10 +- login/login_action/SMS.md | 2 +- login/login_action/password.md | 6 +- login/login_action/readme.md | 4 +- login/login_info.md | 6 +- login/login_notice.md | 6 +- login/member_center.md | 4 +- message/private_msg.md | 8 +- newbie_exam/info.md | 4 +- note/action.md | 10 +- note/info.md | 24 +-- note/list.md | 6 +- other/API_auth.md | 4 +- other/{bvID.md => bvid_desc.md} | 28 ++-- ranking&dynamic/dynamic.md | 4 +- ranking&dynamic/ranking.md | 4 +- search/hot.md | 8 +- search/search_request.md | 4 +- search/search_response.md | 46 +++--- user/info.md | 16 +- user/relation.md | 166 +++++++++---------- user/space.md | 190 +++++++++++----------- user/status_number.md | 18 +-- video/attribute_data.md | 71 ++++++++ video/info.md | 261 ++++++++++++++---------------- video/interact_video.md | 24 +-- video/like_coin_fav.md | 62 +++---- video/pbp.md | 8 +- video/recommend.md | 8 +- video/report.md | 18 +-- video/snapshot.md | 18 +-- video/status_number.md | 26 +-- video/tags.md | 18 +-- video/video_zone.md | 44 ++--- video/videostream_url.md | 20 +-- 87 files changed, 1027 insertions(+), 978 deletions(-) rename other/{bvID.md => bvid_desc.md} (82%) create mode 100644 video/attribute_data.md diff --git a/APP_widget/splash.md b/APP_widget/splash.md index f0c4df4..0f2b659 100644 --- a/APP_widget/splash.md +++ b/APP_widget/splash.md @@ -53,7 +53,7 @@ | 字段 | 类型 | 内容 | 备注 | | -------- | ---- | --------------------- | ---- | -| id | num | 开屏图片ID | | +| id | num | 开屏图片id | | | thumb | str | 开屏图片url | | | logo_url | str | “bilibili”logo图片url | | @@ -67,7 +67,7 @@ | 字段 | 类型 | 内容 | 备注 | | ----------- | ---- | ---------- | ------------ | -| id | num | 开屏图片ID | | +| id | num | 开屏图片id | | | begin_time | num | 起始时间？ | 时间戳 | | end_time | num | 结束时间？ | 时间戳 | | probability | num | 0 | 作用尚不明确 | @@ -136,7 +136,7 @@ curl -G 'http://app.bilibili.com/x/v2/splash/brand/list' \ -如ID=11的图片为： +如id=11的图片为： ![]( http://i0.hdslb.com/bfs/archive/fe737da5cdedf9dad038e5fd30e957be8a063bc2.png ) diff --git a/README.md b/README.md index f97d23e..a2018e3 100644 --- a/README.md +++ b/README.md @@ -45,7 +45,7 @@ PS：所有http协议地址均可使用https，文档中为了统一写作`http` - [API认证与鉴权（APP与Cookie方式）](other/API_auth.md)× - [公共错误码](other/errcode.md)√ - [图片格式化](other/picture.md)√ -- [bvID说明](other/bvID.md)√ +- [bvid说明](other/bvid_desc.md)√ - [grpc接口](grpc_api)× - [登录](login) - [登录操作（人机认证）](login/login_action)√ @@ -79,6 +79,7 @@ PS：所有http协议地址均可使用https，文档中为了统一写作`http` - [互动视频](video/interact_video.md)× - [高能进度条](video/pbp.md)√ - [信息上报（心跳及记录历史）](video/report.md)× + - [视频属性数据](video/attribute_data.md)√ - [剧集（番剧、影视）](bangumi) - [基本信息](bangumi/info.md)× - 状态数 diff --git a/album/action.md b/album/action.md index e6fe4aa..79d6240 100644 --- a/album/action.md +++ b/album/action.md @@ -18,7 +18,7 @@ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ---------- | ---- | ------------------------ | ------ | ---------------------- | -| doc_id | num | 相簿ID | 必要 | | +| doc_id | num | 相簿id | 必要 | | | type | num | 操作方式 | 必要 | 1：点赞
2：取消赞 | | csrf_token | str | CSRF Token（位于cookie） | 非必要 | | @@ -41,7 +41,7 @@ **示例：** -点赞相簿`ID=99184721` +点赞相簿`id=99184721` ```shell curl 'http://api.vc.bilibili.com/link_draw/v2/Vote/operate' \ @@ -79,7 +79,7 @@ curl 'http://api.vc.bilibili.com/link_draw/v2/Vote/operate' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ---------- | ---- | ------------------------ | ------ | ------------ | -| fav_id | num | 相簿ID | 必要 | | +| fav_id | num | 相簿id | 必要 | | | biz_type | num | 2 | 必要 | 作用尚不明确 | | csrf_token | str | CSRF Token（位于cookie） | 非必要 | | @@ -96,7 +96,7 @@ curl 'http://api.vc.bilibili.com/link_draw/v2/Vote/operate' \ **示例：** -收藏相簿`ID=99184721` +收藏相簿`id=99184721` ```shell curl 'http:///api.vc.bilibili.com/user_plus/v1/Fav/add' \ @@ -133,7 +133,7 @@ curl 'http:///api.vc.bilibili.com/user_plus/v1/Fav/add' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ---------- | ---- | ------------------------ | ------ | ------------ | -| fav_id | num | 相簿ID | 必要 | | +| fav_id | num | 相簿id | 必要 | | | biz_type | num | 2 | 必要 | 作用尚不明确 | | csrf_token | str | CSRF Token（位于cookie） | 非必要 | | @@ -150,7 +150,7 @@ curl 'http:///api.vc.bilibili.com/user_plus/v1/Fav/add' \ **示例：** -取消收藏相簿`ID=99184721` +取消收藏相簿`id=99184721` ```shell curl 'http://api.vc.bilibili.com/user_plus/v1/Fav/delete' \ diff --git a/album/info.md b/album/info.md index 4a1cb23..ff9c529 100644 --- a/album/info.md +++ b/album/info.md @@ -16,7 +16,7 @@ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ---------- | ------ | ---- | -| doc_id | num | 目标相簿ID | 必要 | | +| doc_id | num | 目标相簿id | 必要 | | **json回复：** @@ -40,7 +40,7 @@ | 字段 | 类型 | 内容 | 备注 | | ------------ | ---- | ---------- | ---- | -| uid | num | 作者UID | | +| uid | num | 作者mid | | | head_url | str | 头像url | | | name | str | 昵称 | | | vip | obj | 会员信息 | | @@ -70,8 +70,8 @@ | 字段 | 类型 | 内容 | 备注 | | ----------------- | ----- | ------------------ | ------------------------------------------------------------ | | biz | num | 相簿分区 | 1：画友
2：摄影
3：日常 | -| doc_id | num | 相簿ID | | -| poster_uid | num | 作者UID | | +| doc_id | num | 相簿id | | +| poster_uid | num | 作者mid | | | category | str | 子分区标识 | cos：cosplay
daily：日常
illustration：插画
comic：漫画
draw：其他
sifu：私服 | | type | num | 相簿类型 | 0：原创
1：同人 | | title | str | 标题 | | @@ -140,7 +140,7 @@ **示例：** -查询相簿`ID=99184721`的详细信息 +查询相簿`id=99184721`的详细信息 ```shell curl -G 'http://api.vc.bilibili.com/link_draw/v1/doc/detail' \ diff --git a/album/list.md b/album/list.md index ed7f25a..2b61886 100644 --- a/album/list.md +++ b/album/list.md @@ -61,7 +61,7 @@ | 字段 | 类型 | 内容 | 备注 | | -------- | ---- | ------- | ---- | -| uid | num | 作者UID | | +| uid | num | 作者mid | | | head_url | str | 头像url | | | name | str | 昵称 | | @@ -69,8 +69,8 @@ | 字段 | 类型 | 内容 | 备注 | | ------------- | ----- | ---------- | --------------------------------- | -| doc_id | num | 相簿ID | | -| poster_uid | num | 作者UID | | +| doc_id | num | 相簿id | | +| poster_uid | num | 作者mid | | | pictures | array | 相簿图片 | | | title | str | 标题 | | | category | str | 子分区名 | | @@ -1340,7 +1340,7 @@ curl -G 'http://api.vc.bilibili.com/link_draw/v2/Photo/list' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ---------- | ---- | -------- | ------ | --------------------------------------------- | | biz | num | 分区 | 非必要 | 0：全部
1：画友
2：摄影
默认为0 | -| poster_uid | num | 作者UID | 必要 | 默认为20 | +| poster_uid | num | 作者mid | 必要 | 默认为20 | | page_num | num | 页码 | 非必要 | 默认为1 | | page_size | num | 每页项数 | 非必要 | 默认为45 | @@ -1367,7 +1367,7 @@ curl -G 'http://api.vc.bilibili.com/link_draw/v2/Photo/list' \ | 字段 | 类型 | 内容 | 备注 | | -------- | ---- | ------- | ---- | -| uid | str | 作者UID | | +| uid | str | 作者mid | | | head_url | str | 头像url | | | name | str | 昵称 | | diff --git a/album/recommend_author.md b/album/recommend_author.md index dd54b06..4ed63b5 100644 --- a/album/recommend_author.md +++ b/album/recommend_author.md @@ -40,7 +40,7 @@ | 字段 | 类型 | 内容 | 备注 | | ----------- | ---- | ------- | ------------ | -| uid | num | 作者UID | | +| uid | num | 作者mid | | | head_url | str | 头像url | | | name | str | 昵称 | | | is_followed | num | 0 | 作用尚不明确 | diff --git a/article/articles.md b/article/articles.md index becf687..b1a80cb 100644 --- a/article/articles.md +++ b/article/articles.md @@ -16,7 +16,7 @@ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | -------- | ------ | ---- | -| id | num | 文集rlID | 必要 | | +| id | num | 文集rlid | 必要 | | **json回复：** @@ -43,8 +43,8 @@ | 字段 | 类型 | 内容 | 备注 | | -------------- | ---- | --------------- | ------------ | -| id | num | 文集rlID | | -| mid | num | 文集作者UID | | +| id | num | 文集rlid | | +| mid | num | 文集作者mid | | | name | str | 文集名称 | | | image_url | str | 文集封面图片url | | | update_time | num | 文集更新时间 | 时间戳 | @@ -70,7 +70,7 @@ | 字段 | 类型 | 内容 | 备注 | | ------------ | ----- | -------------- | ------------------------------------------------------------ | -| id | num | 专栏cvID | | +| id | num | 专栏cvid | | | title | str | 文章标题 | | | state | num | 0 | 作用尚不明确 | | publish_time | num | 发布时间 | 秒时间戳 | @@ -99,7 +99,7 @@ | 字段 | 类型 | 内容 | 备注 | | --------------- | ---- | -------------- | ---- | -| mid | num | 作者UID | | +| mid | num | 作者mid | | | name | str | 作者昵称 | | | face | str | 作者头像url | | | official_verify | obj | 作者认证信息 | | diff --git a/article/info.md b/article/info.md index 42854c2..b6bbbea 100644 --- a/article/info.md +++ b/article/info.md @@ -16,7 +16,7 @@ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | -------- | ------ | ---- | -| id | num | 专栏cvID | 必要 | | +| id | num | 专栏cvid | 必要 | | **json回复：** @@ -40,7 +40,7 @@ | stats | obj | 状态数信息 | | | title | str | 文章标题 | | | banner_url | str | 文章头图url | | -| mid | num | 文章作者UID | | +| mid | num | 文章作者mid | | | author_name | str | 文章作者昵称 | | | is_author | bool | true | 作用尚不明确 | | image_urls | array | 动态封面 | | @@ -49,8 +49,8 @@ | show_later_watch | bool | true | 作用尚不明确 | | show_small_window | bool | true | 作用尚不明确 | | in_list | bool | 是否收于文集 | false：否
true：是 | -| pre | num | 上一篇文章cvID | 无为0 | -| next | num | 下一篇文章cvID | 无为0 | +| pre | num | 上一篇文章cvid | 无为0 | +| next | num | 下一篇文章cvid | 无为0 | | share_channels | array | 分享方式列表 | | `stats`对象： diff --git a/article/like_coin_fav.md b/article/like_coin_fav.md index 44d1a4f..fa8ca0f 100644 --- a/article/like_coin_fav.md +++ b/article/like_coin_fav.md @@ -20,7 +20,7 @@ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ------------------- | ------ | ---------------------- | -| id | num | 文章cvID | 必要 | | +| id | num | 文章cvid | 必要 | | | type | num | 操作方式 | 必要 | 1：点赞
2：取消赞 | | csrf | str | CSRF Token（位于cookie） | 必要 | | @@ -73,7 +73,7 @@ curl 'http://api.bilibili.com/x/article/like' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | -------- | ---- | ------------------- | ------ | ------- | -| aid | num | 文章cvID | 必要 | | +| aid | num | 文章cvid | 必要 | | | multiply | num | 投币数量 | 必要 | 上限为2 | | avtype | num | 2 | 必要 | 必须为2 | | csrf | str | CSRF Token（位于cookie） | 必要 | | @@ -138,7 +138,7 @@ curl 'http://api.bilibili.com/x/web-interface/coin/add' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ------------------- | ------ | ---- | -| id | num | 文章cvID | 必要 | | +| id | num | 文章cvid | 必要 | | | csrf | str | CSRF Token（位于cookie） | 必要 | | **json回复：** diff --git a/audio/coin&fav.md b/audio/coin&fav.md index 416f3e9..895fb54 100644 --- a/audio/coin&fav.md +++ b/audio/coin&fav.md @@ -19,7 +19,7 @@ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | -------- | ------ | ---- | -| sid | num | 音频auID | 必要 | | +| sid | num | 音频auid | 必要 | | **json回复：** @@ -68,7 +68,7 @@ curl -G 'http://www.bilibili.com/audio/music-service-c/web/collections/songs-col | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | -------- | ------ | ---- | -| sid | num | 音频auID | 必要 | | +| sid | num | 音频auid | 必要 | | **json回复：** diff --git a/audio/info.md b/audio/info.md index 0312c84..17c8b9e 100644 --- a/audio/info.md +++ b/audio/info.md @@ -19,7 +19,7 @@ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | -------- | ------ | ---- | -| sid | num | 音频auID | 必要 | | +| sid | num | 音频auid | 必要 | | **json回复：** @@ -35,8 +35,8 @@ | 字段 | 类型 | 内容 | 备注 | | ---------- | ------ | ------------------ | ------------------ | -| id | num | 音频auID | | -| uid | num | UP主UID | | +| id | num | 音频auid | | +| uid | num | UP主mid | | | uname | str | UP主昵称 | | | author | str | 作者名 | | | title | str | 歌曲标题 | | @@ -47,9 +47,9 @@ | duration | num | 歌曲时间长度 | 单位为秒 | | passtime | num | 歌曲发布时间 | 时间戳 | | curtime | num | 当前请求时间 | 时间戳 | -| aid | num | 关联稿件avID | 无为0 | -| bvid | str | 关联稿件bvID | 无为空 | -| cid | num | 关联视频CID | 无为0 | +| aid | num | 关联稿件avid | 无为0 | +| bvid | str | 关联稿件bvid | 无为空 | +| cid | num | 关联视频cid | 无为0 | | msid | num | 0 | **作用尚不明确** | | attr | num | 0 | **作用尚不明确** | | limit | num | 0 | **作用尚不明确** | @@ -58,14 +58,14 @@ | ctime | null | - | **作用尚不明确** | | statistic | obj | 状态数 | | | vipInfo | obj | UP主会员状态 | | -| collectIds | array | 歌曲所在的收藏夹ID | 需要登录(SESSDATA) | +| collectIds | array | 歌曲所在的收藏夹mlid | 需要登录(SESSDATA) | | coin_num | num | 投币数 | | `data`中的`statistic`对象： | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | ---- | -| sid | num | 音频auID | | +| sid | num | 音频auid | | | play | num | 播放次数 | | | collect | num | 收藏数 | | | comment | num | 评论数 | | @@ -84,8 +84,8 @@ | 项 | 类型 | 内容 | 备注 | | ---- | ---- | ------------------------- | ---- | -| 0 | num | 第1个所在的收藏夹ID | | -| n | num | 第（n+1）个所在的收藏夹ID | | +| 0 | num | 第1个所在的收藏夹mlid | | +| n | num | 第（n+1）个所在的收藏夹mlid | | | …… | num | …… | …… | **示例：** @@ -160,7 +160,7 @@ curl -G 'http://www.bilibili.com/audio/music-service-c/web/song/info' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | -------- | ------ | ---- | -| sid | num | 音频auID | 必要 | | +| sid | num | 音频auid | 必要 | | **json回复：** @@ -186,7 +186,7 @@ curl -G 'http://www.bilibili.com/audio/music-service-c/web/song/info' \ | ------- | ---- | ---------- | ---------------- | | type | str | song | **作用尚不明确** | | subtype | num | ？？？ | **作用尚不明确** | -| key | num | TAG ID？？ | **作用尚不明确** | +| key | num | TAG id？？ | **作用尚不明确** | | info | str | TAG名 | | **示例：** @@ -258,7 +258,7 @@ curl -G 'http://www.bilibili.com/audio/music-service-c/web/tag/song' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | -------- | ------ | ---- | -| sid | num | 音频auID | 必要 | | +| sid | num | 音频auid | 必要 | | **json回复：** @@ -299,7 +299,7 @@ curl -G 'http://www.bilibili.com/audio/music-service-c/web/tag/song' \ | --------- | ---- | ---------- | ---------------- | | mid | num | 0 | **作用尚不明确** | | name | str | 成员名 | | -| member_id | num | 成员ID？？ | **作用尚不明确** | +| member_id | num | 成员id？？ | **作用尚不明确** | **示例：** @@ -396,7 +396,7 @@ curl -G 'http://www.bilibili.com/audio/music-service-c/web/member/song' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | -------- | ------ | ---- | -| sid | num | 音频auID | 必要 | | +| sid | num | 音频auid | 必要 | | **json回复：** diff --git a/audio/music_list.md b/audio/music_list.md index 0d2bf19..bb1d15a 100644 --- a/audio/music_list.md +++ b/audio/music_list.md @@ -47,16 +47,16 @@ | 项 | 类型 | 内容 | 备注 | | ---- | ---- | ----------------- | ---- | -| 0 | obj | 音频收藏夹ID1 | | -| n | obj | 音频收藏夹ID(n+1) | | +| 0 | obj | 音频收藏夹mlid1 | | +| n | obj | 音频收藏夹mlid(n+1) | | | …… | obj | …… | …… | `data`数组中的对象： | 字段 | 类型 | 内容 | 备注 | | --------- | ------ | ------------------------ | -------------------------------- | -| id | num | 音频收藏夹ID | | -| uid | num | 创建用户UID | | +| id | num | 音频收藏夹mlid | | +| uid | num | 创建用户mid | | | uname | str | 创建用户昵称 | | | title | str | 歌单标题 | | | type | num | 收藏夹属性 | 0：普通收藏夹
1：默认收藏夹 | @@ -66,22 +66,22 @@ | song | num | 歌单中的音乐数量 | | | desc | str | 歌单备注信息 | | | sids | array | 歌单中的音乐 | | -| menuId | num | 音频收藏夹对应的歌单amID | | +| menuId | num | 音频收藏夹对应的歌单amid | | | statistic | obj | 歌单状态数信息 | | `data`中的`sids`数组： | 项 | 类型 | 内容 | 备注 | | ---- | ---- | ------------------- | ---------------- | -| 0 | num | 收藏的音频auID1 | | -| n | num | 收藏的音频auID(n+1) | 按照歌单顺序排列 | +| 0 | num | 收藏的音频auid1 | | +| n | num | 收藏的音频auid(n+1) | 按照歌单顺序排列 | | …… | num | …… | …… | `data`中的`statistic`对象： | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | ------------------------ | ---- | -| sid | num | 音频收藏夹对应的歌单amID | | +| sid | num | 音频收藏夹对应的歌单amid | | | play | num | 播放次数 | | | collect | num | 点赞次数 | | | comment | null | - | | @@ -188,7 +188,7 @@ curl -G 'http://www.bilibili.com/audio/music-service-c/web/collections/list' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ------------ | ------ | ------------------ | -| sid | num | 音频收藏夹ID | 必要 | 必须为默认收藏夹ID | +| sid | num | 音频收藏夹mlid | 必要 | 必须为默认收藏夹mlid | **json回复：** @@ -204,8 +204,8 @@ curl -G 'http://www.bilibili.com/audio/music-service-c/web/collections/list' \ | 字段 | 类型 | 内容 | 备注 | | --------- | ------ | ------------------------ | ---------------------- | -| id | num | 音频收藏夹ID | | -| uid | num | 创建用户UID | | +| id | num | 音频收藏夹mlid | | +| uid | num | 创建用户mid | | | uname | str | 创建用户昵称 | | | title | str | 默认歌单 | 恒为`默认歌单` | | type | num | 1 | 恒为`1` | @@ -215,22 +215,22 @@ curl -G 'http://www.bilibili.com/audio/music-service-c/web/collections/list' \ | song | num | 歌单中的音乐数量 | | | desc | str | 空 | 恒为空 | | sids | array | 歌单中的音乐 | | -| menuId | num | 音频收藏夹对应的歌单amID | 与普通歌单不同通用 | +| menuId | num | 音频收藏夹对应的歌单amid | 与普通歌单不同通用 | | statistic | obj | 歌单状态数信息 | | `data`中的`sids`数组： | 项 | 类型 | 内容 | 备注 | | ---- | ---- | ------------------- | ---------------- | -| 0 | num | 收藏的音频auID1 | | -| n | num | 收藏的音频auID(n+1) | 按照歌单顺序排列 | +| 0 | num | 收藏的音频auid1 | | +| n | num | 收藏的音频auid(n+1) | 按照歌单顺序排列 | | …… | num | …… | …… | `data`中的`statistic`对象： | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | ------------------------ | ---- | -| sid | num | 音频收藏夹对应的歌单amID | | +| sid | num | 音频收藏夹对应的歌单amid | | | play | num | 0 | | | collect | num | 0 | | | comment | null | - | | @@ -238,7 +238,7 @@ curl -G 'http://www.bilibili.com/audio/music-service-c/web/collections/list' \ **示例：** -查询我的默认歌单，ID为` 15967839 ` +查询我的默认歌单，id为` 15967839 ` ```shell curl -G 'http://www.bilibili.com/audio/music-service-c/web/collections/info' \ diff --git a/audio/musicstream_url.md b/audio/musicstream_url.md index 515fa42..2a314a1 100644 --- a/audio/musicstream_url.md +++ b/audio/musicstream_url.md @@ -31,7 +31,7 @@ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | -------- | ------ | ---- | -| sid | num | 音频auID | 必要 | | +| sid | num | 音频auid | 必要 | | **json回复：** @@ -47,7 +47,7 @@ | 字段 | 类型 | 内容 | 备注 | | --------- | ----- | --------- | --------------------------------------- | -| sid | num | 音频auID | | +| sid | num | 音频auid | | | type | num | 音质标识 | -1：试听片段（192K）
1：192K | | info | str | 空 | **作用尚不明确** | | timeout | num | 有效时长 | 单位为秒
一般为3h | @@ -115,10 +115,10 @@ curl -G 'http://www.bilibili.com/audio/music-service-c/web/url' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ---------- | ---- | ------------ | ----------- | -------------- | | access_key | str | APP登录Token | APP方式必要 | | -| songid | num | 音频auID | 必要 | | +| songid | num | 音频auid | 必要 | | | quality | num | 音质代码 | 必要 | **详情见上表** | | privilege | num | 必须为`2` | 必要 | | -| mid | num | 当前用户UID | 必要 | 可为任意值 | +| mid | num | 当前用户mid | 必要 | 可为任意值 | | platform | str | 平台标识 | 必要 | 可为任意值 | **json回复：** @@ -135,7 +135,7 @@ curl -G 'http://www.bilibili.com/audio/music-service-c/web/url' \ | 字段 | 类型 | 内容 | 备注 | | --------- | ----- | ----------- | ------------------------------------------------------------ | -| sid | num | 音频auID | | +| sid | num | 音频auid | | | type | num | 音质标识 | -1：试听片段（192K）
0：128K
1：192K
2：320K
3：FLAC | | info | str | 空 | **作用尚不明确** | | timeout | num | 有效时长 | 单位为秒
一般为3h | diff --git a/audio/status_number.md b/audio/status_number.md index 44c798b..a5ca235 100644 --- a/audio/status_number.md +++ b/audio/status_number.md @@ -16,7 +16,7 @@ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | -------- | ------ | ---- | -| sid | num | 音频auID | 必要 | | +| sid | num | 音频auid | 必要 | | **json回复：** @@ -32,7 +32,7 @@ | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | ---- | -| sid | num | 音频auID | | +| sid | num | 音频auid | | | play | num | 播放次数 | | | collect | num | 收藏数 | | | comment | num | 评论数 | | diff --git a/bangumi/info.md b/bangumi/info.md index 1a802a2..cb80838 100644 --- a/bangumi/info.md +++ b/bangumi/info.md @@ -1,11 +1,11 @@ # 剧集基本信息 -- [剧集基本信息（mdID方式）](#剧集基本信息（mdID方式）) -- [获取剧集明细（web端）（ssID/epID方式）](#获取剧集明细（web端）（ssID/epID方式）) +- [剧集基本信息（mdid方式）](#剧集基本信息（mdid方式）) +- [获取剧集明细（web端）（ssid/epid方式）](#获取剧集明细（web端）（ssid/epid方式）) --- -## 剧集基本信息（mdID方式） +## 剧集基本信息（mdid方式） > http://api.bilibili.com/pgc/review/user @@ -18,7 +18,7 @@ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | -------- | ---- | -------- | ------ | ---- | -| media_id | str | 剧集mdID | 必要 | | +| media_id | str | 剧集mdid | 必要 | | **json回复：** @@ -43,10 +43,10 @@ | --------- | ----- | -------------- | -------------------------- | | areas | array | 地区 | | | cover | str | 封面图片url | | -| media_id | num | 剧集mdID | | +| media_id | num | 剧集mdid | | | new_ep | obj | 最新一话信息 | | | rating | obj | 评分信息 | | -| season_id | int | 剧集ssID | | +| season_id | int | 剧集ssid | | | share_url | url | 剧集详情页连接 | | | title | str | 标题 | | | type_name | str | 剧集类型 | `番剧`、`国创`、`电影`等等 | @@ -70,7 +70,7 @@ | 字段 | 类型 | 内容 | 备注 | | ---------- | ---- | ---------------- | -------------------------- | -| id | int | 最新一话的epID | | +| id | int | 最新一话的epid | | | index | str | 最新一话名称 | | | index_show | str | 最新一话显示名称 | eg. `第1话`、`更新至第4话` | @@ -139,7 +139,7 @@ curl -G 'http://api.bilibili.com/pgc/review/user' \ -## 获取剧集明细（web端）（ssID/epID方式） +## 获取剧集明细（web端）（ssid/epid方式） > http://api.bilibili.com/pgc/view/web/season @@ -149,8 +149,8 @@ curl -G 'http://api.bilibili.com/pgc/review/user' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | --------- | ---- | -------- | ------------ | ------------------------ | -| season_id | num | 番剧ssID | 必要（可选） | season_id与ep_id任选其一 | -| ep_id | num | 剧集epID | 必要（可选） | season_id与ep_id任选其一 | +| season_id | num | 番剧ssid | 必要（可选） | season_id与ep_id任选其一 | +| ep_id | num | 剧集epid | 必要（可选） | season_id与ep_id任选其一 | **json回复：** @@ -175,7 +175,7 @@ curl -G 'http://api.bilibili.com/pgc/review/user' \ | evaluate | str | 简介 | | | jp_title | str | 空 | 作用尚不明确 | | link | str | 简介页面url | | -| media_id | num | 剧集mdID | | +| media_id | num | 剧集mdid | | | mode | num | 2 | 作用尚不明确 | | new_ep | obj | 更新信息 | | | payment | obj | 会员&付费信息 | 若无相关内容则无此项 | @@ -184,7 +184,7 @@ curl -G 'http://api.bilibili.com/pgc/review/user' \ | rating | obj | 评分信息 | 若无相关内容则无此项 | | record | str | 备案号 | 无则为空 | | rights | obj | 属性标志信息 | | -| season_id | num | 番剧ssID | | +| season_id | num | 番剧ssid | | | season_title | str | 剧集标题 | | | seasons | array | 同系列所以季信息 | | | section | array | 花絮、PV、番外等非正片内容 | 若无相关内容则无此项 | @@ -222,16 +222,16 @@ curl -G 'http://api.bilibili.com/pgc/review/user' \ | 字段 | 类型 | 内容 | 备注 | | ------------ | ---- | --------------------------------- | -------------------- | -| aid | num | 单集稿件avID | | +| aid | num | 单集稿件avid | | | badge | str | 标签文字 | 例如`会员`、`限免`等 | | badge_info | obj | | | | badge_type | num | | | -| bvid | str | 单集稿件bvID | | -| cid | num | 视频CID | | +| bvid | str | 单集稿件bvid | | +| cid | num | 视频cid | | | cover | str | 单集封面url | | | dimension | obj | 分辨率信息 | | | from | str | | | -| id | num | 单集epID | | +| id | num | 单集epid | | | link | str | 单集网页url | | | long_title | str | 单集完整标题 | | | pub_time | num | 发布时间 | 时间戳 | @@ -244,7 +244,7 @@ curl -G 'http://api.bilibili.com/pgc/review/user' \ | status | num | | | | subtitle | str | 单集副标题 | 观看次数文字 | | title | str | 单集标题 | | -| vid | str | 单集vID | vupload_+{CID} | +| vid | str | 单集vid | vupload_+{cid} | @@ -257,7 +257,7 @@ curl -G 'http://api.bilibili.com/pgc/review/user' \ | 字段 | 类型 | 内容 | 备注 | | ------ | ---- | ------------ | ---------------- | | desc | str | 更新备注 | | -| id | num | 最新一话epID | | +| id | num | 最新一话epid | | | is_new | num | 是否最新发布 | 0：否
1：是 | | title | str | 最新一话标题 | | @@ -365,7 +365,7 @@ curl -G 'http://api.bilibili.com/pgc/review/user' \ | ---------- | ----- | -------- | ---- | | episode_id | num | 0 | | | episodes | array | 板块内容 | | -| id | num | 板块ID？ | | +| id | num | 板块id？ | | | title | str | 板块标题 | | | type | num | ？ | | @@ -383,7 +383,7 @@ curl -G 'http://api.bilibili.com/pgc/review/user' \ | 字段 | 类型 | 内容 | 备注 | | ------------ | ---- | ------ | ---- | -| series_id | num | 系列ID | | +| series_id | num | 系列id | | | series_title | str | 系列名 | | `result`中的`show`对象： @@ -411,7 +411,7 @@ curl -G 'http://api.bilibili.com/pgc/review/user' \ | avatar | str | 头像图片url | | | follower | num | 粉丝数 | | | is_follow | num | 0 | | -| mid | num | UP主UID | | +| mid | num | UP主mid | | | pendant | obj | | | | theme_type | num | 0 | | | uname | str | UP主昵称 | | diff --git a/blackroom/banlist.md b/blackroom/banlist.md index eb7944e..c1a8945 100644 --- a/blackroom/banlist.md +++ b/blackroom/banlist.md @@ -95,10 +95,10 @@ | 字段 | 类型 | 内容 | 备注 | | ------------------- | ---- | --------------- | ---------------------------- | -| id | num | 封禁公示ID | | +| id | num | 封禁公示id | | | uname | str | 对象用户名 | | | face | str | 对象用户头像url | | -| uid | num | 对象用户UID | | +| uid | num | 对象用户mid | | | originTitle | str | 来源标题 | | | blockedRemark | str | | | | originUrl | str | 来源url | | @@ -117,7 +117,7 @@ | reasonType | num | 违规类型 | **见上表** | | reasonTypeName | str | 违规类型名称 | | | operatorName | str | 空 | 作用尚不明确 | -| caseId | num | 仲裁信息ID | 系统封禁时固定为0 | +| caseId | num | 仲裁信息id | 系统封禁时固定为0 | | ctime | num | 创建时间 | 时间戳 | | commentSum | num | 该条目评论数 | | @@ -210,7 +210,7 @@ curl -G 'http://api.bilibili.com/x/credit/blocked/list' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ---------- | ------ | ---- | -| id | num | 封禁公示ID | 必要 | | +| id | num | 封禁公示id | 必要 | | **json回复：** @@ -227,10 +227,10 @@ curl -G 'http://api.bilibili.com/x/credit/blocked/list' \ | 字段 | 类型 | 内容 | 备注 | | ------------------- | ---- | --------------- | ---------------------------- | -| id | num | 封禁公示ID | | +| id | num | 封禁公示id | | | uname | str | 对象用户名 | | | face | str | 对象用户头像url | | -| uid | num | 对象用户UID | | +| uid | num | 对象用户mid | | | originTitle | str | 来源标题 | | | blockedRemark | str | | | | originUrl | str | 来源url | | @@ -255,7 +255,7 @@ curl -G 'http://api.bilibili.com/x/credit/blocked/list' \ **示例：** -查询公示ID为`1091621`的公示详情 +查询公示id为`1091621`的公示详情 ```shell curl -G 'http://api.bilibili.com/x/credit/blocked/info' \ diff --git a/blackroom/jury/action.md b/blackroom/jury/action.md index d0bd827..5b26b7a 100644 --- a/blackroom/jury/action.md +++ b/blackroom/jury/action.md @@ -96,7 +96,7 @@ curl 'http://api.bilibili.com/x/credit/jury/apply' \ | 字段 | 类型 | 内容 | 备注 | | ---- | ---- | ---------- | ---- | -| id | num | 仲裁案件ID | | +| id | num | 仲裁案件id | | **示例：** @@ -143,7 +143,7 @@ curl 'http://api.bilibili.com/x/credit/jury/caseObtain' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------------- | ---- | ------------------------ | -------------- | --------------------------------------- | -| cid | num | 案件ID | 必要 | | +| cid | num | 案件id | 必要 | | | vote | num | 投票类型 | 必要 | 见「[众裁信息](judgement_info.md)」中表 | | content | str | 理由 | 非必要 | 见「[众裁信息](judgement_info.md)」中表 | | likes | nums | 支持的观点 | 非必要 | | diff --git a/blackroom/jury/judgement_info.md b/blackroom/jury/judgement_info.md index 9efec8f..c07a686 100644 --- a/blackroom/jury/judgement_info.md +++ b/blackroom/jury/judgement_info.md @@ -32,7 +32,7 @@ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ------------ | ------ | ------------- | ------------- | | access_key | str | APP登录Token | APP方式必要 | | -| cid | num | 案件ID | 必要 | | +| cid | num | 案件id | 必要 | | **json回复：** @@ -49,8 +49,8 @@ | 字段 | 类型 | 内容 | 备注 | | --------- | ------ | -------- | ------------ | -| id | num | 案件ID | | -| mid | num | 被举报用户UID | | +| id | num | 案件id | | +| mid | num | 被举报用户mid | | | status | num | 裁决状态 | 1：投票中
2：停止发放
3：复核中（结案中）
4：已裁决
5：待重启
6：未裁决
7：冻结中
8：队列中 | | statusTitle | str | 封禁时间文字 | `judgeType`=1时有效 | | originType | num | 来源类型 | 见「封禁公示」中表 | @@ -70,7 +70,7 @@ | ctime | num | 举报创建时间 | 时间戳 | | mtime | num | 开始拉取时间 | 时间戳 | | originTitle | str | 来源标题 | | -| relationId | str | 违规关系标识字 | ｛评论rpID｝-｛违规类型ID｝-｛来源对象ID｝ | +| relationId | str | 违规关系标识字 | {评论rpid}-{违规类型id}-{来源对象id} | | face | str | 被举报用户头像url | | | uname | str | 被举报用户昵称 | | | vote | num | 我的投票 | **见上表** | @@ -149,7 +149,7 @@ curl -G 'http://api.bilibili.com/x/credit/jury/juryCase' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ------ | ------ | ---- | -| cid | num | 案件ID | 必要 | | +| cid | num | 案件id | 必要 | | **json回复：** @@ -166,8 +166,8 @@ curl -G 'http://api.bilibili.com/x/credit/jury/juryCase' \ | 字段 | 类型 | 内容 | 备注 | | ------------- | ---- | ----------------- | ------------------------------------------------------------ | -| id | num | 案件ID | | -| mid | num | 被举报用户UID | | +| id | num | 案件id | | +| mid | num | 被举报用户mid | | | status | num | 裁决状态 | 1：投票中
2：停止发放
3：复核中（结案中）
4：已裁决
5：待重启
6：未裁决
7：冻结中
8：队列中 | | originType | num | 来源类型 | 见「封禁公示」中表 | | reasonType | num | 原因类型 | 见「封禁公示」中表 | @@ -185,7 +185,7 @@ curl -G 'http://api.bilibili.com/x/credit/jury/juryCase' \ | ctime | num | 举报创建时间 | 时间戳 | | mtime | num | 开始拉取时间 | 时间戳 | | originTitle | str | 来源标题 | | -| relationId | str | 违规关系标识字 | ｛评论rpID｝-｛违规类型ID｝-｛来源对象ID｝ | +| relationId | str | 违规关系标识字 | {评论rpid}-{违规类型id}-{来源对象id} | | face | str | 被举报用户头像url | | | uname | str | 被举报用户昵称 | | | vote | num | 0 | 固定为0 | @@ -278,8 +278,8 @@ curl -G 'http://api.bilibili.com/x/credit/jury/juryCase' \ | 字段 | 类型 | 内容 | 备注 | | ------------- | ---- | ----------------- | ------------------------------------------------------------ | -| id | num | 案件ID | | -| mid | num | 被举报用户UID | | +| id | num | 案件id | | +| mid | num | 被举报用户mid | | | status | num | 裁决状态 | 1：投票中
2：停止发放
3：复核中（结案中）
4：已裁决
5：待重启
6：未裁决
7：冻结中
8：队列中 | | originType | num | 来源类型 | 见「封禁公示」中表 | | reasonType | num | 原因类型 | 见「封禁公示」中表 | @@ -298,7 +298,7 @@ curl -G 'http://api.bilibili.com/x/credit/jury/juryCase' \ | ctime | num | 举报创建时间 | 时间戳 | | mtime | num | 开始拉取时间 | 时间戳 | | originTitle | str | 来源标题 | | -| relationId | str | 违规关系标识字 | ｛评论rpID｝-｛违规类型ID｝-｛来源对象ID｝ | +| relationId | str | 违规关系标识字 | {评论rpid}-{违规类型id}-{来源对象id} | | face | str | 被举报用户头像url | | | uname | str | 被举报用户昵称 | | | vote | num | 我的投票 | **见上表** | @@ -413,10 +413,10 @@ curl -G 'http://api.bilibili.com/x/credit/jury/caseList' \ | 字段 | 类型 | 内容 | 备注 | | --------- | ------ | -------- | ------------ | -| mid | num | 用户UID | 仅非匿名有此项 | +| mid | num | 用户mid | 仅非匿名有此项 | | face | str | 用户头像 | 仅非匿名有此项 | | name | str | 用户昵称 | 仅非匿名有此项 | -| opid | num | 观点ID | | +| opid | num | 观点id | | | vote | num | 投票选择 | **见上表** | | content | str | 观点内容 | | | attr | num | 是否匿名 | 0：匿名
1：不匿名 | diff --git a/broadcast/video_room.md b/broadcast/video_room.md index 37edd44..c4ae9ff 100644 --- a/broadcast/video_room.md +++ b/broadcast/video_room.md @@ -16,7 +16,7 @@ | 字段 | 类型 | 内容 | 备注 | | -------- | ------ | -------- | ------------------------------ | -| room_id | str | 目标视频 | `video://{稿件avID}/{视频CID}` | +| room_id | str | 目标视频 | `video://{稿件avid}/{视频cid}` | | platform | str | 平台标识 | 默认为`web` | | accepts | array | 操作标识 | | @@ -29,7 +29,7 @@ **示例：** -发送视频`av706`（1P的CID为` 3724723 `）的认证包 +发送视频`av706`（1P的cid为` 3724723 `）的认证包 ``` 00000000 00 00 00 55 00 12 00 01 00 00 00 07 00 00 00 01 |...U............| @@ -105,7 +105,7 @@ | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | ------------ | ------------------------------ | | online | num | 实时观看人数 | | -| room_id | str | 目标视频 | `video://{稿件avID}/{视频CID}` | +| room_id | str | 目标视频 | `video://{稿件avid}/{视频cid}` | **示例：** diff --git a/cheese/info.md b/cheese/info.md index e7ab183..a1c6e4b 100644 --- a/cheese/info.md +++ b/cheese/info.md @@ -5,17 +5,17 @@ --- -课程ssID与epID和番剧不互通 +课程ssid与epid和番剧不互通 -课程avID与普通视频绝大部分api接口不能互通，少部分互通接口如下： +课程avid与普通视频绝大部分api接口不能互通，少部分互通接口如下： 1. 获取视频简介 2. 查询视频状态数 3. 查询分P列表 4. 视频快照 -5. 获取弹幕（使用CID） +5. 获取弹幕（使用cid） 6. 发送弹幕 -7. 高能进度条（使用CID） +7. 高能进度条（使用cid） ## 获取课程基本信息 @@ -31,8 +31,8 @@ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | --------- | ---- | -------- | ------------ | -------------------------------------------------- | -| season_id | num | 课程ssID | 必要（可选） | season_id与ep_id任选其一
**与番剧ssID不互通** | -| ep_id | num | 课程epID | 必要（可选） | season_id与ep_id任选其一
**与番剧epID不互通** | +| season_id | num | 课程ssid | 必要（可选） | season_id与ep_id任选其一
**与番剧ssid不互通** | +| ep_id | num | 课程epid | 必要（可选） | season_id与ep_id任选其一
**与番剧epid不互通** | **json回复：** @@ -63,7 +63,7 @@ | release_info | str | 更新状态文字+更新连载状态文字 | | | release_info2 | str | 更新连载状态文字 | | | release_status | str | 更新状态文字 | | -| season_id | num | 课程ssID | **与番剧ssID不互通** | +| season_id | num | 课程ssid | **与番剧ssid不互通** | | share_url | str | 页面url | | | short_link | str | bilibili uri链接 | | | stat | obj | 播放数信息 | | @@ -129,11 +129,11 @@ | 字段 | 类型 | 内容 | 备注 | | -------------- | ---- | ---------------- | ------------------------------------------------------------ | -| aid | num | 课程分集avID | **与普通稿件avID部分不互通** | -| cid | num | 课程分集CID | **与普通视频CID部分不互通** | +| aid | num | 课程分集avid | **与普通稿件avid部分不互通** | +| cid | num | 课程分集cid | **与普通视频cid部分不互通** | | duration | num | 课程分集时间长度 | 单位为秒 | | from | str | pugv | | -| id | num | 课程分集epID | **与番剧epID不互通** | +| id | num | 课程分集epid | **与番剧epid不互通** | | index | num | 课程分集数 | | | page | num | 1 | | | play | num | 课程分集播放量 | | @@ -240,7 +240,7 @@ | 字段 | 类型 | 内容 | 备注 | | ------------- | ---- | ------------------ | -------- | -| last_ep_id | num | 最后观看的epID | | +| last_ep_id | num | 最后观看的epid | | | last_ep_index | str | 最后观看的标题 | | | last_time | num | 最后观看的时间进度 | 单位为秒 | @@ -248,7 +248,7 @@ 查询课程`ss61`或分集`ep790`的信息 -ssID方式： +ssid方式： ```shell curl -G 'http://api.bilibili.com/pugv/view/web/season' \ @@ -257,7 +257,7 @@ curl -G 'http://api.bilibili.com/pugv/view/web/season' \ -e 'https://www.bilibili.com' ``` -epID方式： +epid方式： ```shell curl -G 'http://api.bilibili.com/pugv/view/web/season' \ @@ -478,7 +478,7 @@ curl -G 'http://api.bilibili.com/pugv/view/web/season' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | --------- | ---- | -------- | ------ | -------------------- | -| season_id | num | 课程ssID | 必要 | **与番剧ssID不互通** | +| season_id | num | 课程ssid | 必要 | **与番剧ssid不互通** | | ps | num | 每页项数 | 非必要 | 默认为50 | | pn | num | 页码 | 非必要 | 默认为1 | @@ -511,11 +511,11 @@ curl -G 'http://api.bilibili.com/pugv/view/web/season' \ | 字段 | 类型 | 内容 | 备注 | | -------------- | ---- | ---------------- | ------------------------------------------------------------ | -| aid | num | 课程分集avID | **与普通稿件avID部分不互通** | -| cid | num | 课程分集CID | **与普通视频CID部分不互通** | +| aid | num | 课程分集avid | **与普通稿件avid部分不互通** | +| cid | num | 课程分集cid | **与普通视频cid部分不互通** | | duration | num | 课程分集时间长度 | 单位为秒 | | from | str | pugv | | -| id | num | 课程分集epID | **与番剧epID不互通** | +| id | num | 课程分集epid | **与番剧epid不互通** | | index | num | 课程分集数 | | | page | num | 1 | | | play | num | 课程分集播放量 | | diff --git a/cheese/videostream_url.md b/cheese/videostream_url.md index c260498..22733f2 100644 --- a/cheese/videostream_url.md +++ b/cheese/videostream_url.md @@ -23,9 +23,9 @@ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | -------------- | ------ | ------------------------------------------------------------ | -| avid | num | 课程avID | 必要 | | -| ep_id | num | 课程epID | 必要 | | -| cid | num | 视频CID | 必要 | | +| avid | num | 课程avid | 必要 | | +| ep_id | num | 课程epid | 必要 | | +| cid | num | 视频cid | 必要 | | | qn | num | 视频清晰度选择 | 非必要 | 参考[qn定义](../video/videostream_url.md#qn视频清晰度标识) | | fnver | num | 视频流版本 | 非必要 | 参考[fnver定义](../video/videostream_url.md#fnver视频流版本标识) | | fnval | num | 视频流类型 | 非必要 | 参考[fnval定义](../video/videostream_url.md#fnval视频流格式标识) | @@ -120,7 +120,7 @@ **示例：** -获取课程`ep790`（CID=`132105993`，avID=`76973173`）的视频流url，清晰度为1080P60 +获取课程`ep790`（cid=`132105993`，avid=`76973173`）的视频流url，清晰度为1080P60 ```shell curl -G 'http://api.bilibili.com/pugv/player/web/playurl' \ diff --git a/clientinfo/ip.md b/clientinfo/ip.md index 86eb420..b2add2b 100644 --- a/clientinfo/ip.md +++ b/clientinfo/ip.md @@ -32,7 +32,7 @@ | isp | str | 运营商名 | | | latitude | num | 纬度 | | | longitude | num | 经度 | | -| zone_id | num | ip数据库ID | | +| zone_id | num | ip数据库id | | | country_code | num | 国家/地区代码 | | **示例：** diff --git a/comment/action.md b/comment/action.md index 83fbd1f..b04bb1a 100644 --- a/comment/action.md +++ b/comment/action.md @@ -23,9 +23,9 @@ | ---------- | ---- | ------------------------ | -------------- | ------------------------------------------------------------ | | access_key | str | APP登录Token | APP方式必要 | | | type | num | 评论区类型代码 | 必要 | **[类型代码见表](readme.md#评论区类型代码)** | -| oid | num | 目标评论区ID | 必要 | | -| root | num | 根评论rpID | 非必要 | 二级评论以上使用 | -| parent | num | 父评论rpID | 非必要 | 二级评论同根评论ID
大于二级评论为要回复的评论ID | +| oid | num | 目标评论区id | 必要 | | +| root | num | 根评论rpid | 非必要 | 二级评论以上使用 | +| parent | num | 父评论rpid | 非必要 | 二级评论同根评论id
大于二级评论为要回复的评论id | | message | str | 发送评论内容 | 必要 | 最大1000字符
表情使用表情转义符 | | plat | num | 发送平台标识 | 非必要 | 1：web端
2：安卓客户端
3：ios客户端
4：wp客户端
默认为1 | | csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | | @@ -49,14 +49,14 @@ | success_toast | str | 状态文字 | | | need_captcha | bool | false | 评论需要验证码(未证实) | | url | str | 空 | **作用尚不明确** | -| rpid | num | 评论rpID | | -| rpid_str | str | 评论rpID | 字串格式 | -| dialog | num | 回复对方rpID | 若为一级评论则为0
若为二级评论则为该评论ID
大于二级评论为上一级评论ID | -| dialog_str | str | 回复对方rpID | 字串格式 | -| root | num | 根评论rpID | 若为一级评论则为0
大于一级评论则为根评论ID | -| root_str | str | 根评论rpID | 字串格式 | -| parent | num | 回复父评论rpID | 若为一级评论则为0
若为二级评论则为根评论ID
大于二级评论为上一级评论ID | -| parent_str | str | 回复父评论rpID | 字串格式 | +| rpid | num | 评论rpid | | +| rpid_str | str | 评论rpid | 字串格式 | +| dialog | num | 回复对方rpid | 若为一级评论则为0
若为二级评论则为该评论id
大于二级评论为上一级评论id | +| dialog_str | str | 回复对方rpid | 字串格式 | +| root | num | 根评论rpid | 若为一级评论则为0
大于一级评论则为根评论id | +| root_str | str | 根评论rpid | 字串格式 | +| parent | num | 回复父评论rpid | 若为一级评论则为0
若为二级评论则为根评论id
大于二级评论为上一级评论id | +| parent_str | str | 回复父评论rpid | 字串格式 | | emote | obj | 表情转义符信息 | [对象定义见表](readme.md#评论条目对象) | | reply | 有效时：obj
无效时：null | | [对象定义见表](readme.md#评论条目对象) | @@ -249,8 +249,8 @@ curl 'http://api.bilibili.com/x/v2/reply/add' \ | ---------- | ---- | ------------------------ | -------------- | -------------------------------------------- | | access_key | str | APP登录Token | APP方式必要 | | | type | num | 评论区类型代码 | 必要 | **[类型代码见表](readme.md#评论区类型代码)** | -| oid | num | 目标评论区ID | 必要 | | -| rpid | num | 目标评论rpID | 必要 | | +| oid | num | 目标评论区id | 必要 | | +| rpid | num | 目标评论rpid | 必要 | | | action | num | 操作代码 | 非必要 | 默认为0
0：取消赞
1：点赞 | | csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | | @@ -266,7 +266,7 @@ curl 'http://api.bilibili.com/x/v2/reply/add' \ **示例：** -点赞视频`av243322853`下评论`rpID=3039053308` +点赞视频`av243322853`下评论`rpid=3039053308` ```shell curl 'http://api.bilibili.com/x/v2/reply/action' \ @@ -307,8 +307,8 @@ curl 'http://api.bilibili.com/x/v2/reply/action' \ | ---------- | ---- | ------------------------ | -------------- | -------------------------------------------- | | access_key | str | APP登录Token | APP方式必要 | | | type | num | 评论区类型代码 | 必要 | **[类型代码见表](readme.md#评论区类型代码)** | -| oid | num | 目标评论区ID | 必要 | | -| rpid | num | 目标评论rpID | 必要 | | +| oid | num | 目标评论区id | 必要 | | +| rpid | num | 目标评论rpid | 必要 | | | action | num | 操作代码 | 非必要 | 默认为0
0：取消踩
1：点踩 | | csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | | @@ -324,7 +324,7 @@ curl 'http://api.bilibili.com/x/v2/reply/action' \ **示例：** -点踩视频`av243322853`下评论`rpID=3039053308` +点踩视频`av243322853`下评论`rpid=3039053308` ```shell curl 'http://api.bilibili.com/x/v2/reply/hate' \ @@ -365,8 +365,8 @@ curl 'http://api.bilibili.com/x/v2/reply/hate' \ | ---------- | ---- | ------------------------ | -------------- | -------------------------------------------- | | access_key | str | APP登录Token | APP方式必要 | | | type | num | 评论区类型代码 | 必要 | **[类型代码见表](readme.md#评论区类型代码)** | -| oid | num | 目标评论区ID | 必要 | | -| rpid | num | 目标评论rpID | 必要 | | +| oid | num | 目标评论区id | 必要 | | +| rpid | num | 目标评论rpid | 必要 | | | csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | | **json回复：** @@ -381,7 +381,7 @@ curl 'http://api.bilibili.com/x/v2/reply/hate' \ **示例：** -删除`av243322853`下评论`rpID=3039053308` +删除`av243322853`下评论`rpid=3039053308` ```shell curl 'http://api.bilibili.com/x/v2/reply/del' \ @@ -421,8 +421,8 @@ curl 'http://api.bilibili.com/x/v2/reply/del' \ | ---------- | ---- | ------------------------ | -------------- | -------------------------------------------- | | access_key | str | APP登录Token | APP方式必要 | | | type | num | 评论区类型代码 | 必要 | **[类型代码见表](readme.md#评论区类型代码)** | -| oid | num | 目标评论区ID | 必要 | | -| rpid | num | 目标评论rpID | 必要 | | +| oid | num | 目标评论区id | 必要 | | +| rpid | num | 目标评论rpid | 必要 | | | action | num | 操作代码 | 非必要 | 默认为0
0：取消置顶
1：设为置顶 | | csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | | @@ -438,7 +438,7 @@ curl 'http://api.bilibili.com/x/v2/reply/del' \ **示例：** -置顶视频`av243322853`下评论`rpID=2940645593` +置顶视频`av243322853`下评论`rpid=2940645593` ```shell curl 'http://api.bilibili.com/x/v2/reply/top' \ @@ -477,8 +477,8 @@ curl 'http://api.bilibili.com/x/v2/reply/top' \ | ---------- | ---- | ------------------------ | -------------- | -------------------------------------------- | | access_key | str | APP登录Token | APP方式必要 | | | type | num | 评论区类型代码 | 必要 | **[类型代码见表](readme.md#评论区类型代码)** | -| oid | num | 目标评论区ID | 必要 | | -| rpid | num | 目标评论rpID | 必要 | | +| oid | num | 目标评论区id | 必要 | | +| rpid | num | 目标评论rpid | 必要 | | | reason | num | 举报类型 | 必要 | **类型代码见下表** | | content | str | 其他举报备注 | 非必要 | `reason=0`时有效 | | csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | | @@ -518,7 +518,7 @@ curl 'http://api.bilibili.com/x/v2/reply/top' \ **示例：** -举报视频` av752881391 `下评论`rpID=3062537442`，理由是`引战` +举报视频` av752881391 `下评论`rpid=3062537442`，理由是`引战` ```shell curl 'http://api.bilibili.com/x/v2/reply/report' \ diff --git a/comment/list.md b/comment/list.md index f436e58..27af736 100644 --- a/comment/list.md +++ b/comment/list.md @@ -23,7 +23,7 @@ | ---------- | ---- | -------------- | ----------- | -------------------------------------------------------- | | access_key | str | APP登录Token | APP方式必要 | | | type | num | 评论区类型代码 | 必要 | [类型代码见表](readme.md#评论区类型代码) | -| oid | num | 目标评论区ID | 必要 | | +| oid | num | 目标评论区id | 必要 | | | sort | num | 排序方式 | 非必要 | 默认为0
0：按时间
1：按点赞数
2：按回复数 | | nohot | num | 是否不显示热评 | 非必要 | 默认为0
1：不显示
0：显示 | | pn | num | 页码 | 非必要 | 默认为1 | @@ -102,7 +102,7 @@ | 字段 | 类型 | 内容 | 备注 | | ---- | ----------------------------- | ---------- | -------------------------------------- | -| mid | num | UP主UID | | +| mid | num | UP主mid | | | top | 有效时：obj
无效时：null | 置顶条目 | [对象定义见表](readme.md#评论条目对象) | | vote | 有效时：obj
无效时：null | 投票评论？ | | @@ -111,7 +111,7 @@ | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | --------------- | ---- | | content | str | 公告正文 | | -| id | num | 公告ID | | +| id | num | 公告id | | | link | str | 公告页面链接url | | | title | str | 公告标题 | | @@ -2342,7 +2342,7 @@ curl -G 'http://api.bilibili.com/x/v2/reply' \ | ---------- | ---- | -------------- | ----------- | ------------------------------------------------------------ | | access_key | str | APP登录Token | APP方式必要 | | | type | num | 评论区类型代码 | 必要 | [类型代码见表](readme.md#评论区类型代码) | -| oid | num | 目标评论区ID | 必要 | | +| oid | num | 目标评论区id | 必要 | | | mode | num | 排序方式 | 非必要 | 默认为0
0 3：仅按热度
1：按热度+按时间
2：仅按时间 | | next | num | 评论页选择 | 非必要 | 按热度时：热度顺序页码（0为第一页）
按时间时：时间倒序楼层号
默认为0 | | ps | num | 每页项数 | 非必要 | 默认为20
定义域：1-49 | @@ -2442,14 +2442,14 @@ curl -G 'http://api.bilibili.com/x/v2/reply' \ | 字段 | 类型 | 内容 | 备注 | | ---- | ---- | ------- | ---- | -| mid | num | UP主UID | | +| mid | num | UP主mid | | `data`中的`notice`对象： | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | --------------- | ---- | | content | str | 公告正文 | | -| id | num | 公告ID | | +| id | num | 公告id | | | link | str | 公告页面链接url | | | title | str | 公告标题 | | @@ -4724,8 +4724,8 @@ curl -G 'http://api.bilibili.com/x/v2/reply/main' \ | ---------- | ---- | ---------------- | ----------- | ---------------------------------------- | | access_key | str | APP登录Token | APP方式必要 | | | type | num | 评论区类型代码 | 必要 | [类型代码见表](readme.md#评论区类型代码) | -| oid | num | 目标评论区ID | 必要 | | -| root | num | 目标一级评论rpID | 必要 | | +| oid | num | 目标评论区id | 必要 | | +| root | num | 目标一级评论rpid | 必要 | | | pn | num | 二级评论页码 | 非必要 | 默认为1 | | ps | num | 二级评论每页项数 | 非必要 | 默认为20
定义域：1-49 | @@ -4750,7 +4750,7 @@ curl -G 'http://api.bilibili.com/x/v2/reply/main' \ | replies | array | 二级评论列表 | | | root | obj | 根评论 | [对象定义见表](readme.md#评论条目对象) | | show_bvid | bool | true | **作用尚不明确** | -| upper | obj | UP主UID | | +| upper | obj | UP主mid | | `data`中的`page`对象： @@ -4785,11 +4785,11 @@ curl -G 'http://api.bilibili.com/x/v2/reply/main' \ | 字段 | 类型 | 内容 | 备注 | | ---- | ---- | ------- | ---- | -| mid | num | UP主UID | | +| mid | num | UP主mid | | **示例：** -获取视频`av2`下评论`rpID=476670`的二级评论，每页5项，查看第1页 +获取视频`av2`下评论`rpid=476670`的二级评论，每页5项，查看第1页 ```shell curl -G 'http://api.bilibili.com/x/v2/reply/reply' \ @@ -5462,8 +5462,8 @@ curl -G 'http://api.bilibili.com/x/v2/reply/reply' \ | ---------- | ---- | -------------- | ----------- | ---------------------------------------- | | access_key | str | APP登录Token | APP方式必要 | | | type | num | 评论区类型代码 | 必要 | [类型代码见表](readme.md#评论区类型代码) | -| oid | num | 目标评论区ID | 必要 | | -| root | num | 根回复rpID | 必要 | | +| oid | num | 目标评论区id | 必要 | | +| root | num | 根回复rpid | 必要 | | | next | num | 评论页选择 | 非必要 | 第一页为0
默认为0
顺序楼层号 | | ps | num | 每页项数 | 非必要 | 默认为0 | @@ -5488,7 +5488,7 @@ curl -G 'http://api.bilibili.com/x/v2/reply/reply' \ | vote | num | 0 | **作用尚不明确** | | lottery | num | 0 | **作用尚不明确** | | config | obj | 评论区显示控制 | | -| upper | obj | UP主UID | | +| upper | obj | UP主mid | | | show_bvid | bool | true | **作用尚不明确** | | control | obj | 评论区输入属性 | | | root | obj | 根评论 | [对象定义见表](readme.md#评论条目对象) | @@ -5519,7 +5519,7 @@ curl -G 'http://api.bilibili.com/x/v2/reply/reply' \ | 字段 | 类型 | 内容 | 备注 | | ---- | ---- | ------- | ---- | -| mid | num | UP主UID | | +| mid | num | UP主mid | | `data`中的`control`对象： @@ -5537,7 +5537,7 @@ curl -G 'http://api.bilibili.com/x/v2/reply/reply' \ **示例：** -获取视频`av2`下评论`rpID=476670`的二级评论，每页5项，查看第1页 +获取视频`av2`下评论`rpid=476670`的二级评论，每页5项，查看第1页 ```shell curl -G 'http://api.bilibili.com/x/v2/reply/detail' \ @@ -6219,9 +6219,9 @@ curl -G 'http://api.bilibili.com/x/v2/reply/detail' \ | ---------- | ---- | -------------- | ----------- | ---------------------------------------- | | access_key | str | APP登录Token | APP方式必要 | | | type | num | 评论区类型代码 | 必要 | [类型代码见表](readme.md#评论区类型代码) | -| oid | num | 目标评论区ID | 必要 | | -| root | num | 根回复rpID | 必要 | | -| dialog | num | 对话树根rpID | 必要 | | +| oid | num | 目标评论区id | 必要 | | +| root | num | 根回复rpid | 必要 | | +| dialog | num | 对话树根rpid | 必要 | | | size | num | 每页最大项数 | 必要 | | **json回复：** @@ -6247,7 +6247,7 @@ curl -G 'http://api.bilibili.com/x/v2/reply/detail' \ | vote | num | 0 | **作用尚不明确** | | lottery | num | 0 | **作用尚不明确** | | config | obj | 评论区显示控制 | | -| upper | obj | UP主UID | | +| upper | obj | UP主mid | | | show_bvid | bool | true | **作用尚不明确** | | control | obj | 评论区输入属性 | | @@ -6290,7 +6290,7 @@ curl -G 'http://api.bilibili.com/x/v2/reply/detail' \ | 字段 | 类型 | 内容 | 备注 | | ---- | ---- | ------- | ---- | -| mid | num | UP主UID | | +| mid | num | UP主mid | | `data`中的`control`对象： @@ -6308,7 +6308,7 @@ curl -G 'http://api.bilibili.com/x/v2/reply/detail' \ **示例：** -获取视频`av201022189`下评论`rpID=3030790837`的对话`rpID=3030978856`，每页最大5项 +获取视频`av201022189`下评论`rpid=3030790837`的对话`rpid=3030978856`，每页最大5项 ```shell curl -G 'http://api.bilibili.com/x/v2/reply/dialog/cursor' \ @@ -7087,7 +7087,7 @@ curl -G 'http://api.bilibili.com/x/v2/reply/dialog/cursor' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | -------------- | ------ | -------------------------------------------- | | type | num | 评论区类型代码 | 必要 | **[类型代码见表](readme.md#评论区类型代码)** | -| oid | num | 目标评论区ID | 必要 | | +| oid | num | 目标评论区id | 必要 | | **json回复：** diff --git a/comment/readme.md b/comment/readme.md index ee8da48..539343c 100644 --- a/comment/readme.md +++ b/comment/readme.md @@ -17,40 +17,40 @@ | 代码 | 评论区类型 | oid的意义 | | ---- | ----------------------- | ---------- | -| 1 | 视频稿件 | 稿件avID | -| 2 | 话题 | 话题ID | -| 4 | 活动 | 活动ID | -| 5 | 小视频 | 小视频ID | -| 6 | 小黑屋封禁信息 | 封禁公示ID | -| 7 | 公告信息 | 公告ID | -| 8 | 直播活动 | 直播间ID | +| 1 | 视频稿件 | 稿件avid | +| 2 | 话题 | 话题id | +| 4 | 活动 | 活动id | +| 5 | 小视频 | 小视频id | +| 6 | 小黑屋封禁信息 | 封禁公示id | +| 7 | 公告信息 | 公告id | +| 8 | 直播活动 | 直播间id | | 9 | 活动稿件 | | | 10 | 直播公告 | | -| 11 | 相簿（图片动态） | 相簿ID | -| 12 | 专栏 | 专栏cvID | +| 11 | 相簿（图片动态） | 相簿id | +| 12 | 专栏 | 专栏cvid | | 13 | 票务 | | -| 14 | 音频 | 音频auID | -| 15 | 风纪委员会 | 众裁项目ID | +| 14 | 音频 | 音频auid | +| 15 | 风纪委员会 | 众裁项目id | | 16 | 点评 | | -| 17 | 动态（纯文字动态&分享） | 动态ID | +| 17 | 动态（纯文字动态&分享） | 动态id | | 18 | 播单 | | | 19 | 音乐播单 | | | 20 | 漫画 | | | 21 | 漫画 | | -| 22 | 漫画 | 漫画mcID | -| 33 | 课程 | 课程epID | +| 22 | 漫画 | 漫画mcid | +| 33 | 课程 | 课程epid | ## 评论条目对象 | 字段 | 类型 | 内容 | 备注 | | ----------- | ------------------------------- | ---------------- | ------------------------------------------------------------ | -| rpid | num | 评论rpID | | +| rpid | num | 评论rpid | | | oid | num | 评论区对象id | | | type | num | 评论区类型代码 | **类型代码见上表** | -| mid | num | 发送者UID | | -| root | num | 根评论rpID | 若为一级评论则为0
大于一级评论则为根评论ID | -| parent | num | 回复父评论rpID | 若为一级评论则为0
若为二级评论则为根评论rpID
大于二级评论为上一级评论rpID | -| dialog | num | 回复对方rpID | 若为一级评论则为0
若为二级评论则为该评论rpID
大于二级评论为上一级评论rpID | +| mid | num | 发送者mid | | +| root | num | 根评论rpid | 若为一级评论则为0
大于一级评论则为根评论id | +| parent | num | 回复父评论rpid | 若为一级评论则为0
若为二级评论则为根评论rpid
大于二级评论为上一级评论rpid | +| dialog | num | 回复对方rpid | 若为一级评论则为0
若为二级评论则为该评论rpid
大于二级评论为上一级评论rpid | | count | num | 二级评论条数 | | | rcount | num | 回复评论条数 | | | floor | num | 评论楼层号 | **注：若不支持楼层则无此项** | @@ -58,9 +58,9 @@ | fansgrade | num | 是否具有粉丝标签 | 0：无
1：有 | | attr | num | 某属性位？ | **作用尚不明确** | | ctime | num | 评论发送时间 | 时间戳 | -| rpid_str | str | 评论rpID | 字串格式 | -| root_str | str | 根评论rpID | 字串格式 | -| parent_str | str | 回复父评论rpID | 字串格式 | +| rpid_str | str | 评论rpid | 字串格式 | +| root_str | str | 根评论rpid | 字串格式 | +| parent_str | str | 回复父评论rpid | 字串格式 | | like | num | 评论获赞数 | | | action | num | 当前用户操作状态 | 需要登录(Cookie或APP)
否则恒为0
0：无
1：已点赞
2：已点踩 | | member | obj | 评论发送者信息 | | @@ -75,7 +75,7 @@ | 字段 | 类型 | 内容 | 备注 | | --------------- | ----------------------------- | ---------------------- | ------------------------------------------------------------ | -| mid | str | 发送者UID | | +| mid | str | 发送者mid | | | uname | str | 发送者昵称 | | | sex | str | 发送者性别 | 男 女 保密 | | sign | str | 发送者签名 | | @@ -155,8 +155,8 @@ | 字段 | 类型 | 内容 | 备注 | | ------------- | ---- | ------------ | -------------------- | -| uid | num | 用户UID | | -| medal_id | num | 粉丝标签ID | **详细说明有待补充** | +| uid | num | 用户mid | | +| medal_id | num | 粉丝标签id | **详细说明有待补充** | | medal_name | str | 粉丝标签名 | | | score | num | 0 | **作用尚不明确** | | level | num | 当前标签等级 | | @@ -176,7 +176,7 @@ | 字段 | 类型 | 内容 | 备注 | | -------- | ---- | ------------- | ------------------------------------- | -| id | num | 头像框ID | | +| id | num | 头像框id | | | name | str | 头像框名称 | | | image | str | 头像框图片url | | | jump_url | str | 空 | | @@ -186,7 +186,7 @@ | 字段 | 类型 | 内容 | 备注 | | -------- | ---- | ----------------------- | ------------------------------------- | -| id | num | 评论条目装扮ID | | +| id | num | 评论条目装扮id | | | name | str | 评论条目装扮名称 | | | image | str | 评论条目装扮图片url | | | jump_url | str | 评论条目装扮商城页面url | | @@ -234,8 +234,8 @@ | 字段 | 类型 | 内容 | 备注 | | ---------- | ---- | ------------ | -------------------------------------------------------- | -| id | num | 表情ID | | -| package_id | num | 表情包ID | | +| id | num | 表情id | | +| package_id | num | 表情包id | | | state | num | 0 | | | type | num | 表情类型 | 1：免费
2：会员专属
3：购买所得
4：颜文字 | | attr | num | 0 | **作用尚不明确** | diff --git a/creativecenter/railgun.md b/creativecenter/railgun.md index e3b8ba3..2e1d70b 100644 --- a/creativecenter/railgun.md +++ b/creativecenter/railgun.md @@ -31,7 +31,7 @@ | 字段 | 类型 | 内容 | 备注 | | ------ | ---- | ----------- | ---------------- | -| mid | num | 当前用户UID | | +| mid | num | 当前用户mid | | | state | num | 电磁力等级 | | | reason | str | 空 | **作用尚不明确** | diff --git a/creativecenter/statistics&data.md b/creativecenter/statistics&data.md index d426329..90a0873 100644 --- a/creativecenter/statistics&data.md +++ b/creativecenter/statistics&data.md @@ -503,8 +503,8 @@ curl -G 'http://member.bilibili.com/x/web/data/article/thirty' \ | 字段 | 类型 | 内容 | 备注 | | ----------- | ---- | -------------- | ------------ | -| aid | num | 稿件avID | | -| bvid | str | 稿件bvID | | +| aid | num | 稿件avid | | +| bvid | str | 稿件bvid | | | daytime | num | 统计时间 | 时间戳 | | incr | num | 稿件增长情况数 | | | interactive | num | 0 | 作用尚不明确 | diff --git a/danmaku/action.md b/danmaku/action.md index eb05432..e1d4757 100644 --- a/danmaku/action.md +++ b/danmaku/action.md @@ -31,10 +31,10 @@ | ---------- | ---- | ------------------------ | -------------- | ------------------------------------------------------------ | | access_key | str | APP登录Token | APP方式必要 | | | type | num | 弹幕类选择 | 必要 | 1：视频弹幕 | -| oid | num | 视频CID | 必要 | | +| oid | num | 视频cid | 必要 | | | msg | str | 弹幕内容 | 必要 | 长度小于100字符 | -| bvid | str | 稿件bvID | 必要（可选） | avID与bvID任选一个 | -| aid | num | 稿件avID | 必要（可选） | avID与bvID任选一个 | +| bvid | str | 稿件bvid | 必要（可选） | avid与bvid任选一个 | +| aid | num | 稿件avid | 必要（可选） | avid与bvid任选一个 | | progress | num | 弹幕出现在视频内的时间 | 非必要 | 单位为毫秒
默认为0 | | color | num | 弹幕颜色设置 | 非必要 | 十进制RGB888值
默认为16777215（#FFFFFF）白色 | | fontsize | num | 弹幕字号设置 | 非必要 | 默认为25
极小：12
超小：16
小：18
标准：25
大：36
超大：45
极大：64 | @@ -59,13 +59,13 @@ | 字段 | 类型 | 内容 | 备注 | | -------- | ---- | -------- | ------------ | | action | str | 空 | 作用尚不明确 | -| dmid | num | 弹幕dmID | | -| dmid_str | str | 弹幕dmID | 字串形式 | +| dmid | num | 弹幕dmid | | +| dmid_str | str | 弹幕dmid | 字串形式 | | visible | bool | true | 作用尚不明确 | **示例：** -为视频`av2`/`BV1xx411c7mD`（CID为`62131`）的5000ms位置发送一条弹幕`前来考古`（颜色为#FFFFFF，字号25，普通弹幕，游动弹幕） +为视频`av2`/`BV1xx411c7mD`（cid为`62131`）的5000ms位置发送一条弹幕`前来考古`（颜色为#FFFFFF，字号25，普通弹幕，游动弹幕） ```shell curl 'http://api.bilibili.com/x/v2/dm/post' \ @@ -124,12 +124,12 @@ curl 'http://api.bilibili.com/x/v2/dm/post' \ | ---------- | ---- | ------------------------ | -------------- | ------------------------------------------------------------ | | access_key | str | APP登录Token | APP方式必要 | | | type | num | 互动弹幕类型 | 必要 | 1：UP主头像弹幕
2：关联视频弹幕
5：视频内嵌引导关注按钮 | -| aid | num | 稿件avID | 必要 | | -| cid | num | 视频CID | 必要 | | +| aid | num | 稿件avid | 必要 | | +| cid | num | 视频cid | 必要 | | | progress | num | 弹幕出现在视频内的时间 | 非必要 | 单位为毫秒
默认为0 | | plat | num | 平台标识 | 必要 | 1：web端
2：安卓端
8：视频管理页面 | | data | str | json序列 | 必要 | | -| dmid | num | 修改互动弹幕的弹幕ID | 非必要 | 注：修改弹幕`plat`必须为8 | +| dmid | num | 修改互动弹幕的弹幕id | 非必要 | 注：修改弹幕`plat`必须为8 | | csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | | `data`参数json序列： @@ -145,7 +145,7 @@ curl 'http://api.bilibili.com/x/v2/dm/post' \ | 字段 | 类型 | 内容 | 备注 | | ---- | ---- | -------------- | ---- | | msg | str | 弹幕内容 | | -| bvid | str | 关联视频的bvID | | +| bvid | str | 关联视频的bvid | | 类型为【视频内嵌引导关注按钮】时： @@ -161,7 +161,7 @@ curl 'http://api.bilibili.com/x/v2/dm/post' \ | 字段 | 类型 | 内容 | 备注 | | ------- | ----------------------------- | -------- | ------------------------------------------------------------ | -| code | num | 返回值 | 0：成功
-101：账号未登录
-102：账号被封停
-111：csrf校验失败
-400：请求错误
-404：无此项
-500：服务器错误
36711：该视频禁止发送弹幕
79026：发送失败，请勿填写当前稿件BVID
79024：发送失败，请输入正确的BVID
79036：该指令弹幕超出限制
79037：关注弹幕坐标溢出 | +| code | num | 返回值 | 0：成功
-101：账号未登录
-102：账号被封停
-111：csrf校验失败
-400：请求错误
-404：无此项
-500：服务器错误
36711：该视频禁止发送弹幕
79026：发送失败，请勿填写当前稿件bvid
79024：发送失败，请输入正确的bvid
79036：该指令弹幕超出限制
79037：关注弹幕坐标溢出 | | message | str | 错误信息 | 默认为0 | | ttl | num | 1 | | | data | 正确时：obj
错误时：null | 信息本体 | | @@ -173,10 +173,10 @@ curl 'http://api.bilibili.com/x/v2/dm/post' \ | command | str | 指令？ | UP主头像弹幕：#UP#
关联视频弹幕：#LINK#
视频内嵌引导关注按钮：#ATTENTION# | | content | str | 弹幕内容 | | | extra | str | 弹幕数据 | json序列 | -| id | num | 弹幕dmID | | -| idStr | str | 弹幕dmID | 字串形式 | -| mid | num | 用户UID | | -| oid | num | 视频CID | | +| id | num | 弹幕dmid | | +| idStr | str | 弹幕dmid | 字串形式 | +| mid | num | 用户mid | | +| oid | num | 视频cid | | | progress | num | 弹幕出现在视频内的时间 | | | type | num | 互动弹幕类型 | 1：UP主头像弹幕
2：关联视频弹幕
5：视频内嵌引导关注按钮 | @@ -192,9 +192,9 @@ curl 'http://api.bilibili.com/x/v2/dm/post' \ | 字段 | 类型 | 内容 | 备注 | | ----- | ---- | -------------- | ---- | -| aid | num | 关联视频的avID | | +| aid | num | 关联视频的avid | | | title | str | 关联视频的标题 | | -| bvid | str | 关联视频的bvID | | +| bvid | str | 关联视频的bvid | | 类型为【视频内嵌引导关注按钮】时： @@ -208,7 +208,7 @@ curl 'http://api.bilibili.com/x/v2/dm/post' \ **示例：** -为视频`av201947622`（CID为`230709860`）的5000ms位置发送一条UP主头像弹幕`test` +为视频`av201947622`（cid为`230709860`）的5000ms位置发送一条UP主头像弹幕`test` ```shell curl 'http://api.bilibili.com/x/v2/dm/command/post' \ @@ -245,7 +245,7 @@ curl 'http://api.bilibili.com/x/v2/dm/command/post' \ -为视频`av201947622`（CID为`230709860`）的5000ms位置发送一条发送关联视频弹幕`测试1234`关联视频为`BV1kz4y1X7XP` +为视频`av201947622`（cid为`230709860`）的5000ms位置发送一条发送关联视频弹幕`测试1234`关联视频为`BV1kz4y1X7XP` ```shell curl 'http://api.bilibili.com/x/v2/dm/command/post' \ @@ -284,7 +284,7 @@ curl 'http://api.bilibili.com/x/v2/dm/command/post' \ -为视频`av201947622`（CID为`230709860`）的5000ms位置发送视频内嵌引导关注按钮，X坐标为118，Y坐标为82，持续时间为5000ms +为视频`av201947622`（cid为`230709860`）的5000ms位置发送视频内嵌引导关注按钮，X坐标为118，Y坐标为82，持续时间为5000ms ```shell curl 'http://api.bilibili.com/x/v2/dm/command/post' \ @@ -337,8 +337,8 @@ curl 'http://api.bilibili.com/x/v2/dm/command/post' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ---------- | ---- | ------------------------ | -------------- | ---- | | access_key | str | APP登录Token | APP方式必要 | | -| dmid | num | 弹幕dmID | 必要 | | -| cid | num | 视频CID | 必要 | | +| dmid | num | 弹幕dmid | 必要 | | +| cid | num | 视频cid | 必要 | | | csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | | **json回复：** @@ -353,7 +353,7 @@ curl 'http://api.bilibili.com/x/v2/dm/command/post' \ **示例：** -撤回`CID=168901231`下的弹幕`32310301474947077`的弹幕 +撤回`cid=168901231`下的弹幕`32310301474947077`的弹幕 ```shell curl 'http://api.bilibili.com/x/dm/recall' \ @@ -391,7 +391,7 @@ curl 'http://api.bilibili.com/x/dm/recall' \ | ---------- | ---- | ------------------------ | -------------- | ---- | | access_key | str | APP登录Token | APP方式必要 | | | mode | str | sp | 必要 | | -| cid | num | 视频CID | 必要 | | +| cid | num | 视频cid | 必要 | | | csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | | **json回复：** @@ -406,7 +406,7 @@ curl 'http://api.bilibili.com/x/dm/recall' \ 示例： -购买视频CID为`168901231`的高级弹幕发送权限 +购买视频cid为`168901231`的高级弹幕发送权限 ```shell curl 'http://api.bilibili.com/x/dm/adv/buy' \ @@ -442,7 +442,7 @@ curl 'http://api.bilibili.com/x/dm/adv/buy' \ | ---------- | ---- | ------------ | ----------- | ---- | | access_key | str | APP登录Token | APP方式必要 | | | mode | str | sp | 必要 | | -| cid | num | 视频CID | 必要 | | +| cid | num | 视频cid | 必要 | | **json回复：** @@ -466,7 +466,7 @@ curl 'http://api.bilibili.com/x/dm/adv/buy' \ **示例：** -查询视频CID为`168901231`的视频高级弹幕权限购买状态 +查询视频cid为`168901231`的视频高级弹幕权限购买状态 当前状态为已购买且同意 @@ -508,8 +508,8 @@ curl -G 'http://api.bilibili.com/x/dm/adv/state' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ---------- | ---- | ------------ | ----------- | ------------------- | | access_key | str | APP登录Token | APP方式必要 | | -| oid | num | 视频CID | 必要 | | -| ids | nums | 弹幕dmID列表 | 必要 | 多个ID之间用`,`分隔 | +| oid | num | 视频cid | 必要 | | +| ids | nums | 弹幕dmid列表 | 必要 | 多个id之间用`,`分隔 | **json回复** @@ -526,20 +526,20 @@ curl -G 'http://api.bilibili.com/x/dm/adv/state' \ | 字段 | 类型 | 内容 | 备注 | | -------- | ---- | ---------------- | --------------------------------- | -| {弹幕ID} | obj | 弹幕id对应的信息 | id分别对应请求参数中的`ids`，下同 | +| {弹幕id} | obj | 弹幕id对应的信息 | id分别对应请求参数中的`ids`，下同 | | …… | obj | 弹幕id对应的信息 | | -`{弹幕ID}`对象： +`{弹幕id}`对象： | 字段 | 类型 | 内容 | 备注 | | --------- | ---- | -------- | ------------------------------------------------------------ | | likes | num | 点赞数 | | | user_like | num | 是否点赞 | 0：未点赞
1：已点赞
需要登录(Cookie或APP)
未登录恒为0 | -| id_str | str | 弹幕dmID | | +| id_str | str | 弹幕dmid | | **示例** -查询`CID=236871317`下的弹幕`35600074482384899`、`38880975220375559`、`39052528418553863`点赞数 +查询`cid=236871317`下的弹幕`35600074482384899`、`38880975220375559`、`39052528418553863`点赞数 ```shell curl -G 'http://api.bilibili.com/x/v2/dm/thumbup/stats' \ @@ -591,8 +591,8 @@ curl -G 'http://api.bilibili.com/x/v2/dm/thumbup/stats' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ---------- | ---- | ------------------------ | -------------- | ------------------------ | | access_key | str | APP登录Token | APP方式必要 | | -| dmid | num | 弹幕dmID | 必要 | | -| oid | num | 视频CID | 必要 | | +| dmid | num | 弹幕dmid | 必要 | | +| oid | num | 视频cid | 必要 | | | op | num | 操作 | 必要 | 1：点赞
2：取消点赞 | | platform | str | 平台 | 非必要 | | | csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | | @@ -609,7 +609,7 @@ curl -G 'http://api.bilibili.com/x/v2/dm/thumbup/stats' \ **示例** -为`CID=145928946`下的弹幕`35600074482384899`点赞 +为`cid=145928946`下的弹幕`35600074482384899`点赞 ```shell curl 'http://api.bilibili.com/x/v2/dm/thumbup/add' \ @@ -647,8 +647,8 @@ curl 'http://api.bilibili.com/x/v2/dm/thumbup/add' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ---------- | ---- | ------------------------ | -------------- | ------------------ | | access_key | str | APP登录Token | APP方式必要 | | -| cid | num | 视频CID | 必要 | | -| dmid | num | 弹幕dmID | 必要 | | +| cid | num | 视频cid | 必要 | | +| dmid | num | 弹幕dmid | 必要 | | | reason | num | 举报类型 | 必要 | **类型代码见下表** | | content | str | 其他举报备注 | 非必要 | `reason=11`时有效 | | csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | | @@ -682,7 +682,7 @@ curl 'http://api.bilibili.com/x/v2/dm/thumbup/add' \ **示例** -举报`CID=145928946`下的弹幕`35600074482384899`，理由是`引战` +举报`cid=145928946`下的弹幕`35600074482384899`，理由是`引战` ```shell curl 'http://api.bilibili.com/x/dm/report/add' \ @@ -721,8 +721,8 @@ curl 'http://api.bilibili.com/x/dm/report/add' \ | ---------- | ---- | ------------------------ | -------------- | --------------------------------------------- | | access_key | str | APP登录Token | APP方式必要 | | | type | num | 弹幕类选择 | 必要 | 1：视频弹幕 | -| oid | num | 视频CID | 必要 | | -| dmids | nums | 弹幕dmID | 必要 | 多个ID之间用`,`分隔 | +| oid | num | 视频cid | 必要 | | +| dmids | nums | 弹幕dmid | 必要 | 多个id之间用`,`分隔 | | state | num | 操作代码 | 必要 | 1：删除弹幕
2：弹幕保护
3：取消保护 | | csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | | @@ -738,7 +738,7 @@ curl 'http://api.bilibili.com/x/dm/report/add' \ **示例** -删除`CID=145928946`下的弹幕`35600074482384899`、`39067304918515717`、`39082777041174531` +删除`cid=145928946`下的弹幕`35600074482384899`、`39067304918515717`、`39082777041174531` ```shell curl 'http://api.bilibili.com/x/v2/dm/edit/state' \ @@ -779,8 +779,8 @@ curl 'http://api.bilibili.com/x/v2/dm/edit/state' \ | ---------- | ---- | ------------------------ | -------------- | -------------------------------- | | access_key | str | APP登录Token | APP方式必要 | | | type | num | 弹幕类选择 | 必要 | 1：视频弹幕 | -| oid | num | 视频CID | 必要 | | -| dmids | nums | 弹幕dmID | 必要 | 多个ID之间用`,`分隔 | +| oid | num | 视频cid | 必要 | | +| dmids | nums | 弹幕dmid | 必要 | 多个id之间用`,`分隔 | | pool | num | 操作代码 | 必要 | 0：移出字幕池
1：移入字幕池 | | csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | | @@ -796,7 +796,7 @@ curl 'http://api.bilibili.com/x/v2/dm/edit/state' \ **示例** -将`CID=145928946`下的弹幕`35600074482384899`、`39067304918515717`、`39082777041174531`移入字幕池 +将`cid=145928946`下的弹幕`35600074482384899`、`39067304918515717`、`39082777041174531`移入字幕池 ```shell curl 'http://api.bilibili.com/x/v2/dm/edit/state' \ diff --git a/danmaku/danmaku_proto.md b/danmaku/danmaku_proto.md index 9f96835..f2b4625 100644 --- a/danmaku/danmaku_proto.md +++ b/danmaku/danmaku_proto.md @@ -31,8 +31,8 @@ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------------- | ---- | -------- | ------ | ----------- | | type | num | 弹幕类 | 必要 | 1：视频弹幕 | -| oid | num | 视频CID | 必要 | | -| pid | num | 稿件avID | 非必要 | | +| oid | num | 视频cid | 必要 | | +| pid | num | 稿件avid | 非必要 | | | segment_index | num | 分包 | 必要 | 6分钟一包 | **proto回复：** @@ -49,22 +49,22 @@ porto定义见：[bilibili.community.service.dm.v1.DmSegMobileReply](../grpc_api | 名称 | 类型 | 含义 | 备注 | | -------- | ------ | ------------------ | ------------------------------------------------------------ | -| id | int64 | 弹幕dmID | 唯一 可用于操作参数 | +| id | int64 | 弹幕dmid | 唯一 可用于操作参数 | | progress | int32 | 视频内弹幕出现时间 | 毫秒 | | mode | int32 | 弹幕类型 | 1 2 3：普通弹幕
4：底部弹幕
5：顶部弹幕
6：逆向弹幕
7：高级弹幕
8：代码弹幕
9：BAS弹幕（仅限于特殊弹幕专包） | | fontsize | int32 | 弹幕字号 | 18：小
25：标准
36：大 | | color | uint32 | 弹幕颜色 | 十进制RGB888值 | -| midHash | string | 发送者UID的HASH | 用于屏蔽用户和查看用户发送的所有弹幕 也可反查用户ID | +| midHash | string | 发送者mid的HASH | 用于屏蔽用户和查看用户发送的所有弹幕 也可反查用户id | | content | string | 弹幕内容 | utf-8编码 | | ctime | int64 | 弹幕发送时间 | 时间戳 | | weight | int32 | 权重 | 用于智能屏蔽，根据弹幕语义及长度通过AI识别得出
范围：[0-10]
值越大权重越高 | | action | string | 动作？ | 作用尚不明确 | | pool | int32 | 弹幕池 | 0：普通池
1：字幕池
2：特殊池（代码/BAS弹幕） | -| idStr | string | 弹幕dmID | 字串形式
唯一 可用于操作参数 | +| idStr | string | 弹幕dmid | 字串形式
唯一 可用于操作参数 | **示例：** -获取视频`av810872(CID=1176840)`（炮姐）的实时弹幕分包1 +获取视频`av810872(cid=1176840)`（炮姐）的实时弹幕分包1 **注：[proto定义](../grpc_api/bilibili/community/service/dm/v1/dm.proto)需要编译，`bilibili.community.service.dm.v1.dm_pb2`并非通过pypi安装** diff --git a/danmaku/danmaku_view_proto.md b/danmaku/danmaku_view_proto.md index 18db8d0..34d6930 100644 --- a/danmaku/danmaku_view_proto.md +++ b/danmaku/danmaku_view_proto.md @@ -30,8 +30,8 @@ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | -------- | ------ | ----------- | | type | num | 弹幕类 | 必要 | 1：视频弹幕 | -| oid | num | 视频CID | 必要 | | -| pid | num | 稿件avID | 非必要 | | +| oid | num | 视频cid | 必要 | | +| pid | num | 稿件avid | 非必要 | | **proto回复：** @@ -69,16 +69,16 @@ | 名称 | 类型 | 含义 | 备注 | | -------- | ------ | ------------ | ------------------------------------------------------------ | -| id | int64 | 弹幕dmID | | -| oid | int64 | 视频CID | | -| mid | int64 | 发送者UID | | +| id | int64 | 弹幕dmid | | +| oid | int64 | 视频cid | | +| mid | int64 | 发送者mid | | | command | string | 弹幕指令 | `#UP#`：UP主头像弹幕
`#LINK#`：关联视频弹幕
`#ATTENTION#`：视频内嵌引导关注按钮 | | content | string | 弹幕文字 | | | progress | int32 | 弹幕出现时间 | 单位为毫秒 | | ctime | string | 创建时间？ | 此项为空 | | mtime | string | 修改时间？ | 此项为空 | | extra | string | 弹幕负载数据 | json序列字串 | -| idStr | string | 弹幕dmID | 字串形式 | +| idStr | string | 弹幕dmid | 字串形式 | `extra`json序列： @@ -92,10 +92,10 @@ | 字段 | 类型 | 内容 | 备注 | | ----- | ---- | ------------------- | ---- | -| aid | num | 关联视频的avID | | +| aid | num | 关联视频的avid | | | title | str | 关联视频的标题 | | | icon | str | 关联视频按钮图片url | | -| bvid | str | 关联视频的bvID | | +| bvid | str | 关联视频的bvid | | 类型为【视频内嵌引导关注按钮】时： @@ -154,16 +154,16 @@ message DanmakuFlagConfig { // 互动弹幕条目 message CommandDm { - int64 id = 1; //弹幕dmID - int64 oid = 2; //视频CID - int64 mid = 3; //发送者UID + int64 id = 1; //弹幕dmid + int64 oid = 2; //视频cid + int64 mid = 3; //发送者mid string command = 4; //弹幕指令 string content = 5; //弹幕文字 int32 progress = 6; //弹幕出现时间 string ctime = 7; // string mtime = 8; // string extra = 9; //弹幕负载数据 - string idStr = 10; //弹幕dmID（字串形式） + string idStr = 10; //弹幕dmid（字串形式） } //弹幕个人配置 @@ -206,7 +206,7 @@ message DmWebViewReply { **示例：** -获取视频`av797164471(CID=236871317)`的弹幕元数据 +获取视频`av797164471(cid=236871317)`的弹幕元数据 ```shell curl -G 'http://api.bilibili.com/x/v2/dm/web/view' \ @@ -223,7 +223,7 @@ curl -G 'http://api.bilibili.com/x/v2/dm/web/view' \ ### 获取互动弹幕 -获取并显示视频`av797164471(CID=236871317)`的所有互动弹幕 +获取并显示视频`av797164471(cid=236871317)`的所有互动弹幕 ```python import web_dmview_pb2 @@ -241,8 +241,8 @@ print(f'互动弹幕数={len(target.commandDms)}') for i in target.commandDms: print(f'''\ ---弹幕ID={i.id} ----视频CID={i.oid} ----发送者UID={i.mid} +---视频cid={i.oid} +---发送者mid={i.mid} ---弹幕指令={i.command} ---弹幕文字={i.content} ---弹幕出现时间={i.progress} @@ -256,8 +256,8 @@ for i in target.commandDms: ``` 互动弹幕数=1 ---弹幕ID=38469676112019463 ----视频CID=236871317 ----发送者UID=501183549 +---视频cid=236871317 +---发送者mid=501183549 ---弹幕指令=#UP# ---弹幕文字=这个视频没有恰饭！别紧张！ ---弹幕出现时间=157818 @@ -269,7 +269,7 @@ for i in target.commandDms: BAS弹幕（`pool=2` `mode=9`）只能从此包获取，代码弹幕（`pool=2` `mode=8`）也能从此包获取 -获取并显示视频`av2(CID=62131)`的所有BAS（代码）弹幕专包 +获取并显示视频`av2(cid=62131)`的所有BAS（代码）弹幕专包 ```python import web_dmview_pb2 diff --git a/danmaku/danmaku_xml.md b/danmaku/danmaku_xml.md index 29d3d64..ddc7de2 100644 --- a/danmaku/danmaku_xml.md +++ b/danmaku/danmaku_xml.md @@ -22,7 +22,7 @@ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ------- | ------ | ---- | -| oid | num | 视频CID | 必要 | | +| oid | num | 视频cid | 必要 | | **示例：** @@ -46,7 +46,7 @@ curl -G 'http://api.bilibili.com/x/v1/dm/list.so' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ------- | ------ | ---- | -| cid | num | 视频CID | 必要 | | +| cid | num | 视频cid | 必要 | | **示例：** @@ -98,7 +98,7 @@ curl 'http://comment.bilibili.com/144541892.xml' - 标签 i - 标签 chatserver：chat.bilibili.com - - 标签 chatid：视频CID + - 标签 chatid：视频cid - 标签 mission：0 - 标签 maxlimit：实时弹幕池最大容量 - 标签 state：弹幕状态（0：正常 1：弹幕已关闭） @@ -119,8 +119,8 @@ curl 'http://comment.bilibili.com/144541892.xml' | 3 | 弹幕颜色 | int32 | 十进制RGB888值 | | 4 | 弹幕发送时间 | int32 | 时间戳 | | 5 | 弹幕池类型 | int32 | 0：普通池
1：字幕池
2：特殊池（代码/BAS弹幕） | -| 6 | 发送者UID的HASH | string | 用于屏蔽用户和查看用户发送的所有弹幕 也可反查用户ID | -| 7 | 弹幕dmID | int64 | 唯一 可用于操作参数 | +| 6 | 发送者mid的HASH | string | 用于屏蔽用户和查看用户发送的所有弹幕 也可反查用户id | +| 7 | 弹幕dmid | int64 | 唯一 可用于操作参数 | ```xml 从结尾回来看这里，更感动了！ diff --git a/danmaku/history.md b/danmaku/history.md index 4167619..b69fb6a 100644 --- a/danmaku/history.md +++ b/danmaku/history.md @@ -23,7 +23,7 @@ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ------------ | ------ | ------- | | type | num | 1 | 必要 | | -| oid | num | 视频CID | 必要 | | +| oid | num | 视频cid | 必要 | | | month | str | 查询目标年月 | 必要 | YYYY-MM | **json回复：** @@ -120,7 +120,7 @@ curl -G 'http://api.bilibili.com/x/v2/dm/history/index' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | -------- | ------ | ----------- | | type | num | 弹幕类 | 必要 | 1：视频弹幕 | -| oid | num | 视频CID | 必要 | | +| oid | num | 视频cid | 必要 | | | date | str | 弹幕日期 | 必要 | YYYY-MM-DD | **proto回复：** @@ -129,7 +129,7 @@ porto定义见：[bilibili.community.service.dm.v1.DmSegMobileReply](../grpc_api 详细说明见[protobuf弹幕](danmaku_proto.md) -获取视频`av84271171(CID=144541892)`2020-01-21的历史弹幕 +获取视频`av84271171(cid=144541892)`2020-01-21的历史弹幕 **注：proto定义需要编译** @@ -192,12 +192,12 @@ idStr: "27532611677585408" | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | -------- | ------ | ---------- | | type | num | 1 | 必要 | | -| oid | num | 视频CID | 必要 | | +| oid | num | 视频cid | 必要 | | | date | str | 弹幕日期 | 必要 | YYYY-MM-DD | **示例：** -获取视频`av84271171(CID=144541892)`2020-01-21的历史弹幕 +获取视频`av84271171(cid=144541892)`2020-01-21的历史弹幕 ```shell curl -G 'http://api.bilibili.com/x/v2/dm/history' \ diff --git a/danmaku/snapshot.md b/danmaku/snapshot.md index 5b71047..c1d88b0 100644 --- a/danmaku/snapshot.md +++ b/danmaku/snapshot.md @@ -16,7 +16,7 @@ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | -------- | ------------------ | ------ | ---- | -| aid | num或str | 稿件avID或稿件bvID | 必要 | | +| aid | num或str | 稿件avid或稿件bvid | 必要 | | **json回复：** @@ -42,14 +42,14 @@ 获取视频`av43337021`/`BV1rb411m7gE`的弹幕快照，总计20条 -avID方式： +avid方式： ```shell curl -G 'http://api.bilibili.com/x/v2/dm/ajax' \ --data-urlencode 'aid=43337021' ``` -bvID方式： +bvid方式： ```shell curl -G 'http://api.bilibili.com/x/v2/dm/ajax' \ diff --git a/dynamic/content.md b/dynamic/content.md index 2e3f9d3..aaef5e8 100644 --- a/dynamic/content.md +++ b/dynamic/content.md @@ -54,7 +54,7 @@ | face | str | 直播者头像 | | | link | str | 直播链接 | | | title | str | 直播标题 | | -| uid | num | 直播者ID | | +| uid | num | 直播者id | | | uname | str | 直播者昵称 | | **示例：** diff --git a/dynamic/get_dynamic_detail.md b/dynamic/get_dynamic_detail.md index f3bde7d..61bbedf 100644 --- a/dynamic/get_dynamic_detail.md +++ b/dynamic/get_dynamic_detail.md @@ -8,7 +8,7 @@ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------------ | ---- | ---------- | ------ | -------- | -| dynamic_id | id | 动态ID | 必要 | | +| dynamic_id | id | 动态id | 必要 | | **json回复：** @@ -73,7 +73,7 @@ **示例：** -获取`哔哩哔哩弹幕网`的动态ID为`507420325550127049`动态 +获取`哔哩哔哩弹幕网`的动态id为`507420325550127049`动态 ```shell curl -G 'http://api.vc.bilibili.com/dynamic_svr/v1/dynamic_svr/get_dynamic_detail' \ diff --git a/dynamic/tag_dynamics.md b/dynamic/tag_dynamics.md index e54a0d7..78ef681 100644 --- a/dynamic/tag_dynamics.md +++ b/dynamic/tag_dynamics.md @@ -14,7 +14,7 @@ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------------ | ---- | ---------- | ------ | -------- | | topic_name | str | 话题名称 | 必要（可选） | topic_id与topic_name任选一个 | -| topic_id | num | 话题ID | 必要（可选） | topic_id与topic_name任选一个 | +| topic_id | num | 话题id | 必要（可选） | topic_id与topic_name任选一个 | | sortby | num | 排序方式 | 非必要 | 一般情况下带上参数2，在部分话题中使用可以排除热门部分| | offset | num | 偏移值 | 非必要| 可用于偏移显示的动态列表（为`0`时获取不包含置顶及热门的最新动态） | @@ -55,7 +55,7 @@ **示例：** -获取话题`哔哩哔哩漫画`（话题ID`7539944`）的当前动态列表（包含置顶&热门） +获取话题`哔哩哔哩漫画`（话题id`7539944`）的当前动态列表（包含置顶&热门） topic_name方式： ```shell @@ -3354,7 +3354,7 @@ curl -G 'http://api.vc.bilibili.com/topic_svr/v1/topic_svr/fetch_dynamics' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------------ | ---- | ---------- | ------ | -------- | | topic_name | str | 话题名称 | 必要（可选） | topic_id与topic_name任选一个 | -| topic_id | num | 话题ID | 必要（可选） | topic_id与topic_name任选一个 | +| topic_id | num | 话题id | 必要（可选） | topic_id与topic_name任选一个 | | offset_dynamic_id | num | 偏移值 | 必要| 可用于偏移显示的动态列表（为`0`时获取最新动态） | **json回复：** @@ -3392,7 +3392,7 @@ curl -G 'http://api.vc.bilibili.com/topic_svr/v1/topic_svr/fetch_dynamics' \ **示例：** -获取话题`哔哩哔哩漫画`（话题ID`7539944`）的当前动态列表 +获取话题`哔哩哔哩漫画`（话题id`7539944`）的当前动态列表 topic_name方式： ```shell diff --git a/electric/Bcoin.md b/electric/Bcoin.md index dc6434b..f1d6ed6 100644 --- a/electric/Bcoin.md +++ b/electric/Bcoin.md @@ -27,9 +27,9 @@ | -------- | ---- | ------------------------ | ------ | ------------------------------------------------- | | bp_num | num | 贝壳数量 | 必要 | 必须在20-99990之间 | | is_bp_remains_prior | bool | 是否优先扣除B币余额 | 必要 | [true,false]，B币充电请选择true | -| up_mid | num | 充电对象用户UID | 必要 | | +| up_mid | num | 充电对象用户mid | 必要 | | | otype | str | 充电来源 | 必要 | up：空间充电
archive：视频充电 | -| oid | num | 充电来源代码 | 必要 | 空间充电：充电对象用户UID
视频充电：稿件avID | +| oid | num | 充电来源代码 | 必要 | 空间充电：充电对象用户mid
视频充电：稿件avid | | csrf | str | CSRF Token（位于cookie） | 必要 | | **json回复：** @@ -47,8 +47,8 @@ | 字段 | 类型 | 内容 | 备注 | | -------- | ---- | ----------- | ------------------------------------------------ | -| mid | num | 本用户UID | | -| up_mid | num | 目标用户UID | | +| mid | num | 本用户mid | | +| up_mid | num | 目标用户mid | | | order_no | str | 留言token | 用于添加充电留言 | | bp_num | num | 充电贝壳数 | | | exp | num | 获得经验数 | | @@ -57,7 +57,7 @@ **示例：** -以空间的方式向用户`UID=293793435`充了2贝壳，得到2经验，留言token为`BPRG5CEC3VUPOOANA540` +以空间的方式向用户`mid=293793435`充了2贝壳，得到2经验，留言token为`BPRG5CEC3VUPOOANA540` 此时`data`.`status`=`4` @@ -188,9 +188,9 @@ curl 'https://api.bilibili.com/x/ugcpay/web/v2/trade/elec/pay/quick' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | -------- | ---- | ------------------------ | ------ | ------------------------------------------------- | | elec_num | num | 充电电池数量 | 必要 | 必须在20-99990之间 | -| up_mid | num | 充电对象用户UID | 必要 | | +| up_mid | num | 充电对象用户mid | 必要 | | | otype | str | 充电来源 | 必要 | up：空间充电
archive：视频充电 | -| oid | num | 充电来源代码 | 必要 | 空间充电：充电对象用户UID
视频充电：稿件avID | +| oid | num | 充电来源代码 | 必要 | 空间充电：充电对象用户mid
视频充电：稿件avid | | csrf | str | CSRF Token（位于cookie） | 必要 | | **json回复：** @@ -208,8 +208,8 @@ curl 'https://api.bilibili.com/x/ugcpay/web/v2/trade/elec/pay/quick' \ | 字段 | 类型 | 内容 | 备注 | | -------- | ---- | ----------- | ------------------------------------------------ | -| mid | num | 本用户UID | | -| up_mid | num | 目标用户UID | | +| mid | num | 本用户mid | | +| up_mid | num | 目标用户mid | | | order_no | str | 留言token | 用于添加充电留言 | | elec_num | num | 充电电池数 | | | exp | num | 获得经验数 | | @@ -218,7 +218,7 @@ curl 'https://api.bilibili.com/x/ugcpay/web/v2/trade/elec/pay/quick' \ **示例：** -以空间的方式向用户`UID=293793435`充了20电池，得到2经验，留言token为`BPRG5CEC3VUPOOANA540` +以空间的方式向用户`mid=293793435`充了20电池，得到2经验，留言token为`BPRG5CEC3VUPOOANA540` 此时`data`.`status`=`4` diff --git a/electric/WeChat&Alipay.md b/electric/WeChat&Alipay.md index 33bdf07..7369a54 100644 --- a/electric/WeChat&Alipay.md +++ b/electric/WeChat&Alipay.md @@ -33,10 +33,10 @@ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------------------- | ---- | ------------------------ | ------ | ------------------------------------------------------------ | | elec_num | num | 充电电池数量 | 必要 | 必须在20-99990之间
1-19区间视为充值B币 | -| up_mid | num | 充电对象用户UID | 必要 | | +| up_mid | num | 充电对象用户mid | 必要 | | | is_bp_remains_prior | bool | 是否优先扣除B币 | 必要 | true：是
false：否
在B币不足时剩余的部分利用支付平台支付 | | otype | str | 充电来源 | 必要 | up：空间充电
archive：视频充电 | -| oid | num | 充电来源代码 | 必要 | 空间充电：充电对象用户UID
视频充电：稿件avID | +| oid | num | 充电来源代码 | 必要 | 空间充电：充电对象用户mid
视频充电：稿件avid | | csrf | str | CSRF Token（位于cookie） | 必要 | | **json回复：** @@ -122,7 +122,7 @@ curl 'http://api.bilibili.com/x/ugcpay/trade/elec/pay/qr_code/create' \ | -------- | ---- | ----------- | ------------------------------------------------------------ | | qr_token | str | 扫码秘钥 | | | order_no | str | 留言token | 未成功则无此项
用于添加充电留言 | -| mid | num | 当前用户UID | | +| mid | num | 当前用户mid | | | status | num | 状态值 | 若秘钥错误则无此项
1：已支付
2：未扫描
3：未确认 | **示例：** diff --git a/electric/charge_list.md b/electric/charge_list.md index 61833c7..80360e3 100644 --- a/electric/charge_list.md +++ b/electric/charge_list.md @@ -15,7 +15,7 @@ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ----------- | ------ | ---- | -| mid | num | 目标用户UID | 必要 | | +| mid | num | 目标用户mid | 必要 | | **json回复：** @@ -23,7 +23,7 @@ | 字段 | 类型 | 内容 | 备注 | | ---- | ---- | -------- | ----------------------------- | -| code | num | 返回值 | 0：成功
500011：UID错误 | +| code | num | 返回值 | 0：成功
500011：mid错误 | | msg | str | 错误信息 | 正确时无此项 | | data | obj | 数据本体 | | @@ -50,8 +50,8 @@ | 字段 | 类型 | 内容 | 备注 | | ----------- | ---- | ---------------- | ---------------- | -| mid | num | 充电对象UID | | -| pay_mid | num | 充电用户UID | | +| mid | num | 充电对象mid | | +| pay_mid | num | 充电用户mid | | | rank | num | 充电用户排名 | 取决于充电的多少 | | uname | str | 充电用户昵称 | | | avatar | str | 充电用户头像url | | @@ -70,7 +70,7 @@ **示例：** -查询用户`UID=53456`的充电公示列表 +查询用户`mid=53456`的充电公示列表 ```shell curl -G 'http://elec.bilibili.com/api/query.rank.do' \ @@ -152,9 +152,9 @@ curl -G 'http://elec.bilibili.com/api/query.rank.do' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ------------ | ------------ | ------------------ | -| mid | num | 目标用户UID | 必要 | | -| aid | num | 目标稿件avID | 必要（可选） | avID与bvID任选一个 | -| bvid | str | 目标稿件bvID | 必要（可选） | avID与bvID任选一个 | +| mid | num | 目标用户mid | 必要 | | +| aid | num | 目标稿件avid | 必要（可选） | avid与bvid任选一个 | +| bvid | str | 目标稿件bvid | 必要（可选） | avid与bvid任选一个 | **json回复：** @@ -200,8 +200,8 @@ curl -G 'http://elec.bilibili.com/api/query.rank.do' \ | 字段 | 类型 | 内容 | 备注 | | ----------- | ---- | ---------------- | ---------------- | -| mid | num | 充电对象UID | | -| pay_mid | num | 充电用户UID | | +| mid | num | 充电对象mid | | +| pay_mid | num | 充电用户mid | | | rank | num | 充电用户排名 | 取决于充电的多少 | | uname | str | 充电用户昵称 | | | avatar | str | 充电用户头像url | | @@ -220,9 +220,9 @@ curl -G 'http://elec.bilibili.com/api/query.rank.do' \ **示例：** -获取视频`av967773538`/` BV1up4y1y77i `，用户`UID=53456`的视频充电鸣谢名单 +获取视频`av967773538`/` BV1up4y1y77i `，用户`mid=53456`的视频充电鸣谢名单 -avID方式： +avid方式： ```shell curl -G 'http://api.bilibili.com/x/web-interface/elec/show' \ @@ -230,7 +230,7 @@ curl -G 'http://api.bilibili.com/x/web-interface/elec/show' \ --data-urlencode 'aid=967773538' ``` -bvID方式： +bvid方式： ```shell curl -G 'http://api.bilibili.com/x/web-interface/elec/show' \ diff --git a/emoji/action.md b/emoji/action.md index 72000a0..954ed86 100644 --- a/emoji/action.md +++ b/emoji/action.md @@ -19,7 +19,7 @@ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ---------- | ---- | ------------------------ | ------ | -------------------------------- | -| package_id | num | 表情包ID | 必要 | | +| package_id | num | 表情包id | 必要 | | | business | str | 使用场景 | 必要 | reply：评论区
dynamic：动态 | | csrf | str | CSRF Token（位于cookie） | 必要 | | @@ -35,7 +35,7 @@ **示例：** -添加ID为`25`的表情包，使用场景为评论区 +添加id为`25`的表情包，使用场景为评论区 ```shell curl 'http://api.bilibili.com/x/emote/package/add' \ @@ -70,7 +70,7 @@ curl 'http://api.bilibili.com/x/emote/package/add' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ---------- | ---- | ------------------------ | ------ | -------------------------------- | -| package_id | num | 表情包ID | 必要 | | +| package_id | num | 表情包id | 必要 | | | business | str | 使用场景 | 必要 | reply：评论区
dynamic：动态 | | csrf | str | CSRF Token（位于cookie） | 必要 | | @@ -86,7 +86,7 @@ curl 'http://api.bilibili.com/x/emote/package/add' \ **示例：** -移除ID为`25`的表情包，使用场景为评论区 +移除id为`25`的表情包，使用场景为评论区 ```shell curl 'http://api.bilibili.com/x/emote/package/remove' \ diff --git a/emoji/list.md b/emoji/list.md index 6c97677..8b11c12 100644 --- a/emoji/list.md +++ b/emoji/list.md @@ -234,7 +234,7 @@ curl -G 'http://api.bilibili.com/x/emote/user/panel/web' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | -------- | ---- | -------- | ------ | -------------------------------- | | business | str | 使用场景 | 必要 | reply：评论区
dynamic：动态 | -| ids | nums | 表情包ID | 必要 | | +| ids | nums | 表情包id | 必要 | | **json回复：** @@ -263,7 +263,7 @@ curl -G 'http://api.bilibili.com/x/emote/user/panel/web' \ **示例：** -获取表情包ID为`93`的表情包明细 +获取表情包id为`93`的表情包明细 ```shell curl -G 'http://api.bilibili.com/x/emote/package' \ @@ -586,7 +586,7 @@ curl -G 'http://api.bilibili.com/x/emote/setting/panel' \ | 字段 | 类型 | 内容 | 备注 | | ----- | ----- | ----------------- | -------------------------------------------------------- | -| id | num | 表情包ID | | +| id | num | 表情包id | | | text | str | 表情包名称 | | | url | str | 表情包标志图片url | | | mtime | num | 创建时间 | 时间戳 | @@ -607,7 +607,7 @@ curl -G 'http://api.bilibili.com/x/emote/setting/panel' \ | 字段 | 类型 | 内容 | 备注 | | -------- | ---- | --------------- | ---------------- | | size | num | 表情尺寸信息 | 1：小
2：大 | -| item_id | num | 购买物品ID | | +| item_id | num | 购买物品id | | | item_url | num | 购买物品页面url | 无则无此项 | `表情包对象`中的`emote`数组： @@ -622,8 +622,8 @@ curl -G 'http://api.bilibili.com/x/emote/setting/panel' \ | 字段 | 类型 | 内容 | 备注 | | ---------- | ---- | ----------- | -------------------------------------------------------- | -| id | num | 表情ID | | -| package_id | num | 表情包ID | | +| id | num | 表情id | | +| package_id | num | 表情包id | | | text | str | 表情转义符 | 颜文字时为该字串 | | url | str | 表情图片url | 颜文字时为该字串 | | mtime | num | 创建时间 | 时间戳 | diff --git a/fav/info.md b/fav/info.md index 9f20c5d..fc2cb8b 100644 --- a/fav/info.md +++ b/fav/info.md @@ -36,9 +36,9 @@ | 字段 | 类型 | 内容 | 备注 | | ----------- | ---- | -------------------- | -------------------------------------------------- | -| id | num | 收藏夹mlid（完整id） | 收藏夹原始id+创建者UID尾号2位 | +| id | num | 收藏夹mlid（完整id） | 收藏夹原始id+创建者mid尾号2位 | | fid | num | 收藏夹原始id | | -| mid | num | 创建者UID | | +| mid | num | 创建者mid | | | attr | num | 属性位（？） | | | title | str | 收藏夹标题 | | | cover | str | 收藏夹封面图片url | | @@ -59,7 +59,7 @@ | 字段 | 类型 | 内容 | 备注 | | ---------- | ---- | ---------------- | ----------------------------------------------- | -| mid | num | 创建者UID | | +| mid | num | 创建者mid | | | name | str | 创建者昵称 | | | face | str | 创建者头像url | | | followed | bool | 是否已关注创建者 | | @@ -77,7 +77,7 @@ **示例：** -查询收藏夹`ID=1052622027`的元数据 +查询收藏夹`id=1052622027`的元数据 ```shell curl -G 'http://api.bilibili.com/x/v3/fav/folder/info' \ @@ -145,7 +145,7 @@ curl -G 'http://api.bilibili.com/x/v3/fav/folder/info' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ------------ | ------ | ---------------------------------------- | -| up_mid | num | 目标用户UID | 必要 | | +| up_mid | num | 目标用户mid | 必要 | | | type | num | 目标内容属性 | 非必要 | 默认为全部
0：全部
2：视频稿件 | | rid | num | 目标内容id | 非必要 | 视频稿件：视频稿件avid | @@ -179,9 +179,9 @@ curl -G 'http://api.bilibili.com/x/v3/fav/folder/info' \ | 字段 | 类型 | 内容 | 备注 | | ----------- | ---- | ------------------------ | ------------------------------------------ | -| id | num | 收藏夹mlid（完整id） | 收藏夹原始id+创建者UID尾号2位 | +| id | num | 收藏夹mlid（完整id） | 收藏夹原始id+创建者mid尾号2位 | | fid | num | 收藏夹原始id | | -| mid | num | 创建者UID | | +| mid | num | 创建者mid | | | attr | num | 属性位（？） | | | title | str | 收藏夹标题 | | | fav_state | num | 目标id是否存在于该收藏夹 | 存在于该收藏夹：1
不存在于该收藏夹：0 | @@ -189,7 +189,7 @@ curl -G 'http://api.bilibili.com/x/v3/fav/folder/info' \ **示例：** -查询用户`UID=509372`的所有创建收藏夹列表 +查询用户`mid=509372`的所有创建收藏夹列表 ```shell curl -G 'http://api.bilibili.com/x/v3/fav/folder/created/list-all' \ @@ -291,7 +291,7 @@ curl -G 'http://api.bilibili.com/x/v3/fav/folder/created/list-all' \ | 字段 | 类型 | 内容 | 备注 | | ---- | ---- | ----------- | ---- | -| mid | num | UP主UID | | +| mid | num | UP主mid | | | name | str | UP主昵称 | | | face | str | UP主头像url | | diff --git a/fav/list.md b/fav/list.md index af79da1..1eb00c7 100644 --- a/fav/list.md +++ b/fav/list.md @@ -49,9 +49,9 @@ | 字段 | 类型 | 内容 | 备注 | | ----------- | ---- | -------------------- | -------------------------------------------------- | -| id | num | 收藏夹mlid（完整id） | 收藏夹原始id+创建者UID尾号2位 | +| id | num | 收藏夹mlid（完整id） | 收藏夹原始id+创建者mid尾号2位 | | fid | num | 收藏夹原始id | | -| mid | num | 创建者UID | | +| mid | num | 创建者mid | | | attr | num | 属性 | 0：正常
1：失效 | | title | str | 收藏夹标题 | | | cover | str | 收藏夹封面图片url | | @@ -72,7 +72,7 @@ | 字段 | 类型 | 内容 | 备注 | | ---------- | ---- | ---------------- | ----------------------------------------------- | -| mid | num | 创建者UID | | +| mid | num | 创建者mid | | | name | str | 创建者昵称 | | | face | str | 创建者头像url | | | followed | bool | 是否已关注创建者 | | @@ -122,7 +122,7 @@ | 字段 | 类型 | 内容 | 备注 | | ---- | ---- | ----------- | ---- | -| mid | num | UP主UID | | +| mid | num | UP主mid | | | name | str | UP主昵称 | | | face | str | UP主头像url | | @@ -136,7 +136,7 @@ **示例：** -查询收藏夹`ID=1052622027`，每页5个视频，第`1`页的内容明细 +查询收藏夹`id=1052622027`，每页5个视频，第`1`页的内容明细 ```shell curl -G 'http://api.bilibili.com/x/v3/fav/resource/list' \ @@ -377,7 +377,7 @@ curl -G 'http://api.bilibili.com/x/v3/fav/resource/list' \ **示例：** -查询收藏夹`ID=1052622027`的全部内容id +查询收藏夹`id=1052622027`的全部内容id ```shell curl -G 'http://api.bilibili.com/x/v3/fav/resource/ids' \ diff --git a/garb/color.md b/garb/color.md index 71a02c9..f391ddb 100644 --- a/garb/color.md +++ b/garb/color.md @@ -46,7 +46,7 @@ | 字段 | 类型 | 内容 | 备注 | | ---------- | ---- | ------------ | ------------------------------- | -| id | num | 颜色ID | | +| id | num | 颜色id | | | name | str | 颜色名称 | | | is_free | bool | 是否免费 | false：收费
true：免费 | | price | num | 价格 | 单位为硬币 | @@ -184,7 +184,7 @@ curl -G 'http://club.bilibili.com/api/query.skin.list.do' \ | 字段 | 类型 | 内容 | 备注 | | ---------- | ---- | ------------ | ------------------------------- | -| id | num | 颜色ID | | +| id | num | 颜色id | | | name | str | 颜色名称 | | | is_free | bool | 是否免费 | false：收费
true：免费 | | price | num | 价格 | 单位为硬币 | diff --git a/garb/skin.md b/garb/skin.md index 14fb52a..8e4213e 100644 --- a/garb/skin.md +++ b/garb/skin.md @@ -47,7 +47,7 @@ | 字段 | 类型 | 内容 | 备注 | | ----------- | ---- | --------------- | ------ | -| id | num | 装扮ID | | +| id | num | 装扮id | | | name | str | 装扮名称 | | | preview | str | 装扮封面url | | | ver | num | 装扮版本 | 时间戳 | @@ -80,7 +80,7 @@ | 字段 | 类型 | 内容 | 备注 | | ---------- | ---- | ------------ | ------------------------------- | -| id | num | 颜色ID | | +| id | num | 颜色id | | | name | str | 颜色名称 | | | is_free | bool | 是否免费 | false：收费
true：免费 | | price | num | 价格 | 单位为硬币 | @@ -95,7 +95,7 @@ | 字段 | 类型 | 内容 | 备注 | | ----------- | ---- | --------------- | ------ | -| id | num | 装扮ID | | +| id | num | 装扮id | | | name | str | 装扮名称 | | | ver | num | 装扮版本 | 时间戳 | | loading_url | str | 加载动画图标url | | diff --git a/history&toview/history.md b/history&toview/history.md index 0651852..c1c7b21 100644 --- a/history&toview/history.md +++ b/history&toview/history.md @@ -23,8 +23,8 @@ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | -------- | ---- | ---------------------- | ------ | ------------------------------------------------------------ | -| max | num | 历史记录截止目标ID | 非必要 | 默认为0
稿件：稿件avID
番剧（影视）：剧集ssID
直播：直播间ID
文集：文集rlID
文章：文章cvID | -| business | num | 历史记录截止目标ID类型 | 非必要 | 默认为空
archive：稿件
pgc：番剧（影视）
live：直播
article-list：文集
article：文章 | +| max | num | 历史记录截止目标id | 非必要 | 默认为0
稿件：稿件avid
番剧（影视）：剧集ssid
直播：直播间id
文集：文集rlid
文章：文章cvid | +| business | num | 历史记录截止目标id类型 | 非必要 | 默认为空
archive：稿件
pgc：番剧（影视）
live：直播
article-list：文集
article：文章 | | view_at | num | 历史记录截止时间 | 非必要 | 时间戳
默认为0
0为当前时间 | | ps | num | 每页项数 | 非必要 | 默认为20 | @@ -51,9 +51,9 @@ | 字段 | 类型 | 内容 | 备注 | | -------- | ---- | ------------------ | ------------------ | -| max | num | 最后一项目标ID | **详细内容见参数** | +| max | num | 最后一项目标id | **详细内容见参数** | | view_at | num | 最后一项时间节点 | 时间戳 | -| business | str | 最后一项目标ID类型 | **详细内容见参数** | +| business | str | 最后一项目标id类型 | **详细内容见参数** | | ps | num | 每页项数 | | `data`中的`tab`数组： @@ -92,7 +92,7 @@ | videos | num | 视频分P数目 | 仅用于稿件视频 | | author_name | str | UP主昵称 | | | author_face | str | UP主头像url | | -| author_mid | num | UP主UID | | +| author_mid | num | UP主mid | | | view_at | num | 查看时间 | 时间戳 | | progress | num | 视频观看进度 | 单位为秒
用于稿件视频或剧集 | | badge | str | 条目备注标识 | 用于稿件视频或剧集 | @@ -103,7 +103,7 @@ | new_desc | str | 最新一话/最新一P标识 | 用于稿件视频或剧集 | | is_finish | num | 是否已完结 | 仅用于剧集
0：未完结
1：已完结 | | is_fav | num | 是否收藏 | 0：未收藏
1：已收藏 | -| kid | num | 条目目标ID | **详细内容见参数** | +| kid | num | 条目目标id | **详细内容见参数** | | tag_name | str | 子分区名 | 用于稿件视频和直播 | | live_status | num | 直播状态 | 仅用于直播
0：未开播
1：已开播 | @@ -119,11 +119,11 @@ | 字段 | 类型 | 内容 | 备注 | | -------- | ---- | ------------------- | ------------------------------------------------------------ | -| oid | num | 目标ID | 稿件视频&剧集（当`business=archive`或`business=pgc`时）：稿件avID
直播（当`business=live`时）：直播间ID
文章（当`business=article`时）：文章cvID
文集（当`business=article-list`时）：文集rlID | -| epid | num | 剧集epID | 仅用于剧集 | -| bvid | str | 稿件bvID | 仅用于稿件视频 | +| oid | num | 目标id | 稿件视频&剧集（当`business=archive`或`business=pgc`时）：稿件avid
直播（当`business=live`时）：直播间id
文章（当`business=article`时）：文章cvid
文集（当`business=article-list`时）：文集rlid | +| epid | num | 剧集epid | 仅用于剧集 | +| bvid | str | 稿件bvid | 仅用于稿件视频 | | page | num | 观看到的视频分P数 | 仅用于稿件视频 | -| cid | num | 观看到的对象ID | 稿件视频&剧集（当`business=archive`或`business=pgc`时）：视频CID
文集（当`business=article-list`时）：文章cvID | +| cid | num | 观看到的对象id | 稿件视频&剧集（当`business=archive`或`business=pgc`时）：视频cid
文集（当`business=article-list`时）：文章cvid | | part | str | 观看到的视频分P标题 | 仅用于稿件视频 | | business | str | 条目类型 | **详细内容见参数** | | dt | num | 查看平台代码 | 1 3 5 7：手机端
2：web端
4 6：pad端
33：TV端
0：其他 | @@ -387,9 +387,9 @@ curl -G 'http://api.bilibili.com/x/web-interface/history/cursor' \ | 字段 | 类型 | 内容 | 备注 | | ------------------------------- | ------- | ------------------------------ | ------------------------------------------------------------ | -| aid | num | 稿件avID | | +| aid | num | 稿件avid | | | videos | num | 视频分P总数 | 默认为1 | -| tid | num | 分区tID | | +| tid | num | 分区tid | | | tname | str | 子分区名称 | | | copyright | num | 是否转载 | 1：原创
2：转载 | | pic | str | 视频封面图片url | | @@ -404,7 +404,7 @@ curl -G 'http://api.bilibili.com/x/web-interface/history/cursor' \ | owner | obj | 视频UP主信息 | 略，见[获取视频详细信息（web端）](/video/info.md#获取视频详细信息（web端）)中的`owner`对象 | | stat | obj | 视频状态数 | 略，见[获取视频详细信息（web端）](/video/info.md#获取视频详细信息（web端）)中的`stat`对象 | | dynamic | str | 视频同步发布的的动态的文字内容 | 无为空 | -| cid | num | 视频1P CID | | +| cid | num | 视频1P cid | | | dimension | obj | 视频1P分辨率 | 略，见[获取视频详细信息（web端）](/video/info.md#获取视频详细信息（web端）)中的`dimension`对象 | | bangumi | obj | 番剧/影视信息 | 非番剧/影视无此项 | | cheese | obj | 课程信息 | 非课程无此项 | @@ -416,17 +416,17 @@ curl -G 'http://api.bilibili.com/x/web-interface/history/cursor' \ | count | num | 分P数 | 非投稿视频无此项 | | progress | num | 观看进度 | 单位为秒 | | view_at | num | 观看时间 | 时间戳 | -| kid | num | 稿件avID | | +| kid | num | 稿件avid | | | business | str | 视频类型标识 | archive：用户投稿视频
pgc：番剧/影视
cheese：课程 | | redirect_link | str | 重定向url | | -| bvid | str | 稿件bvID | | +| bvid | str | 稿件bvid | | `data`数组中的对象`bangumi`对象： | 字段 | 类型 | 内容 | 备注 | | -------------- | ---- | --------------- | ------------ | | cover | str | 番剧封面图片url | | -| ep_id | num | 番剧epID | | +| ep_id | num | 番剧epid | | | episode_status | num | ？？？ | | | follow | num | 0 | 作用尚不明确 | | long_title | str | 单集标题 | | @@ -438,9 +438,9 @@ curl -G 'http://api.bilibili.com/x/web-interface/history/cursor' \ | 字段 | 类型 | 内容 | 备注 | | --------------- | ---- | ------------ | ---------------------- | | is_finish | num | 是否完结 | 0：连载中
1：完结 | -| newest_ep_id | num | 最细一话epID | | +| newest_ep_id | num | 最细一话epid | | | newest_ep_index | str | 最细一话集数 | | -| season_id | num | 番剧ssID | | +| season_id | num | 番剧ssid | | | season_status | num | ？？？ | | | season_type | num | ？？？ | | | title | str | 番剧标题 | | @@ -453,7 +453,7 @@ curl -G 'http://api.bilibili.com/x/web-interface/history/cursor' \ | cover | str | 课程封面图片url | | | long_title | str | 完整标题 | | | number | str | 本集数 | | -| season_id | num | 课程ssID | | +| season_id | num | 课程ssid | | | update_info | str | 总集数 | | **示例：** @@ -671,7 +671,7 @@ curl -G 'http://api.bilibili.com/x/v2/history' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ------------------------ | ------ | ------------------------------------------------------------ | -| kid | str | 删除的目标记录 | 必要 | 视频：archive\_{稿件avID}
直播：live_{直播间ID}
专栏：article\_{专栏cvID}
剧集：pgc\_{剧集ssID}
文集：article-list\_{文集rlID} | +| kid | str | 删除的目标记录 | 必要 | 视频：archive\_{稿件avid}
直播：live_{直播间id}
专栏：article\_{专栏cvid}
剧集：pgc\_{剧集ssid}
文集：article-list\_{文集rlid} | | csrf | str | CSRF Token（位于cookie） | 必要 | | **json回复：** diff --git a/history&toview/toview.md b/history&toview/toview.md index ea2f432..c23cf8a 100644 --- a/history&toview/toview.md +++ b/history&toview/toview.md @@ -24,8 +24,8 @@ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ------------------------ | ------------ | ------------------ | -| aid | num | 稿件avID | 必要（可选） | avID与bvID任选一个 | -| bvid | str | 稿件bvID | 必要（可选） | avID与bvID任选一个 | +| aid | num | 稿件avid | 必要（可选） | avid与bvid任选一个 | +| bvid | str | 稿件bvid | 必要（可选） | avid与bvid任选一个 | | csrf | str | CSRF Token（位于cookie） | 必要 | | **json回复：** @@ -42,7 +42,7 @@ 添加视频`av41687433`/`BV1ht41147kj`到稍后再看列表 -avID方式： +avid方式： ```shell curl 'http://api.bilibili.com/x/v2/history/toview/add' \ @@ -51,7 +51,7 @@ curl 'http://api.bilibili.com/x/v2/history/toview/add' \ -b 'SESSDATA=xxx' ``` -bvID方式： +bvid方式： ```shell curl 'http://api.bilibili.com/x/v2/history/toview/add' \ @@ -91,8 +91,8 @@ curl 'http://api.bilibili.com/x/v2/history/toview/add' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ------------------------ | ------ | ---- | -| cid | num | 目标频道ID | 必要 | | -| mid | num | 目标频道所属的用户UID | 必要 | | +| cid | num | 目标频道id | 必要 | | +| mid | num | 目标频道所属的用户mid | 必要 | | | csrf | str | CSRF Token（位于cookie） | 必要 | | **json回复：** @@ -106,7 +106,7 @@ curl 'http://api.bilibili.com/x/v2/history/toview/add' \ **示例：** -添加用户`UID=282994`下的频道`4693`中所有视频到稍后再看 +添加用户`mid=282994`下的频道`4693`中所有视频到稍后再看 ```shell curl 'http://space.bilibili.com/ajax/channel/addAllToView' \ @@ -168,9 +168,9 @@ curl 'http://space.bilibili.com/ajax/channel/addAllToView' \ | 字段 | 类型 | 内容 | 备注 | | ------------------------------- | ------- | ------------------------------ | ------------------------------------------------------------ | -| aid | num | 稿件avID | | +| aid | num | 稿件avid | | | videos | num | 稿件分P总数 | 默认为1 | -| tid | num | 分区tID | | +| tid | num | 分区tid | | | tname | str | 子分区名称 | | | copyright | num | 是否转载 | 1：原创
2：转载 | | pic | str | 稿件封面图片url | | @@ -187,10 +187,10 @@ curl 'http://space.bilibili.com/ajax/channel/addAllToView' \ | dynamic | str | 视频同步发布的的动态的文字内容 | 无为空 | | dimension | obj | 稿件1P分辨率 | 略，见[获取视频详细信息（web端）](/video/info.md#获取视频详细信息（web端）)中的`dimension`对象 | | count | num | 稿件分P数 | 非投稿视频无此项 | -| cid | num | 视频CID | | +| cid | num | 视频cid | | | progress | num | 观看进度时间 | 单位为秒 | | add_at | num | 添加时间 | 时间戳 | -| bvid | str | 稿件bvID | | +| bvid | str | 稿件bvid | | **示例：** @@ -363,7 +363,7 @@ curl 'http://api.bilibili.com/x/v2/history/toview' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ------------------------ | ------ | ------------------------------------------------------------ | | viewed | bool | 是否删除所有已观看的视频 | 非必要 | true：删除已观看视频
false：不删除已观看视频
默认为false | -| aid | num | 删除的目标记录的avID | 非必要 | | +| aid | num | 删除的目标记录的avid | 非必要 | | | csrf | str | CSRF Token（位于cookie） | 必要 | | **json回复：** diff --git a/live/info.md b/live/info.md index 1d8a58a..6470005 100644 --- a/live/info.md +++ b/live/info.md @@ -16,7 +16,7 @@ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ----------- | ------ | ---- | -| mid | num | 目标用户UID | 必要 | | +| mid | num | 目标用户mid | 必要 | | **json回复：** @@ -40,13 +40,13 @@ | title | str | 直播间标题 | | | cover | str | 直播间封面url | | | online | num | 直播间人气 | 值为上次直播时刷新 | -| roomid | num | 直播间ID（短号） | | +| roomid | num | 直播间id（短号） | | | broadcast_type | num | 0 | | | online_hidden | num | 0 | | **示例：** -查询用户`UID=322892`的直播间信息 +查询用户`mid=322892`的直播间信息 ```shell curl -G 'http://api.live.bilibili.com/room/v1/Room/getRoomInfoOld' \ @@ -105,9 +105,9 @@ curl -G 'http://api.live.bilibili.com/room/v1/Room/getRoomInfoOld' \ | 字段 | 类型 | 内容 | 备注 | | -------------- | ---- | ------------- | ------------------------ | -| room_id | num | 直播间真实ID | | -| short_id | num | 直播间ID（短号） | | -| uid | num | 主播用户UID | | +| room_id | num | 直播间真实id | | +| short_id | num | 直播间id（短号） | | +| uid | num | 主播用户mid | | | need_p2p | num | 是否p2p | | | is_hidden | bool | 是否隐藏 | | | is_locked | bool | 是否锁定 | | @@ -124,7 +124,7 @@ curl -G 'http://api.live.bilibili.com/room/v1/Room/getRoomInfoOld' \ **示例：** -查询直播间`ID=76`的直播间信息 +查询直播间`id=76`的直播间信息 ```shell curl -G 'http://api.live.bilibili.com/room/v1/Room/room_init' \ @@ -172,7 +172,7 @@ curl -G 'http://api.live.bilibili.com/room/v1/Room/room_init' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ----------- | ------ | ---- | -| uid | num | 目标用户UID | 必要 | | +| uid | num | 目标用户mid | 必要 | | **json回复：** @@ -192,7 +192,7 @@ curl -G 'http://api.live.bilibili.com/room/v1/Room/room_init' \ | info | obj | 主播信息 | | | exp | obj | 经验等级 | | | follower_num | num | 主播粉丝数 | | -| room_id | num | 直播间ID（短号） | | +| room_id | num | 直播间id（短号） | | | medal_name | str | 粉丝勋章名 | | | glory_count | int | 主播荣誉数 | | | pendant | str | 直播间头像框url | | @@ -203,7 +203,7 @@ curl -G 'http://api.live.bilibili.com/room/v1/Room/room_init' \ | 字段 | 类型 | 内容 | 备注 | | --------------- | ---- | ----------- | ------------------------------ | -| uid | num | 主播UID | | +| uid | num | 主播mid | | | uname | str | 主播用户名 | | | face | str | 主播头像url | | | official_verify | obj | 认证信息 | | @@ -254,7 +254,7 @@ curl -G 'http://api.live.bilibili.com/room/v1/Room/room_init' \ **示例：** -查询直播间`UID=76`的主播信息 +查询直播间`mid=76`的主播信息 ```shell curl -G 'http://api.live.bilibili.com/live_user/v1/Master/info' \ diff --git a/live/live_area.md b/live/live_area.md index 27e6dc6..4b4cee1 100644 --- a/live/live_area.md +++ b/live/live_area.md @@ -35,7 +35,7 @@ | 字段 | 类型 | 内容 | 备注 | | ---- | ---- | ---------- | ---- | -| id | num | 父分区ID | | +| id | num | 父分区id | | | name | name | 父分区名 | | | list | list | 子分区列表 | | @@ -51,9 +51,9 @@ | 字段 | 类型 | 内容 | 备注 | | ----------- | ---- | ----------------- | ---------------- | -| id | str | 子分区ID | | -| parent_id | str | 父分区ID | | -| old_area_id | str | 旧分区ID | | +| id | str | 子分区id | | +| parent_id | str | 父分区id | | +| old_area_id | str | 旧分区id | | | name | str | 子分区名 | | | act_id | str | 0 | **作用尚不明确** | | pk_status | str | ？？？ | **作用尚不明确** | @@ -65,7 +65,7 @@ **示例：** -如想在`网游`父分区下的`英雄联盟`分区开播，则查到子分区ID为`86` +如想在`网游`父分区下的`英雄联盟`分区开播，则查到子分区id为`86` ```shell curl 'http://api.live.bilibili.com/room/v1/Area/getList' diff --git a/live/live_stream.md b/live/live_stream.md index 5bb8535..584f61b 100644 --- a/live/live_stream.md +++ b/live/live_stream.md @@ -84,7 +84,7 @@ **示例：** -查询直播间`CID=14073662`的直播间信息 +查询直播间`cid=14073662`的直播间信息 ```shell curl -G 'http://api.live.bilibili.com/room/v1/Room/playUrl' \ diff --git a/live/manage.md b/live/manage.md index 117d5ad..2742d0a 100644 --- a/live/manage.md +++ b/live/manage.md @@ -20,7 +20,7 @@ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------- | ---- | ------------------------ | ------ | -------------------- | -| room_id | num | 直播间ID | 必要 | 必须为自己的直播间ID | +| room_id | num | 直播间id | 必要 | 必须为自己的直播间id | | title | str | 直播间标题 | 必要 | 最大20字符 | | csrf | str | CSRF Token（位于cookie） | 必要 | | @@ -77,8 +77,8 @@ curl 'http://api.live.bilibili.com/room/v1/Room/update' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | -------- | ---- | ------------------------ | ------ | ----------------------------------- | -| room_id | num | 直播间ID | 必要 | 必须为自己的直播间ID | -| area_v2 | num | 直播分区ID（子分区ID） | 必要 | 详见[直播分区](live_area.md) | +| room_id | num | 直播间id | 必要 | 必须为自己的直播间id | +| area_v2 | num | 直播分区id（子分区id） | 必要 | 详见[直播分区](live_area.md) | | platform | str | 直播平台 | 必要 | web端：
bililink：android_link | | csrf | str | CSRF Token（位于cookie） | 必要 | | @@ -144,7 +144,7 @@ curl 'http://api.live.bilibili.com/room/v1/Room/update' \ **示例：** -以`27`作为分区ID开播直播间`10352053` +以`27`作为分区id开播直播间`10352053` 其中`"data"."rtmp"."addr"`为推流地址 @@ -216,7 +216,7 @@ curl 'http://api.live.bilibili.com/room/v1/Room/startLive' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------- | ---- | ------------------------ | ------ | -------------------- | -| room_id | num | 直播间ID | 必要 | 必须为自己的直播间ID | +| room_id | num | 直播间id | 必要 | 必须为自己的直播间id | | csrf | str | CSRF Token（位于cookie） | 必要 | | **json回复：** diff --git a/live/message_stream.md b/live/message_stream.md index 5649af6..5cff855 100644 --- a/live/message_stream.md +++ b/live/message_stream.md @@ -40,8 +40,8 @@ json格式 | 字段 | 类型 | 内容 | 备注 | | --------- | ---- | ------------ | -------------- | -| uid | num | 用户UID | 不可为0 | -| roomid | num | 加入房间的ID | | +| uid | num | 用户mid | 不可为0 | +| roomid | num | 加入房间的id | | | protover | num | 协议版本 | 现在是2 | | platform | str | 平台标识 | 可为"web" | | clientver | str | 客户端版本 | 现在是"1.10.3" | diff --git a/login/login_action/QR.md b/login/login_action/QR.md index a9caca8..eca46bb 100644 --- a/login/login_action/QR.md +++ b/login/login_action/QR.md @@ -207,9 +207,9 @@ X-Cache-Webcdn: BYPASS from ks-sxhz-dx-w-01 https://passport.biligame.com/crossDomain? -DedeUserID=(登录UID)& +DedeUserID=(登录mid)& -DedeUserID__ckMd5=(登录UID MD5值)& +DedeUserID__ckMd5=(登录mid MD5值)& Expires=(过期时间 秒)& @@ -236,7 +236,7 @@ gourl=(跳转网址 默认为主页) | 参数名 | 类型 | 内容 | 必要性 | 备注 | | -------- | ---- | ---------- | ----------- | ------------------------ | | appkey | str | APP密钥 | APP方式必要 | 仅可用`4409e2ce8ffd12b8` | -| local_id | str | TV端ID | TV端必要 | 可为0 | +| local_id | str | TV端id | TV端必要 | 可为0 | | ts | num | 当前时间戳 | APP方式必要 | | | sign | str | APP签名 | APP方式必要 | | @@ -303,7 +303,7 @@ curl 'http://passport.bilibili.com/x/passport-tv-login/qrcode/auth_code' \ | --------- | ---- | ---------- | ----------- | ------------------------ | | appkey | str | APP密钥 | APP方式必要 | 仅可用`4409e2ce8ffd12b8` | | auth_code | str | 扫码秘钥 | 必要 | | -| local_id | str | TV端ID | TV端必要 | 可为0 | +| local_id | str | TV端id | TV端必要 | 可为0 | | ts | num | 当前时间戳 | APP方式必要 | | | sign | str | APP签名 | APP方式必要 | | @@ -322,7 +322,7 @@ curl 'http://passport.bilibili.com/x/passport-tv-login/qrcode/auth_code' \ | 字段 | 类型 | 内容 | 备注 | | ------------- | ---- | ------------ | -------------------- | -| mid | num | 登录用户UID | | +| mid | num | 登录用户mid | | | access_token | str | APP登录Token | | | refresh_token | str | APP刷新Token | | | expires_in | num | 有效时间 | 单位为秒 一般为30天 | diff --git a/login/login_action/SMS.md b/login/login_action/SMS.md index 23b24e2..1198a66 100644 --- a/login/login_action/SMS.md +++ b/login/login_action/SMS.md @@ -131,7 +131,7 @@ curl 'http://passport.bilibili.com/web/generic/country/list' **示例：** -例如手机号为`13888888888`，国际ID为`1（中国大陆）`，登录秘钥为`aabbccdd`，极验challenge为`2333`，极验结果为`666666`，进行发送短信验证码操作 +例如手机号为`13888888888`，国际id为`1（中国大陆）`，登录秘钥为`aabbccdd`，极验challenge为`2333`，极验结果为`666666`，进行发送短信验证码操作 ```shell curl 'http://passport.bilibili.com/web/sms/general/v2/send' \ diff --git a/login/login_action/password.md b/login/login_action/password.md index bc2a75d..e6a77d2 100644 --- a/login/login_action/password.md +++ b/login/login_action/password.md @@ -183,7 +183,7 @@ YgpjxAQ22pKa9socHIKPCZX0a/NS6Ng9Zzy+rp16b0LJGT6RHw2ERs3+ijCpG96PKTY1Baavwf0xgotm **需验证手机号或邮箱时** | 字段 | 类型 | 内容 | 备注 | | -------- | ---- | ------------------------ | ---------------- | -| mid | num | 用户UID | | +| mid | num | 用户mid | | | tel | str | 绑定的手机号 | 星号隐藏部分信息 | | email | str | 绑定的邮箱 | 星号隐藏部分信息 | | sorce | num | 0 | **作用尚不明确** | @@ -252,9 +252,9 @@ X-Cache-Webcdn: BYPASS from jd-sxhz-dx-w-01 https://passport.biligame.com/crossDomain? -DedeUserID=(登录UID)& +DedeUserID=(登录mid)& -DedeUserID__ckMd5=(登录UID MD5值)& +DedeUserID__ckMd5=(登录mid MD5值)& Expires=(过期时间 秒)& diff --git a/login/login_action/readme.md b/login/login_action/readme.md index 9c55d43..97f465b 100644 --- a/login/login_action/readme.md +++ b/login/login_action/readme.md @@ -12,7 +12,7 @@ 人机验证流程： -1. 请求验证码参数，得到登录密钥`key`与极验ID`gt`和极验KEY`challenge` +1. 请求验证码参数，得到登录密钥`key`与极验id`gt`和极验KEY`challenge` 2. 进行滑动or点击验证 3. 返回验证结果`validate`与`seccode`，进行短信或密码登录 @@ -44,7 +44,7 @@ | 字段 | 类型 | 内容 | 备注 | | -------- | ----- | ------ | -------- | | success | num | 1 | **作用尚不明确** | -| gt | str | 极验ID | 一般为固定值 | +| gt | str | 极验id | 一般为固定值 | | challenge | str | 极验KEY | 由B站后端产生用于人机验证 | | key | str | 登录秘钥 | 与人机验证无关，与登录接口有关，但与极验KEY对应 | diff --git a/login/login_info.md b/login/login_info.md index 5c50200..2f764e1 100644 --- a/login/login_info.md +++ b/login/login_info.md @@ -37,7 +37,7 @@ | email_verified | num | 是否验证邮箱地址 | 0：未验证
1：已验证 | | face | str | 用户头像url | | | level_info | obj | 等级信息 | | -| mid | num | 用户UID | | +| mid | num | 用户mid | | | mobile_verified | num | 是否验证手机号 | 0：未验证
1：已验证 | | money | num | 拥有硬币数 | | | moral | num | 当前节操值 | 上限为70 | @@ -106,7 +106,7 @@ | 字段 | 类型 | 内容 | 备注 | | --------------- | ---- | ------------- | ------------ | -| mid | num | 登录用户UID | | +| mid | num | 登录用户mid | | | bcoin_balance | num | 拥有B币数 | | | coupon_balance | num | 每月奖励B币数 | | | coupon_due_time | num | 0 | 作用尚不明确 | @@ -313,7 +313,7 @@ curl 'http://account.bilibili.com/home/userInfo' \ | 字段 | 类型 | 内容 | 备注 | | -------------- | ---- | ---------------- | ----------------------------- | -| mid | num | 用户UID | | +| mid | num | 用户mid | | | name | str | 用户昵称 | | | sign | str | 用户签名 | | | coins | num | 拥有硬币数 | | diff --git a/login/login_notice.md b/login/login_notice.md index 838fbe0..541ae2f 100644 --- a/login/login_notice.md +++ b/login/login_notice.md @@ -16,7 +16,7 @@ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ---------- | ------ | ------------------------------------------------------------ | -| mid | num | 用户UID | 必要 | | +| mid | num | 用户mid | 必要 | | | buvid | str | 设备虚拟id | 非必要 | web端为操作登录接口时Cookie中的`buvid3`
若登录设备无`buvid`则留空 | **json回复：** @@ -34,7 +34,7 @@ | 字段 | 类型 | 内容 | 备注 | | ----------- | ---- | ----------- | -------------------------- | -| mid | num | 登录用户UID | | +| mid | num | 登录用户mid | | | device_name | str | 登录设备 | 依靠操作登录接口时的UA决定 | | login_type | str | 登录方式 | 根据登录接口决定 | | login_time | str | 登录时间 | YYYY-MM-DD hh:mm:ss | @@ -43,7 +43,7 @@ **示例：** -查询用户`293793435`设备ID为`fuck_chenrui`的登录记录 +查询用户`293793435`设备id为`fuck_chenrui`的登录记录 ```shell curl -G 'http://api.bilibili.com/x/safecenter/login_notice' \ diff --git a/login/member_center.md b/login/member_center.md index a8b646f..705e585 100644 --- a/login/member_center.md +++ b/login/member_center.md @@ -41,7 +41,7 @@ | 字段 | 类型 | 内容 | 备注 | | --------- | ---- | -------------- | --------------------------------------- | -| mid | num | 我的UID | | +| mid | num | 我的mid | | | uname | str | 我的昵称 | | | userid | str | 我的用户名 | | | sign | str | 我的签名 | | @@ -213,7 +213,7 @@ curl 'http://www.bilibili.com/plus/account/exp.php' \ | 字段 | 类型 | 内容 | 备注 | | ------------ | ---- | ---------------- | ------------------------------------------------------------ | -| mid | num | 我的UID | | +| mid | num | 我的mid | | | vip_type | num | 大会员类型 | 0：无
1：月度
2：年度 | | vip_status | num | 大会员状态 | 1：正常
2：由于IP地址更换过于频繁,服务被冻结
3：你的大会员账号风险过高，大会员功能已被锁定 | | vip_due_date | num | 大会员到期时间 | 时间戳 毫秒 | diff --git a/message/private_msg.md b/message/private_msg.md index fa4f883..00b3029 100644 --- a/message/private_msg.md +++ b/message/private_msg.md @@ -71,8 +71,8 @@ curl 'http://api.vc.bilibili.com/session_svr/v1/session_svr/single_unread' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------------------ | ------------------------------------ | ------------------------ | ------ | -------------------------------------- | -| msg[sender_uid] | num | 发送者UID | 必要 | | -| msg[receiver_id] | num | 接收者UID | 必要 | | +| msg[sender_uid] | num | 发送者mid | 必要 | | +| msg[receiver_id] | num | 接收者mid | 必要 | | | msg[receiver_type] | num | 1 | 必要 | 固定为1 | | msg[msg_type] | num | 消息类型 | 必要 | 1:发送文字
2:发送图片
5:撤回消息 | | msg[msg_status] | num | 0 | 非必要 | | @@ -148,7 +148,7 @@ const deviceid = "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (functi **示例：** -给目标用户`UID=1`发一条文字私信： +给目标用户`mid=1`发一条文字私信： > up主你好， > @@ -182,7 +182,7 @@ curl 'http://api.vc.bilibili.com/web_im/v1/web_im/send_msg' \ -给目标用户`UID=1`发一条图片私信： +给目标用户`mid=1`发一条图片私信： > diff --git a/newbie_exam/info.md b/newbie_exam/info.md index 57dcffe..fb02079 100644 --- a/newbie_exam/info.md +++ b/newbie_exam/info.md @@ -28,7 +28,7 @@ | 字段 | 类型 | 内容 | 备注 | | ------------ | ---- | ---------------- | ------------------------------------------------------------ | | hid | num | 答题会话id | | -| mid | num | 答题用户UID | | +| mid | num | 答题用户mid | | | score | num | 当前得分 | | | status | num | 答题状态 | 0：未答题
2：答题中
3：已通过 | | number | num | 当前题号 | | @@ -322,7 +322,7 @@ curl -G 'http://api.bilibili.com/x/answer/v4/pro/type' \ | 字段 | 类型 | 内容 | 备注 | | ----------------- | ----- | ------------------ | ------ | | hid | num | 答题会话id | | -| mid | num | 答题用户UID | | +| mid | num | 答题用户mid | | | member | num | | | | score | num | 得分 | | | level | num | | | diff --git a/note/action.md b/note/action.md index 4e6ba7c..4d2b536 100644 --- a/note/action.md +++ b/note/action.md @@ -17,8 +17,8 @@ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------- | ---- | ------------------------ | ------ | ------------------------------------------------------------ | -| aid | num | 目标稿件avID | 必要 | | -| note_id | num | 笔记ID | 非必要 | 创建时无需此项 | +| aid | num | 目标稿件avid | 必要 | | +| note_id | num | 笔记id | 非必要 | 创建时无需此项 | | title | str | 笔记标题 | 必要 | | | summary | str | 笔记预览文本 | 必要 | | | content | str | 笔记正文json序列 | 必要 | 格式见[附表](readme.md#附表-笔记正文序列格式) | @@ -42,7 +42,7 @@ | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | ------------ | ---- | -| note_id | num | 笔记ID | | +| note_id | num | 笔记id | | **示例：** @@ -90,8 +90,8 @@ curl 'http://api.bilibili.com/x/note/add' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------- | ---- | ------------------------ | ------ | ---- | -| aid | num | 目标稿件avID | 必要 | | -| note_id | num | 笔记ID | 非必要 | | +| aid | num | 目标稿件avid | 必要 | | +| note_id | num | 笔记id | 非必要 | | | csrf | str | CSRF Token（位于cookie） | 必要 | | **json回复：** diff --git a/note/info.md b/note/info.md index d62d913..9fb1505 100644 --- a/note/info.md +++ b/note/info.md @@ -17,8 +17,8 @@ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------- | ---- | ------------ | ----------- | -------- | -| aid | num | 稿件avID | 必要（可选） | avID与bvID任选一个 | -| bvid | str | 稿件bvID | 必要（可选） | avID与bvID任选一个 | +| aid | num | 稿件avid | 必要（可选） | avid与bvid任选一个 | +| bvid | str | 稿件bvid | 必要（可选） | avid与bvid任选一个 | | csrf | str | CSRF Token（位于cookie） | 非必要 | | **json回复：** @@ -42,13 +42,13 @@ | 项 | 类型 | 内容 | 备注 | | ---- | ---- | ----------- | ---------------- | -| 0 | num | 笔记ID | | +| 0 | num | 笔记id | | **示例：** -查询视频`av970322090`/`BV1op4y167Uo`的笔记ID +查询视频`av970322090`/`BV1op4y167Uo`的笔记id -avID方式： +avid方式： ```shell curl 'http://api.bilibili.com/x/note/list/archive' \ @@ -56,7 +56,7 @@ curl 'http://api.bilibili.com/x/note/list/archive' \ -b 'SESSDATA=xxx' ``` -bvID方式： +bvid方式： ```shell curl 'http://api.bilibili.com/x/note/list/archive' \ @@ -94,9 +94,9 @@ curl 'http://api.bilibili.com/x/note/list/archive' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------- | ---- | ---------- | ----------- | -------- | -| aid | num | 稿件avID | 必要（可选）| avID与bvID任选一个，不与笔记所属稿件avID相同不影响返回 | -| bvid | str | 稿件bvID | 必要（可选）| avID与bvID任选一个，不与笔记所属稿件bvID相同不影响返回 | -| note_id | num | 笔记ID | 必要 | | +| aid | num | 稿件avid | 必要（可选）| avid与bvid任选一个，不与笔记所属稿件avid相同不影响返回 | +| bvid | str | 稿件bvid | 必要（可选）| avid与bvid任选一个，不与笔记所属稿件bvid相同不影响返回 | +| note_id | num | 笔记id | 必要 | | **json回复：** @@ -119,7 +119,7 @@ curl 'http://api.bilibili.com/x/note/list/archive' \ | tags | array | 笔记跳转标签列表 | | | cid_count | num | 视频分P数 | | | audit_status | num | 0 | 作用暂不明确 | -| aid | num | 稿件avID | | +| aid | num | 稿件avid | | `data`中的`tags`数组： @@ -143,7 +143,7 @@ curl 'http://api.bilibili.com/x/note/list/archive' \ 查询视频`av583785685`/`BV1kz4y1X7XP`中笔记`7165769906913287`的内容 -avID方式： +avid方式： ```shell curl 'http://api.bilibili.com/x/note/info' \ @@ -152,7 +152,7 @@ curl 'http://api.bilibili.com/x/note/info' \ -b 'SESSDATA=xxx' ``` -bvID方式： +bvid方式： ```shell curl 'http://api.bilibili.com/x/note/info' \ diff --git a/note/list.md b/note/list.md index bf198f6..3240e77 100644 --- a/note/list.md +++ b/note/list.md @@ -52,15 +52,15 @@ | summary | str | 笔记预览文本 | | | mtime | str | 提交时间 | | | arc | obj | 视频信息 | | -| note_id | num | 笔记ID | | +| note_id | num | 笔记id | | | audit_status | num | 0 | 作用尚不明确 | `list`中的`arc`中的对象： | 字段 | 类型 | 内容 | 备注 | | ------ | ---- | ------------ | ---------------------- | -| aid | num | 稿件avID | | -| bvid | str | 稿件bvID | | +| aid | num | 稿件avid | | +| bvid | str | 稿件bvid | | | pic | str | 稿件封面图片url | | | desc | str | 视频简介 | | | status | num | 0 | | diff --git a/other/API_auth.md b/other/API_auth.md index ac4779b..faa2858 100644 --- a/other/API_auth.md +++ b/other/API_auth.md @@ -15,8 +15,8 @@ Token有效期为1月，更改密码或过期失效 | cookie项 | 含义 | 备注 | | ----------------- | ----------------- | ------------------------------------------ | -| DedeUserID | 当前用户UID | | -| DedeUserID__ckMd5 | 用户UID md5校验值 | | +| DedeUserID | 当前用户mid | | +| DedeUserID__ckMd5 | 用户mid md5校验值 | | | SESSDATA | 登录Token | 用于用户识别与鉴权
作用同`access_key` | | bili_jct | CSRF Token | 用于操作性接口 | diff --git a/other/bvID.md b/other/bvid_desc.md similarity index 82% rename from other/bvID.md rename to other/bvid_desc.md index d1a4788..0837017 100644 --- a/other/bvID.md +++ b/other/bvid_desc.md @@ -1,6 +1,6 @@ -# bvID说明 +# bvid说明 -2020-03-23 B站推出了全新的稿件视频ID“bvID”来接替之前的“avID”，其用法与性质等价于“avID” +2020-03-23 B站推出了全新的稿件视频id“bvid”来接替之前的“avid”，其用法与性质等价于“avid” 详见： @@ -9,23 +9,23 @@ ## 格式： -“bvID”恒为长度为12的字符串，前两个字母为大写“BV”，后10个位base58计算结果 +“bvid”恒为长度为12的字符串，前两个字母为大写“BV”，后10个位base58计算结果 ## 实质： -“bvID"为“avID”的base58编码，可通过算法进行相互转化 +“bvid"为“avid”的base58编码，可通过算法进行相互转化 -## avID发放方式的变化： +## avid发放方式的变化： -从2009-09-09 09:09:09 [av2](https://www.bilibili.com/video/av2)的发布到2020-03-28 19:45:02 [av99999999](https://www.bilibili.com/video/av99999999)的发布B站结束了以投稿时间为顺序的avID发放，改为随机发放avID +从2009-09-09 09:09:09 [av2](https://www.bilibili.com/video/av2)的发布到2020-03-28 19:45:02 [av99999999](https://www.bilibili.com/video/av99999999)的发布B站结束了以投稿时间为顺序的avid发放，改为随机发放avid ~~暗示B站东方要完？泪目~~ ## av->bv算法： -注：本算法及示例程序仅能编码及解码avID<` 29460791296 `，无法验证avID>=` 29460791296 `的正确性 +注：本算法及示例程序仅能编码及解码avid<` 29460791296 `，无法验证avid>=` 29460791296 `的正确性 -1. a=(avID⊕177451812)+8728348608 +1. a=(avid⊕177451812)+8728348608 2. 以i为循环变量循环6次b[i]=(a/58^i)%58 3. 将b[i]中各个数字转换为以下码表中的字符 @@ -112,14 +112,12 @@ const unsigned long long add = 8728348608; //固定加法值 const int s[] = {11, 10, 3, 8, 4, 6}; //位置编码表 //初始化反查码表 -void tr_init() -{ +void tr_init() { for (int i = 0; i < 58; i++) tr[table[i]] = i; } -unsigned long long bv2av(char bv[]) -{ +unsigned long long bv2av(char bv[]) { unsigned long long r = 0; unsigned long long av; for (int i = 0; i < 6; i++) @@ -128,8 +126,7 @@ unsigned long long bv2av(char bv[]) return av; } -char* av2bv(unsigned long long av) -{ +char* av2bv(unsigned long long av) { char* result = (char*)malloc(13); strcpy(result,"BV1 4 1 7 "); av = (av ^ Xor) + add; @@ -138,8 +135,7 @@ char* av2bv(unsigned long long av) return result; } -int main() -{ +int main() { tr_init(); printf("%s\n",av2bv(170001)); printf("%u\n",bv2av("BV17x411w7KC")); diff --git a/ranking&dynamic/dynamic.md b/ranking&dynamic/dynamic.md index 46f0bce..d19df41 100644 --- a/ranking&dynamic/dynamic.md +++ b/ranking&dynamic/dynamic.md @@ -16,7 +16,7 @@ | ------ | ---- | ----------- | ------ | ------- | | pn | num | 页码 | 非必要 | 默认为1 | | ps | num | 每页项数 | 非必要 | 默认为5 | -| rid | num | 目标分区tID | 必要 | | +| rid | num | 目标分区tid | 必要 | | **json回复：** @@ -58,7 +58,7 @@ **示例：** -获取`tID=21`（生活->日常）分区中的2条最新动态视频信息 +获取`tid=21`（生活->日常）分区中的2条最新动态视频信息 ```shell curl -G 'http://api.bilibili.com/x/web-interface/dynamic/region' \ diff --git a/ranking&dynamic/ranking.md b/ranking&dynamic/ranking.md index a0425fc..c55bb4c 100644 --- a/ranking&dynamic/ranking.md +++ b/ranking&dynamic/ranking.md @@ -20,7 +20,7 @@ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ----------- | ------ | ------------------------------------- | | day | num | 页码 | 非必要 | 3：三日榜
7：一周榜
默认为3 | -| rid | num | 目标分区tID | 必要 | | +| rid | num | 目标分区tid | 必要 | | **json回复：** @@ -48,7 +48,7 @@ **示例：** -获取`tID=1`（动画）分区中的三日视频排行榜 +获取`tid=1`（动画）分区中的三日视频排行榜 ```shell curl -G 'http://api.bilibili.com/x/web-interface/ranking/region' \ diff --git a/search/hot.md b/search/hot.md index 1cad433..080660e 100644 --- a/search/hot.md +++ b/search/hot.md @@ -28,13 +28,13 @@ | 字段 | 类型 | 内容 | 备注 | | ---------- | ---- | --------------- | -------------- | -| seid | str | 搜索seID | | -| id | num | 默认搜索ID | | +| seid | str | 搜索seid | | +| id | num | 默认搜索id | | | type | num | 0 | | | show_name | str | 显示文字 | | | name | str | 空 | | | goto_type | num | 跳转类型 | 1：视频 | -| goto_value | str | 搜索目标ID | 视频：稿件avID | +| goto_value | str | 搜索目标id | 视频：稿件avid | | url | str | 搜索目标跳转url | | **示例：** @@ -85,7 +85,7 @@ curl 'http://api.bilibili.com/x/web-interface/search/default' | exp_str | str | ？？？ | | | code | num | 返回值 | 0：成功 | | cost | obj | 详细搜索用时 | 大概是吧？ | -| seid | str | 搜索seID | | +| seid | str | 搜索seid | | | timestamp | num | 榜单统计时间 | 时间戳 | | message | str | 错误信息 | 默认为success | | list | array | 热搜列表 | | diff --git a/search/search_request.md b/search/search_request.md index ed05f39..d65a4c6 100644 --- a/search/search_request.md +++ b/search/search_request.md @@ -600,7 +600,7 @@ curl -G 'http://api.bilibili.com/x/web-interface/search/all/v2' \ | order_sort | num | 用户粉丝数及等级排序顺序 | 非必要 | 仅用于搜索用户
默认为0
由高到低：0
由低到高：1 | | user_type | num | 用户分类筛选 | 非必要 | 仅用于搜索用户
默认为0
全部用户：0
up主：1
普通用户：2
认证用户：3 | | duration | num | 视频时长筛选 | 非必要 | 仅用于搜索视频
默认为0
全部时长：0
10分钟以下：1
10-30分钟：2
30-60分钟：3
60分钟以上：4 | -| tids | num | 视频分区筛选 | 非必要 | 仅用于搜索视频
默认为0
全部分区：0
筛选分区：目标分区tID | +| tids | num | 视频分区筛选 | 非必要 | 仅用于搜索视频
默认为0
全部分区：0
筛选分区：目标分区tid | | category_id | num | 专栏及相簿分区筛选 | 非必要 | 搜索结果为专栏时：
默认为0
全部分区：0
动画：2
游戏：1
影视：28
生活：3
兴趣：29
轻小说：16
科技：17
--------
搜索结果为相簿时：
默认为0
全部分区：0
画友：1
摄影：2 | | page | num | 页码 | 非必要 | 默认为1 | @@ -619,7 +619,7 @@ curl -G 'http://api.bilibili.com/x/web-interface/search/all/v2' \ | 字段 | 类型 | 内容 | 备注 | | --------------- | ---------------------------------------------------------- | ------------ | ------------------------------ | -| seid | num | 搜索seID | | +| seid | num | 搜索seid | | | page | num | 当前页码 | | | pagesize | num | 每页条数 | 固定20 | | numResults | num | 总条数 | 最大值为1000 | diff --git a/search/search_response.md b/search/search_response.md index 51e7d1e..ed064d2 100644 --- a/search/search_response.md +++ b/search/search_response.md @@ -20,14 +20,14 @@ | 字段 | 类型 | 内容 | 备注 | | -------------- | ----- | -------------- | ----------------------------------------- | | type | str | 结果类型 | 固定为video | -| id | num | 结果ID | 为稿件avID | +| id | num | 结果 | 为稿件avid | | author | str | UP主昵称 | | -| mid | num | UP主UID | | -| typeid | str | 视频分区tID | | +| mid | num | UP主mid | | +| typeid | str | 视频分区tid | | | typename | str | 视频子分区名 | | | arcurl | str | 视频重定向url | | -| aid | num | 稿件avID | | -| bvid | str | 稿件bvID | | +| aid | num | 稿件avid | | +| bvid | str | 稿件bvid | | | title | str | 视频标题 | 关键字用xml标签``标注 | | description | str | 视频简介 | | | arcrank | str | 0 | **作用尚不明确** | @@ -107,8 +107,8 @@ | 字段 | 类型 | 内容 | 备注 | | ---------------- | ------------------------------- | ---------------------------- | ------------------------------------------------------------ | | type | str | 结果类型 | media_bangumi：番剧
media_ft：影视 | -| media_id | num | 剧集mdID | | -| season_id | num | 剧集ssID | | +| media_id | num | 剧集mdid | | +| season_id | num | 剧集ssid | | | title | str | 剧集标题 | 关键字用xml标签``标注 | | org_title | str | 剧集原名 | 关键字用xml标签``标注
可为空 | | cover | str | 剧集封面url | | @@ -133,8 +133,8 @@ | angle_title | str | 角标内容 | | | angle_color | num | 角标颜色 | 0：红色
2：橙色 | | display_info | array | 剧集标志信息 | | -| hit_epids | str | 关键字匹配分集标题的分集epID | 多个用`,`分隔 | -| pgc_season_id | num | 剧集ssID | | +| hit_epids | str | 关键字匹配分集标题的分集epid | 多个用`,`分隔 | +| pgc_season_id | num | 剧集ssid | | | season_type | num | 剧集类型 | 1：番剧
2：电影
3：纪录片
4：国创
5：电视剧
7：综艺 | | season_type_name | str | 剧集类型文字 | | | selection_style | str | 分集选择按钮风格 | horizontal：横排式
grid：按钮式 | @@ -192,7 +192,7 @@ | 字段 | 类型 | 内容 | 备注 | | ------------ | ----- | ------------- | ---- | -| id | num | 分集epID | | +| id | num | 分集epid | | | cover | str | 分集封面url | | | title | str | 完整标题 | | | url | str | 分集重定向url | | @@ -337,7 +337,7 @@ | ----------- | ----- | -------------- | ----------------------------------------- | | type | str | 结果类型 | 固定为live_room | | rank_offset | num | 搜索结果排名值 | | -| uid | num | 主播UID | | +| uid | num | 主播mid | | | tas | str | 直播间TAG | 多个用`,`分隔 | | hit_columns | array | 关键字匹配类型 | | | live_time | str | 开播时间 | YYYY-MM-DD HH:MM:SS | @@ -353,7 +353,7 @@ | online | num | 在线人数 | | | rank_index | num | 0 | **作用尚不明确** | | rank_score | num | 结果排序量化值 | | -| roomid | num | 直播间ID | | +| roomid | num | 直播间id | | | attentions | num | 主播粉丝数 | | `直播间条目`中的`hit_columns`数组： @@ -405,7 +405,7 @@ | ----------- | ----- | -------------- | ------------------------------------------------------ | | type | str | 结果类型 | 固定为live_user | | rank_offset | num | 搜索结果排名值 | | -| uid | num | 主播UID | | +| uid | num | 主播mid | | | tas | str | 直播间TAG | 多个用`,`分隔 | | live_time | str | 开播时间 | YYYY-MM-DD HH:MM:SS
如未开播为0000-00-00 00:00:00 | | hit_columns | array | 关键字匹配类型 | | @@ -464,16 +464,16 @@ | pub_time | num | 投稿时间 | 时间戳 | | like | num | 获赞数 | | | title | str | 标题 | | -| mid | num | UP主UID | | +| mid | num | UP主mid | | | image_urls | array | 封面图组 | | | template_id | num | ？？？ | **作用尚不明确** | -| category_id | num | 专栏分区ID | | +| category_id | num | 专栏分区 | | | view | num | 阅读数 | | | reply | num | 评论数 | | | rank_index | num | 0 | **作用尚不明确** | | desc | str | 文章预览 | | | rank_score | num | 结果排序量化值 | | -| id | num | 专栏cvID | | +| id | num | 专栏cvid | | | category_name | str | 子分区名 | | `专栏条目`中的`covers`数组： @@ -532,7 +532,7 @@ | click | num | ？？？ | **作用尚不明确** | | tp_type | num | ？？？ | **作用尚不明确** | | keyword | str | 空 | **作用尚不明确** | -| tp_id | num | 话题tpID | | +| tp_id | num | 话题tp | | | rank_index | num | 0 | **作用尚不明确** | | author | str | UP主昵称 | | | arcurl | str | 话题页面重定向url | | @@ -584,7 +584,7 @@ | 字段 | 类型 | 内容 | 备注 | | --------------- | ----- | -------------- | ----------------------------- | | type | str | 结果类型 | 固定为bili_user | -| mid | num | 用户UID | | +| mid | num | 用户mid | | | uname | str | 用户昵称 | | | usign | str | 用户签名 | | | fans | num | 用户粉丝数 | | @@ -595,7 +595,7 @@ | gender | num | 用户性别 | 1：男
2：女
3：私密 | | is_upuser | num | 是否为UP主 | 0：否
1：是 | | is_live | num | 是否正在直播 | 0：否
1：是 | -| room_id | num | 用户直播间ID | | +| room_id | num | 用户直播间id | | | res | array | 用户投稿内容 | | | official_verify | obj | 用户认证信息 | | | hit_columns | array | 关键字匹配类型 | | @@ -612,8 +612,8 @@ | 字段 | 类型 | 内容 | 备注 | | -------------- | ---- | ----------------- | ---------------- | -| aid | num | 稿件avID | | -| bvid | str | 稿件bvID | | +| aid | num | 稿件avid | | +| bvid | str | 稿件bvid | | | title | str | 视频标题 | | | pubdate | num | 视频投稿时间 | 时间戳 | | arcurl | str | 视频页面重定向url | | @@ -735,11 +735,11 @@ | hit_columns | array | 关键字匹配类型 | | | rank_offset | num | 搜索结果排名值 | | | cover | str | 相簿封面url | | -| mid | num | UP主UID | | +| mid | num | UP主mid | | | uname | str | UP主昵称 | | | rank_index | num | 0 | **作用尚不明确** | | view | num | 观看次数 | | -| id | num | 相簿ID | | +| id | num | 相簿id | | | rank_score | num | 结果排序量化值 | | `相簿条目`中的`hit_columns`数组： diff --git a/user/info.md b/user/info.md index 1a1b56e..7dfc5e0 100644 --- a/user/info.md +++ b/user/info.md @@ -20,7 +20,7 @@ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ----------- | ------ | ---- | -| mid | num | 目标用户UID | 必要 | | +| mid | num | 目标用户mid | 必要 | | **json回复：** @@ -37,7 +37,7 @@ | 字段 | 类型 | 内容 | 备注 | | ----------- | ---- | ---------------- | ------------------------------------------------------------ | -| mid | num | UID | | +| mid | num | mid | | | name | str | 昵称 | | | sex | str | 性别 | 男/女/保密 | | face | str | 头像链接 | | @@ -113,7 +113,7 @@ | 字段 | 类型 | 内容 | 备注 | | ----------- | ---- | --------------- | ----------------------------------------------- | -| id | num | 系统提示类型ID | 8：争议账号
20：纪念账号
22：合约诉讼 | +| id | num | 系统提示类型id | 8：争议账号
20：纪念账号
22：合约诉讼 | | content | str | 提示文案 | | | url | str | 提示信息页面url | | | notice_type | num | ？ | 作用尚不明确
此字段非必须 | @@ -131,13 +131,13 @@ | title | str | 直播间标题 | | | cover | str | 直播间封面url | | | online | num | 直播间人气 | 值为上次直播时刷新 | -| roomid | num | 直播间ID（短号） | | +| roomid | num | 直播间id（短号） | | | roundStatus | num | 轮播状态 | 0：未轮播
1：轮播 | | broadcast_type | num | 0 | | **示例：** -查询用户`UID=2`的详细信息 +查询用户`mid=2`的详细信息 ```shell curl -G 'http://api.bilibili.com/x/space/acc/info' \ @@ -279,7 +279,7 @@ http://i2.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | -------------------- | ------ | ----------------------- | -| mid | num | 目标用户UID | 必要 | | +| mid | num | 目标用户mid | 必要 | | | photo | bool | 是否请求用户主页头图 | 非必要 | true：是
false：否 | **json回复：** @@ -303,7 +303,7 @@ http://i2.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png | 字段 | 类型 | 内容 | 备注 | | --------------- | ----- | -------------- | ------------------------------------------------------------ | -| mid | num | 用户UID | | +| mid | num | 用户mid | | | approve | bool | false | **作用尚不明确** | | name | str | 用户昵称 | | | sex | str | 用户性别 | 男 女 保密 | @@ -507,7 +507,7 @@ curl -G 'api.bilibili.com/x/web-interface/card' \ | 字段 | 类型 | 内容 | 备注 | | --------------- | ---- | ------------ | ------------------------ | -| mid | num | UID | | +| mid | num | mid | | | name | str | 昵称 | | | sex | str | 性别 | 男 女 保密 | | face | str | 头像图片url | | diff --git a/user/relation.md b/user/relation.md index 6074f29..b5a3dd1 100644 --- a/user/relation.md +++ b/user/relation.md @@ -15,7 +15,7 @@ - [查询关注分组列表](#查询关注分组列表) - [查询关注分组明细](#查询关注分组明细) - [查询目标用户所在的分组](#查询目标用户所在的分组 ) - - [查询所有特别关注的UID](#查询所有特别关注的UID) + - [查询所有特别关注的mid](#查询所有特别关注的mid) - [创建分组](#创建分组) - [重命名分组](#重命名分组) - [删除分组](#删除分组) @@ -42,7 +42,7 @@ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ---------- | ---- | ------------ | ----------- | ---------------------------------- | | access_key | str | APP登录Token | APP方式必要 | | -| vmid | num | 目标用户UID | 必要 | | +| vmid | num | 目标用户mid | 必要 | | | ps | num | 每页项数 | 非必要 | 默认为50 | | pn | num | 页码 | 非必要 | 默认为1
其他用户仅可查看前5页 | @@ -77,7 +77,7 @@ | 字段 | 类型 | 内容 | 备注 | | --------------- | ---- | ------------ | --------------------------------------- | -| mid | num | 用户UID | | +| mid | num | 用户mid | | | attribute | num | 关注属性 | 0：未关注
2：已关注
6：已互粉 | | mtime | num | 成为粉丝时间 | 时间戳
互关后刷新 | | tag | null | | | @@ -116,7 +116,7 @@ **示例：** -获取用户`UID=293793435`的粉丝明细 +获取用户`mid=293793435`的粉丝明细 ```shell curl -G 'http://api.bilibili.com/x/relation/followers' \ @@ -211,7 +211,7 @@ curl -G 'http://api.bilibili.com/x/relation/followers' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ---------- | ---- | ------------ | ----------- | ------------------------------------------------------- | | access_key | str | APP登录Token | APP方式必要 | | -| vmid | num | 目标用户UID | 必要 | | +| vmid | num | 目标用户mid | 必要 | | | order_type | str | 排序方式 | 非必要 | 按照关注顺序排列：留空
按照最常访问排列：attention | | ps | num | 每页项数 | 非必要 | 默认为50 | | pn | num | 页码 | 非必要 | 默认为1
其他用户仅可查看前5页 | @@ -247,10 +247,10 @@ data 对象： | 字段 | 类型 | 内容 | 备注 | | --------------- | ---------------------------------------- | ------------ | --------------------------------------- | -| mid | num | 用户UID | | +| mid | num | 用户mid | | | attribute | num | 关注属性 | 0：未关注
2：已关注
6：已互粉 | | mtime | num | 关注对方时间 | 时间戳
互关后刷新 | -| tag | 默认分组：null
存在至少一个分组：array | 分组ID | | +| tag | 默认分组：null
存在至少一个分组：array | 分组id | | | special | num | 特别关注标志 | 0：否
1：是 | | uname | str | 用户昵称 | | | face | str | 用户头像url | | @@ -262,8 +262,8 @@ data 对象： | 项 | 类型 | 内容 | 备注 | | ---- | ---- | ----------------------- | ---- | -| 0 | num | 位于分组1的分组ID | | -| n | num | 位于分组（n+1）的分组ID | | +| 0 | num | 位于分组1的分组id | | +| n | num | 位于分组（n+1）的分组id | | | …… | num | …… | …… | `list`中的对象中的`official_verify`对象： @@ -294,7 +294,7 @@ data 对象： **示例：** -获取用户`UID=293793435`的关注明细，按照关注顺序 +获取用户`mid=293793435`的关注明细，按照关注顺序 ```shell curl -G 'http://api.bilibili.com/x/relation/ollowings' \ @@ -388,7 +388,7 @@ curl -G 'http://api.bilibili.com/x/relation/ollowings' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ---------- | ---- | ------------ | ----------- | -------- | | access_key | str | APP登录Token | APP方式必要 | | -| vmid | str | 目标用户UID | 必要 | | +| vmid | str | 目标用户mid | 必要 | | | name | str | 搜索关键词 | 必要 | | | ps | num | 每页项数 | 非必要 | 默认为50 | | pn | num | 页码 | 非必要 | 默认为1 | @@ -413,10 +413,10 @@ data 对象： | 字段 | 类型 | 内容 | 备注 | | --------------- | ------------------------------------------- | ------------ | --------------------------------------- | -| mid | num | 用户UID | | +| mid | num | 用户mid | | | attribute | num | 关注属性 | 0：未关注
2：已关注
6：已互粉 | | mtime | num | 关注对方时间 | 时间戳
互关后刷新 | -| tag | 默认分组：null
存在至少一个分组：array | 分组ID | | +| tag | 默认分组：null
存在至少一个分组：array | 分组id | | | special | num | 特别关注标志 | 0：否
1：是 | | uname | str | 用户昵称 | | | face | str | 用户头像url | | @@ -428,8 +428,8 @@ data 对象： | 项 | 类型 | 内容 | 备注 | | ---- | ---- | ----------------------- | ---- | -| 0 | num | 位于分组1的分组ID | | -| n | num | 位于分组（n+1）的分组ID | | +| 0 | num | 位于分组1的分组id | | +| n | num | 位于分组（n+1）的分组id | | | …… | num | …… | …… | `list`中的对象中的`official_verify`对象： @@ -533,7 +533,7 @@ curl -G 'http://api.bilibili.com/x/relation/followings/search' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ---------- | ---- | ------------ | ----------- | -------- | | access_key | str | APP登录Token | APP方式必要 | | -| vmid | num | 目标用户UID | 必要 | | +| vmid | num | 目标用户mid | 必要 | | | ps | num | 每页项数 | 非必要 | 默认为50 | | pn | num | 页码 | 非必要 | 默认为1 | @@ -568,10 +568,10 @@ data 对象： | 字段 | 类型 | 内容 | 备注 | | --------------- | ------------------------------------------- | ------------ | --------------------------------------- | -| mid | num | 用户UID | | +| mid | num | 用户mid | | | attribute | num | 关注属性 | 0：未关注
2：已关注
6：已互粉 | | mtime | num | 关注对方时间 | 时间戳
互关后刷新 | -| tag | 默认分组：null
存在至少一个分组：array | 分组ID | | +| tag | 默认分组：null
存在至少一个分组：array | 分组id | | | special | num | 特别关注标志 | 0：否
1：是 | | uname | str | 用户昵称 | | | face | str | 用户头像url | | @@ -583,8 +583,8 @@ data 对象： | 项 | 类型 | 内容 | 备注 | | ---- | ---- | ----------------------- | ---- | -| 0 | num | 位于分组1的分组ID | | -| n | num | 位于分组（n+1）的分组ID | | +| 0 | num | 位于分组1的分组id | | +| n | num | 位于分组（n+1）的分组id | | | …… | num | …… | …… | `list`中的对象中的`official_verify`对象： @@ -615,7 +615,7 @@ data 对象： **示例：** -获取自己与用户`UID=2`的共同关注明细 +获取自己与用户`mid=2`的共同关注明细 ```shell curl -G 'http://api.bilibili.com/x/relation/same/followings' \ @@ -746,10 +746,10 @@ data 对象： | 字段 | 类型 | 内容 | 备注 | | --------------- | ------------------------------------------- | ------------ | --------------------------------------- | -| mid | num | 用户UID | | +| mid | num | 用户mid | | | attribute | num | 关注属性 | 0：未关注
2：已关注
6：已互粉 | | mtime | num | 关注对方时间 | 时间戳
互关后刷新 | -| tag | 默认分组：null
存在至少一个分组：array | 分组ID | | +| tag | 默认分组：null
存在至少一个分组：array | 分组id | | | special | num | 特别关注标志 | 0：否
1：是 | | uname | str | 用户昵称 | | | face | str | 用户头像url | | @@ -761,8 +761,8 @@ data 对象： | 项 | 类型 | 内容 | 备注 | | ---- | ---- | ----------------------- | ---- | -| 0 | num | 位于分组1的分组ID | | -| n | num | 位于分组（n+1）的分组ID | | +| 0 | num | 位于分组1的分组id | | +| n | num | 位于分组（n+1）的分组id | | | …… | num | …… | …… | `list`中的对象中的`official_verify`对象： @@ -894,7 +894,7 @@ data 对象： | 字段 | 类型 | 内容 | 备注 | | --------------- | ---- | ------------ | ---------------------- | -| mid | num | 用户UID | | +| mid | num | 用户mid | | | attribute | num | 关注属性 | 128：已拉黑 | | mtime | num | 关注对方时间 | 时间戳
互关后刷新 | | tag | null | | | @@ -1029,7 +1029,7 @@ curl -G 'http://api.bilibili.com/x/relation/blacks' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ---------- | ---- | ------------------------ | -------------- | -------------------------------------------------------- | | access_key | str | APP登录Token | APP方式必要 | | -| fid | num | 目标用户UID | 必要 | | +| fid | num | 目标用户mid | 必要 | | | act | num | 操作代码 | 必要 | **操作代码见下表** | | re_src | num | 关注来源代码 | 必要 | 空间：11
视频：14
文章：115
活动页面：222 | | csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | | @@ -1058,7 +1058,7 @@ curl -G 'http://api.bilibili.com/x/relation/blacks' \ **示例：** -关注`UID=14082`的用户 +关注`mid=14082`的用户 ```shell curl 'http://api.bilibili.com/x/relation/modify' \ @@ -1095,7 +1095,7 @@ curl 'http://api.bilibili.com/x/relation/modify' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ---------- | ---- | ------------------------ | -------------- | ---------------------------------------------- | | access_key | str | APP登录Token | APP方式必要 | | -| fids | nums | 目标用户UID | 必要 | 每个ID之间用`,`间隔 | +| fids | nums | 目标用户mid | 必要 | 每个之间用`,`间隔 | | act | num | 操作代码 | 必要 | 同上
仅可为1或5，故只能进行批量关注和拉黑 | | re_src | num | 关注来源代码 | 必要 | 同上 | | csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | | @@ -1115,19 +1115,19 @@ curl 'http://api.bilibili.com/x/relation/modify' \ | 字段 | 类型 | 内容 | 备注 | | ----------- | ----- | ------------- | ---- | -| failed_fids | array | 操作失败的UID | | +| failed_fids | array | 操作失败的mid | | `data`中的`failed_fids`数组： | 项 | 类型 | 内容 | 备注 | | ---- | ---- | -------------------- | ---- | -| 0 | num | 操作失败的UID 1 | | -| n | num | 操作失败的UID（n+1） | | +| 0 | num | 操作失败的mid 1 | | +| n | num | 操作失败的mid（n+1） | | | …… | num | …… | …… | **示例：** -批量关注`UID=1,2,3,4,5`的用户 +批量关注`mid=1,2,3,4,5`的用户 ```shell curl 'http://http://api.bilibili.com/x/relation/batch/modify' \ @@ -1166,7 +1166,7 @@ curl 'http://http://api.bilibili.com/x/relation/batch/modify' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ---------- | ---- | ------------ | ----------- | ---- | | access_key | str | APP登录Token | APP方式必要 | | -| fid | num | 目标用户UID | 必要 | | +| fid | num | 目标用户mid | 必要 | | **json回复：** @@ -1183,23 +1183,23 @@ curl 'http://http://api.bilibili.com/x/relation/batch/modify' \ | 字段 | 类型 | 内容 | 备注 | | --------- | ---------------------------------------- | ------------ | --------------------------------------- | -| mid | num | 目标用户UID | | +| mid | num | 目标用户mid | | | attribute | num | 关注属性 | 0：未关注
2：已关注
6：已互粉
128：拉黑 | | mtime | num | 关注对方时间 | 时间戳
未关注为0 | -| tag | null默认分组
array存在至少一个分组 | 分组ID | | +| tag | null默认分组
array存在至少一个分组 | 分组id | | | special | num | 特别关注标志 | 0：否
1：是 | `tag`数组： | 项 | 类型 | 内容 | 备注 | | ---- | ---- | ----------------------- | ---- | -| 0 | num | 位于分组1的分组ID | | -| n | num | 位于分组（n+1）的分组ID | | +| 0 | num | 位于分组1的分组 | | +| n | num | 位于分组（n+1）的分组 | | | …… | num | …… | …… | **示例：** -可得对于`UID=258150656`的用户，在`2018/10/28 0:51:41`时关注，且设为特别关注，并位于ID为`-10`分组中 +可得对于`mid=258150656`的用户，在`2018/10/28 0:51:41`时关注，且设为特别关注，并位于为`-10`分组中 ```shell curl -G 'http://http://api.bilibili.com/x/relation' \ @@ -1240,7 +1240,7 @@ curl -G 'http://http://api.bilibili.com/x/relation' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ---------- | ---- | ------------ | ----------- | ---- | | access_key | str | APP登录Token | APP方式必要 | | -| mid | num | 目标用户UID | 必要 | | +| mid | num | 目标用户mid | 必要 | | **json回复：** @@ -1264,33 +1264,33 @@ curl -G 'http://http://api.bilibili.com/x/relation' \ | 字段 | 类型 | 内容 | 备注 | | --------- | ---------------------------------------- | ------------ | -------------- | -| mid | num | 对方用户UID | | +| mid | num | 对方用户mid | | | attribute | num | 关注属性 | 0：未关注
1：悄悄关注
2：已关注
6：已互粉
128：拉黑 | | mtime | num | 关注对方时间 | 互关后刷新时间 | -| tag | null默认分组
array存在至少一个分组 | 分组ID | | +| tag | null默认分组
array存在至少一个分组 | 分组id | | | special | num | 特别关注标志 | 0：否
1：是 | `data`中的`be_relation`对象： | 字段 | 类型 | 内容 | 备注 | | --------- | ---------------------------------------- | ------------ | -------------- | -| mid | num | 自己的UID | | +| mid | num | 自己的mid | | | attribute | num | 关注属性 | 0：未关注
1：悄悄关注
2：已关注
6：已互粉
128：拉黑 | | mtime | num | 成为粉丝时间 | 互关后刷新时间 | -| tag | null默认分组
array存在至少一个分组 | 分组ID | | +| tag | null默认分组
array存在至少一个分组 | 分组id | | | special | num | 特别关注标志 | 0：否
1：是 | `be_relation`与`relation`中的`tag`数组： | 项 | 类型 | 内容 | 备注 | | ---- | ---- | ----------------------- | ---- | -| 0 | num | 位于分组1的分组ID | | -| n | num | 位于分组（n+1）的分组ID | | +| 0 | num | 位于分组1的分组id | | +| n | num | 位于分组（n+1）的分组id | | | …… | num | …… | …… | **示例：** -可得对于`UID=15858903`的用户，在`2019/1/24 14:24:19`时关注了对方，且互相关注，自己将对方特别关注，并同时位于ID为`-10`和`194110`的分组中，对方也将自己设为特别关注，并同时位于ID为`-10`和`56502`的分组中（虽然我看不到） +可得对于`mid=15858903`的用户，在`2019/1/24 14:24:19`时关注了对方，且互相关注，自己将对方特别关注，并同时位于为`-10`和`194110`的分组中，对方也将自己设为特别关注，并同时位于为`-10`和`56502`的分组中（虽然我看不到） ```shell curl -G 'http://api.bilibili.com/x/space/acc/relation' \ @@ -1342,7 +1342,7 @@ curl -G 'http://api.bilibili.com/x/space/acc/relation' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ---------- | ---- | ------------ | ----------- | ------------------- | | access_key | str | APP登录Token | APP方式必要 | | -| fids | nums | 目标用户UID | 必要 | 每个ID之间用`,`间隔 | +| fids | nums | 目标用户mid | 必要 | 每个之间用`,`间隔 | **json回复：** @@ -1359,30 +1359,30 @@ curl -G 'http://api.bilibili.com/x/space/acc/relation' \ | 字段 | 类型 | 内容 | 备注 | | --------- | ---- | ---------- | ---- | -| {用户UID} | obj | 关注的用户 | 下同 | +| {用户mid} | obj | 关注的用户 | 下同 | | …… | obj | …… | | -`{用户UID}`对象： +`{用户mid}`对象： | 字段 | 类型 | 内容 | 备注 | | --------- | --------------------------------------- | ------------ | ------------------------------------------------------------ | -| mid | num | 目标用户UID | | +| mid | num | 目标用户mid | | | attribute | num | 关注属性 | 0：未关注
1：悄悄关注
2：已关注
6：已互粉
128：拉黑 | | mtime | num | 关注对方时间 | 时间戳
未关注为0 | -| tag | null默认分组
array存在至少一个分组 | 分组ID | | +| tag | null默认分组
array存在至少一个分组 | 分组id | | | special | num | 特别关注标志 | 0：否
1：是 | `tag`数组： | 项 | 类型 | 内容 | 备注 | | ---- | ---- | ----------------------- | ---- | -| 0 | num | 位于分组1的分组ID | | -| n | num | 位于分组（n+1）的分组ID | | +| 0 | num | 位于分组1的分组id | | +| n | num | 位于分组（n+1）的分组id | | | …… | num | …… | …… | **示例：** -批量查询`UID=1,2,3,4,5`的关系 +批量查询`mid=1,2,3,4,5`的关系 ```shell curl -G 'http://http://api.bilibili.com/x/relation/relations' \ @@ -1459,13 +1459,13 @@ curl -G 'http://http://api.bilibili.com/x/relation/relations' \ | 字段 | 类型 | 内容 | 备注 | | ----- | ---- | ---------- | ---------------------------------- | -| tagid | num | 分组ID | 特别关注恒为-10
默认分组恒为0 | +| tagid | num | 分组id | 特别关注恒为-10
默认分组恒为0 | | name | str | 分组名称 | | | count | num | 分组成员数 | | **示例：** -查询所有的分组的名字以及ID +查询所有的分组的名字以及id ```shell curl 'http://api.bilibili.com/x/relation/tags' \ @@ -1513,7 +1513,7 @@ curl 'http://api.bilibili.com/x/relation/tags' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ---------- | ---- | ------------ | ----------- | ------------------------------------------------------- | | access_key | str | APP登录Token | APP方式必要 | | -| tagid | num | 分组ID | 必要 | 特别关注恒为-10
默认分组恒为0 | +| tagid | num | 分组id | 必要 | 特别关注恒为-10
默认分组恒为0 | | order_type | str | 排序方式 | 非必要 | 按照关注顺序排列：留空
按照最常访问排列：attention | | ps | num | 每页项数 | 非必要 | 默认为50 | | pn | num | 页数 | 非必要 | 默认为1 | @@ -1541,7 +1541,7 @@ curl 'http://api.bilibili.com/x/relation/tags' \ | 字段 | 类型 | 内容 | 备注 | | --------------- | ---- | ----------- | ---- | -| mid | num | 用户UID | | +| mid | num | 用户mid | | | uname | str | 用户昵称 | | | face | str | 用户头像url | | | sign | str | 用户签名 | | @@ -1576,7 +1576,7 @@ curl 'http://api.bilibili.com/x/relation/tags' \ **示例：** -以每页2项的方式获取了ID为`207542`分组的第1页的粉丝明细，按照关注顺序 +以每页2项的方式获取了id为`207542`分组的第1页的粉丝明细，按照关注顺序 ```shell curl -G 'http://api.bilibili.com/x/relation/tag' \ @@ -1656,7 +1656,7 @@ curl -G 'http://api.bilibili.com/x/relation/tag' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ---------- | ---- | ------------ | ----------- | ---- | | access_key | str | APP登录Token | APP方式必要 | | -| fid | num | 目标用户UID | 必要 | | +| fid | num | 目标用户mid | 必要 | | **json回复：** @@ -1673,13 +1673,13 @@ curl -G 'http://api.bilibili.com/x/relation/tag' \ | 字段 | 类型 | 内容 | 备注 | | ------------------- | ---- | --------- | ---- | -| ｛加入的分组ID 1｝ | str | 分组1名称 | | -| ｛加入的分组ID n｝ | str | 分组n名称 | | +| {加入的分组id 1} | str | 分组1名称 | | +| {加入的分组id n} | str | 分组n名称 | | | …… | str | …… | | **示例：** -查询用户`UID=319214221`存在的所有分组ID和名称 +查询用户`mid=319214221`存在的所有分组和名称 ```shell curl -G 'http://api.bilibili.com/x/relation/tag/user' \ @@ -1704,7 +1704,7 @@ curl -G 'http://api.bilibili.com/x/relation/tag/user' \ -### 查询所有特别关注的UID +### 查询所有特别关注的mid > http://api.bilibili.com/x/relation/tag/special @@ -1733,8 +1733,8 @@ curl -G 'http://api.bilibili.com/x/relation/tag/user' \ | 项 | 类型 | 内容 | 备注 | | ---- | ---- | -------------- | ---- | -| 0 | num | 成员1UID | | -| n | num | 成员（n+1）UID | | +| 0 | num | 成员1mid | | +| n | num | 成员（n+1）mid | | | …… | num | …… | …… | **示例：** @@ -1810,11 +1810,11 @@ curl 'http://api.bilibili.com/x/relation/tag/special' \ | 字段 | 类型 | 内容 | 备注 | | ----- | ---- | -------------- | ---- | -| tagid | num | 创建的分组的ID | | +| tagid | num | 创建的分组的id | | **示例：** -创建了名为`测试`的分组，得到ID为`216677` +创建了名为`测试`的分组，得到id为`216677` ```shell curl 'http://api.bilibili.com/x/relation/tag/create' \ @@ -1852,7 +1852,7 @@ curl 'http://api.bilibili.com/x/relation/tag/create' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ---------- | ---- | ------------------------ | -------------- | ---------- | | access_key | str | APP登录Token | APP方式必要 | | -| tagid | num | 分组ID | 必要 | | +| tagid | num | 分组id | 必要 | | | name | str | 新名称 | 必要 | 最长16字符 | | csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | | @@ -1868,7 +1868,7 @@ curl 'http://api.bilibili.com/x/relation/tag/create' \ **示例：** -把ID为`194112`的分组更名为`膜法师` +把id为`194112`的分组更名为`膜法师` ```shell curl 'http://api.bilibili.com/x/relation/tag/update' \ @@ -1906,7 +1906,7 @@ curl 'http://api.bilibili.com/x/relation/tag/update' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ---------- | ---- | ------------------------ | -------------- | ---- | | access_key | str | APP登录Token | APP方式必要 | | -| tagid | num | 分组ID | 必要 | | +| tagid | num | 分组id | 必要 | | | csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | | **json回复：** @@ -1921,7 +1921,7 @@ curl 'http://api.bilibili.com/x/relation/tag/update' \ 示例： -删除分组ID为`216699`的分组 +删除分组id为`216699`的分组 ```shell curl 'http://api.bilibili.com/x/relation/tag/del' \ @@ -1958,8 +1958,8 @@ curl 'http://api.bilibili.com/x/relation/tag/del' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ---------- | ---- | ------------------------ | -------------- | ------------------- | | access_key | str | APP登录Token | APP方式必要 | | -| fids | nums | 目标用户UID | 必要 | 每个ID之间用`,`间隔 | -| tagids | nums | 分组ID | 必要 | 每个ID之间用`,`间隔 | +| fids | nums | 目标用户mid | 必要 | 每个之间用`,`间隔 | +| tagids | nums | 分组id | 必要 | 每个之间用`,`间隔 | | csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | | **json回复：** @@ -1974,7 +1974,7 @@ curl 'http://api.bilibili.com/x/relation/tag/del' \ **示例：** -把关注用户`UID=205631797`同时添加分组关系到ID为`-10`和`207542`的分组中 +把关注用户`mid=205631797`同时添加分组关系到id为`-10`和`207542`的分组中 ```shell curl 'http://api.bilibili.com/x/relation/tags/addUsers' \ @@ -2010,8 +2010,8 @@ curl 'http://api.bilibili.com/x/relation/tags/addUsers' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ---------- | ---- | ------------------------ | -------------- | ------------------- | | access_key | str | APP登录Token | APP方式必要 | | -| fids | nums | 待复制的用户UID | 必要 | 每个ID之间用`,`间隔 | -| tagids | nums | 目标分组ID | 必要 | 每个ID之间用`,`间隔 | +| fids | nums | 待复制的用户mid | 必要 | 每个之间用`,`间隔 | +| tagids | nums | 目标分组id | 必要 | 每个之间用`,`间隔 | | csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | | **json回复：** @@ -2026,7 +2026,7 @@ curl 'http://api.bilibili.com/x/relation/tags/addUsers' \ **示例：** -把关注用户`UID=4856007`和`UID=326499679`同时复制到ID为`231305`的分组中 +把关注用户`mid=4856007`和`mid=326499679`同时复制到为`231305`的分组id中 ```shell curl 'http://api.bilibili.com/x/relation/tags/copyUsers' \ @@ -2062,9 +2062,9 @@ curl 'http://api.bilibili.com/x/relation/tags/copyUsers' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------------ | ---- | ------------------------ | -------------- | ------------------- | | access_key | str | APP登录Token | APP方式必要 | | -| beforeTagids | nums | 原分组ID | 必要 | 每个ID之间用`,`间隔 | -| afterTagids | nums | 新分组ID | 必要 | 每个ID之间用`,`间隔 | -| fids | nums | 待移动的用户UID | 必要 | 每个ID之间用`,`间隔 | +| beforeTagids | nums | 原分组id | 必要 | 每个之间用`,`间隔 | +| afterTagids | nums | 新分组id | 必要 | 每个之间用`,`间隔 | +| fids | nums | 待移动的用户mid | 必要 | 每个之间用`,`间隔 | | csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | | **json回复：** @@ -2079,7 +2079,7 @@ curl 'http://api.bilibili.com/x/relation/tags/copyUsers' \ **示例：** -把关注用户`UID=321173469`和`UID=327086920`同时从ID为`207542`的分组移动到ID为`231305`的分组中 +把关注用户`mid=321173469`和`mid=327086920`同时从id为`207542`的分组移动到为`231305`的分组中 ```shell curl 'http://api.bilibili.com/x/relation/tags/moveUsers' \ diff --git a/user/space.md b/user/space.md index 2703689..f92896d 100644 --- a/user/space.md +++ b/user/space.md @@ -65,7 +65,7 @@ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ----------- | ------ | ---- | -| vmid | num | 目标用户UID | 必要 | | +| vmid | num | 目标用户mid | 必要 | | **json回复：** @@ -82,9 +82,9 @@ | 字段 | 类型 | 内容 | 备注 | | ----------- | ---- | ------------------------------ | ------------------------------------------------------------ | -| aid | num | 稿件avID | | +| aid | num | 稿件avid | | | videos | num | 视频分P总数 | 默认为1 | -| tid | num | 分区tID | | +| tid | num | 分区tid | | | tname | str | 子分区名称 | | | copyright | num | 是否转载 | 1：原创
2：转载 | | pic | str | 视频封面图片url | | @@ -99,15 +99,15 @@ | owner | obj | 视频UP主信息 | 略，见[获取视频详细信息（web端）](/video/info.md#获取视频详细信息（web端）)中的`owner`对象 | | stat | obj | 视频状态数 | 略，见[获取视频详细信息（web端）](/video/info.md#获取视频详细信息（web端）)中的`stat`对象 | | dynamic | str | 视频同步发布的的动态的文字内容 | 无为空 | -| cid | num | 视频1P CID | | +| cid | num | 视频1P cid | | | dimension | obj | 视频1P分辨率 | 略，见[获取视频详细信息（web端）](/video/info.md#获取视频详细信息（web端）)中的`dimension`对象 | -| bvid | str | 稿件bvID | | +| bvid | str | 稿件bvid | | | reason | str | 置顶视频备注 | | | inter_video | bool | 是否为合作视频 | false：否
true：是 | **示例：** -查询用户`UID=23215368`的置顶视频 +查询用户`mid=23215368`的置顶视频 ```shell curl -G 'http://api.bilibili.com/x/space/top/arc' \ @@ -196,8 +196,8 @@ curl -G 'http://api.bilibili.com/x/space/top/arc' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ------------------------ | ------------ | -------------------------------- | -| aid | num | 置顶目标稿件avID | 必要（可选） | avID与bvID任选一个 | -| bvid | str | 置顶目标稿件bvID | 必要（可选） | avID与bvID任选一个 | +| aid | num | 置顶目标稿件avid | 必要（可选） | avid与bvid任选一个 | +| bvid | str | 置顶目标稿件bvid | 必要（可选） | avid与bvid任选一个 | | reason | str | 置顶视频备注 | 非必要 | 置顶备注最大40字符
默认为空 | | csrf | str | CSRF Token（位于cookie） | 必要 | | @@ -215,7 +215,7 @@ curl -G 'http://api.bilibili.com/x/space/top/arc' \ 置顶视频`av98948772`/`BV1n741127LD` -avID方式： +avid方式： ```shell curl 'http://api.bilibili.com/x/space/top/arc/set' \ @@ -223,7 +223,7 @@ curl 'http://api.bilibili.com/x/space/top/arc/set' \ -b 'SESSDATA=xxx' ``` -bvID方式： +bvid方式： ```shell curl 'http://api.bilibili.com/x/space/top/arc/set' \ @@ -305,7 +305,7 @@ curl 'http://api.bilibili.com/x/space/top/arc/cancel' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ----------- | ------ | ---- | -| vmid | num | 目标用户UID | 必要 | | +| vmid | num | 目标用户mid | 必要 | | **json回复：** @@ -332,7 +332,7 @@ curl 'http://api.bilibili.com/x/space/top/arc/cancel' \ **示例：** -查询用户`UID=23215368`的代表作视频列表 +查询用户`mid=23215368`的代表作视频列表 ```shell curl -G 'http://api.bilibili.com/x/space/masterpiece' \ @@ -536,8 +536,8 @@ curl -G 'http://api.bilibili.com/x/space/masterpiece' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ------------------------ | ------------ | -------------------------------- | -| aid | num | 置顶目标稿件avID | 必要（可选） | avID与bvID任选一个 | -| bvid | str | 置顶目标稿件bvID | 必要（可选） | avID与bvID任选一个 | +| aid | num | 置顶目标稿件avid | 必要（可选） | avid与bvid任选一个 | +| bvid | str | 置顶目标稿件bvid | 必要（可选） | avid与bvid任选一个 | | reason | str | 代表作备注 | 非必要 | 置顶备注最大40字符
默认为空 | | csrf | str | CSRF Token（位于cookie） | 必要 | | @@ -555,7 +555,7 @@ curl -G 'http://api.bilibili.com/x/space/masterpiece' \ 添加视频`av94916552`/`BV1ZE411K7ux`到代表作列表 -avID方式： +avid方式： ```shell curl 'http://api.bilibili.com/x/space/masterpiece/add' \ @@ -564,7 +564,7 @@ curl 'http://api.bilibili.com/x/space/masterpiece/add' \ -b 'SESSDATA=xxx' ``` -bvID方式： +bvid方式： ```shell curl 'http://api.bilibili.com/x/space/masterpiece/add' \ @@ -598,8 +598,8 @@ curl 'http://api.bilibili.com/x/space/masterpiece/add' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ------------------------ | ------------ | ------------------ | -| aid | num | 要删除的目标稿件avID | 必要（可选） | avID与bvID任选一个 | -| bvid | str | 要删除的目标稿件bvID | 必要（可选） | avID与bvID任选一个 | +| aid | num | 要删除的目标稿件avid | 必要（可选） | avid与bvid任选一个 | +| bvid | str | 要删除的目标稿件bvid | 必要（可选） | avid与bvid任选一个 | | csrf | str | CSRF Token（位于cookie） | 必要 | | **json回复：** @@ -616,7 +616,7 @@ curl 'http://api.bilibili.com/x/space/masterpiece/add' \ 删除置顶视频`av59765630`/`BV1Yt41137T6` -avID方式： +avid方式： ```shell curl 'api.bilibili.com/x/space/masterpiece/cancel' \ @@ -625,7 +625,7 @@ curl 'api.bilibili.com/x/space/masterpiece/cancel' \ -b 'SESSDATA=xxx' ``` -bvID方式： +bvid方式： ```shell curl 'http://api.bilibili.com/x/space/masterpiece/cancel' \ @@ -650,7 +650,7 @@ curl 'http://api.bilibili.com/x/space/masterpiece/cancel' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ----------- | ------ | ---- | -| mid | num | 目标用户UID | 必要 | | +| mid | num | 目标用户mid | 必要 | | **json回复：** @@ -673,7 +673,7 @@ curl 'http://api.bilibili.com/x/space/masterpiece/cancel' \ | 字段 | 类型 | 内容 | 备注 | | ---- | ----- | ----------- | ---- | -| mid | num | 目标用户UID | | +| mid | num | 目标用户mid | | | tags | array | TAG名称 | | `data`数组中的对象中的`tags`数组： @@ -687,7 +687,7 @@ curl 'http://api.bilibili.com/x/space/masterpiece/cancel' \ **示例：** -查看用户`UID=53456`的个人TAG +查看用户`mid=53456`的个人TAG ```shell curl -G 'http://api.bilibili.com/x/space/acc/tags' \ @@ -782,7 +782,7 @@ curl 'http://api.bilibili.com/x/space/acc/tags/set' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ----------- | ------ | ---- | -| mid | num | 目标用户UID | 必要 | | +| mid | num | 目标用户mid | 必要 | | **json回复：** @@ -797,7 +797,7 @@ curl 'http://api.bilibili.com/x/space/acc/tags/set' \ **示例：** -查看用户`UID=53456`的空间公告 +查看用户`mid=53456`的空间公告 ```shell curl -G 'http://api.bilibili.com/x/space/notice' \ @@ -881,7 +881,7 @@ curl 'http://api.bilibili.com/x/space/notice/set' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ----------- | ------ | ---- | -| mid | num | 目标用户UID | 必要 | | +| mid | num | 目标用户mid | 必要 | | **json回复：** @@ -950,7 +950,7 @@ curl 'http://api.bilibili.com/x/space/notice/set' \ **示例：** -查看`UID=2`的空间设置 +查看`mid=2`的空间设置 ```shell curl -G 'http://space.bilibili.com/ajax/settings/getSettings' \ @@ -1196,7 +1196,7 @@ curl 'http://space.bilibili.com/ajax/settings/setPrivacy' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ----------- | ------ | ---- | -| mid | num | 目标用户UID | 必要 | | +| mid | num | 目标用户mid | 必要 | | **json回复：** @@ -1227,7 +1227,7 @@ curl 'http://space.bilibili.com/ajax/settings/setPrivacy' \ **示例：** -查询`UID=2`的最近玩过的游戏 +查询`mid=2`的最近玩过的游戏 ```shell curl -G 'http://api.bilibili.com/x/space/lastplaygame' \ @@ -1288,7 +1288,7 @@ curl -G 'http://api.bilibili.com/x/space/lastplaygame' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ----------- | ------ | ---- | -| vmid | num | 目标用户UID | 必要 | | +| vmid | num | 目标用户mid | 必要 | | **json回复：** @@ -1315,7 +1315,7 @@ curl -G 'http://api.bilibili.com/x/space/lastplaygame' \ **示例：** -查看用户`UID=15858903`的最近投币视频 +查看用户`mid=15858903`的最近投币视频 ```shell curl -G 'http://space.bilibili.com/x/space/coin/video' \ @@ -1531,9 +1531,9 @@ curl -G 'http://space.bilibili.com/x/space/coin/video' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------- | ---- | ------------ | ------ | ------------------------------------------------------------ | -| mid | num | 目标用户UID | 必要 | | +| mid | num | 目标用户mid | 必要 | | | order | str | 排序方式 | 非必要 | 默认为pubdate
最新发布：pubdate
最多播放：click
最多收藏：stow | -| tid | num | 筛选目标分区 | 非必要 | 默认为0
0：不进行分区筛选
分区tID为所筛选的分区 | +| tid | num | 筛选目标分区 | 非必要 | 默认为0
0：不进行分区筛选
分区tid为所筛选的分区 | | keyword | str | 关键词筛选 | 非必要 | 用于使用关键词搜索该UP主视频稿件 | | pn | num | 页码 | 必要 | | | ps | num | 每页项数 | 必要 | | @@ -1568,16 +1568,16 @@ curl -G 'http://space.bilibili.com/x/space/coin/video' \ | 字段 | 类型 | 内容 | 备注 | | ----- | ---- | ------------ | --------------------- | -| {tID} | obj | 该分区的详情 | 字段名为存在的分区tID | +| {tid} | obj | 该分区的详情 | 字段名为存在的分区tid | | …… | obj | …… | 向下扩展 | -`tlist`中的`{tID}`对象： +`tlist`中的`{tid}`对象： | 字段 | 类型 | 内容 | 备注 | | ----- | ---- | -------------------- | ---- | | count | num | 投稿至该分区的视频数 | | | name | str | 该分区名称 | | -| tid | num | 该分区tID | | +| tid | num | 该分区tid | | `list`中的`vlist`数组： @@ -1591,9 +1591,9 @@ curl -G 'http://space.bilibili.com/x/space/coin/video' \ | 字段 | 类型 | 内容 | 备注 | | -------------- | ---- | -------------- | ---------------------------- | -| aid | num | 稿件avID | | +| aid | num | 稿件avid | | | author | str | 视频UP主 | 不一定为目标用户（合作视频） | -| bvid | str | 稿件bvID | | +| bvid | str | 稿件bvid | | | comment | num | 视频评论数 | | | copyright | str | 空 | 作用尚不明确 | | created | num | 投稿时间 | 时间戳 | @@ -1602,13 +1602,13 @@ curl -G 'http://space.bilibili.com/x/space/coin/video' \ | is_pay | num | 0 | 作用尚不明确 | | is_union_video | num | 是否为合作视频 | 0：否
1：是 | | length | str | 视频长度 | MM:SS | -| mid | num | 视频UP主UID | 不一定为目标用户（合作视频） | +| mid | num | 视频UP主mid | 不一定为目标用户（合作视频） | | pic | str | 视频封面 | | | play | num | 视频播放次数 | | | review | num | 0 | 作用尚不明确 | | subtitle | str | 空 | 作用尚不明确 | | title | str | 视频标题 | | -| typeid | num | 视频分区tID | | +| typeid | num | 视频分区tid | | | video_review | num | 视频弹幕数 | | `data`中的`page`对象： @@ -1630,7 +1630,7 @@ curl -G 'http://space.bilibili.com/x/space/coin/video' \ `pn`（页码）和`ps`（每页项数）只改变`vlist`中成员的多少与内容 -以每页2项查询用户`UID=53456`的第1页投稿视频明细 +以每页2项查询用户`mid=53456`的第1页投稿视频明细 ```shell curl -G 'http://api.bilibili.com/x/space/arc/search' \ @@ -1750,7 +1750,7 @@ curl -G 'http://api.bilibili.com/x/space/arc/search' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ------------ | ------ | ------- | -| mid | num | 目标用户UID | 必要 | | +| mid | num | 目标用户mid | 必要 | | | ps | num | 获取的相簿量 | 非必要 | 默认为8 | **json回复：** @@ -1779,10 +1779,10 @@ curl -G 'http://api.bilibili.com/x/space/arc/search' \ | count | num | 总计图片数 | | | ctime | num | 发布时间 | 时间戳 | | description | str | 简介 | | -| doc_id | num | 相簿ID | 非动态ID！！！ | +| doc_id | num | 相簿id | 非动态！！！ | | like | num | 点赞数 | | | pictures | array | 图片内容 | | -| poster_uid | num | 上传用户UID | | +| poster_uid | num | 上传用户mid | | | title | str | 标题 | 动态内容无 | | view | num | 浏览数 | | @@ -1805,7 +1805,7 @@ curl -G 'http://api.bilibili.com/x/space/arc/search' \ **示例：** -查询用户`UID=53456`的投稿相簿预览 +查询用户`mid=53456`的投稿相簿预览 ```shell curl -G 'http://api.bilibili.com/x/space/album/index' \ @@ -1877,7 +1877,7 @@ curl -G 'http://api.bilibili.com/x/space/album/index' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | --------- | ---- | ----------- | ------ | ------------------------------------------------------------ | -| uid | num | 目标用户UID | 必要 | | +| uid | num | 目标用户mid | 必要 | | | page_num | num | 页码 | 非必要 | 默认为1 | | page_size | num | 每页项数 | 非必要 | 默认为20 | | biz | str | 查询类型 | 非必要 | 全部：all
绘画：draw
摄影：photo
日常：daily
默认为all | @@ -1914,10 +1914,10 @@ curl -G 'http://api.bilibili.com/x/space/album/index' \ | count | num | 总计图片数 | | | ctime | num | 发布时间 | 时间戳 | | description | str | 简介 | | -| doc_id | num | 相簿ID | 非动态ID！！！ | +| doc_id | num | 相簿id | 非动态！！！ | | like | num | 点赞数 | | | pictures | array | 图片内容 | | -| poster_uid | num | 上传用户UID | | +| poster_uid | num | 上传用户mid | | | title | str | 标题 | 动态内容无 | | view | num | 浏览数 | | @@ -1940,7 +1940,7 @@ curl -G 'http://api.bilibili.com/x/space/album/index' \ **示例：** -查询用户`UID=53456`的投稿明细中的全部类型 +查询用户`mid=53456`的投稿明细中的全部类型 ```shell curl -G 'http://api.vc.bilibili.com/link_draw/v1/doc/doc_list' \ @@ -2025,7 +2025,7 @@ curl -G 'http://api.vc.bilibili.com/link_draw/v1/doc/doc_list' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ----------- | ------ | ---- | -| mid | num | 目标用户UID | 必要 | | +| mid | num | 目标用户mid | 必要 | | **json回复：** @@ -2057,17 +2057,17 @@ curl -G 'http://api.vc.bilibili.com/link_draw/v1/doc/doc_list' \ | 字段 | 类型 | 内容 | 备注 | | ----- | ---- | -------------- | -------- | -| cid | num | 频道ID | | +| cid | num | 频道id | | | count | num | 频道内含视频数 | | | cover | str | 封面图片url | | | intro | str | 简介 | 无则为空 | -| mid | num | 创建用户UID | | +| mid | num | 创建用户mid | | | mtime | num | 创建时间 | 时间戳 | | name | str | 标题 | | **示例：** -查询用户`UID=53456`的频道列表 +查询用户`mid=53456`的频道列表 ```shell curl -G 'http://api.bilibili.com/x/space/channel/list' \ @@ -2151,8 +2151,8 @@ curl -G 'http://api.bilibili.com/x/space/channel/list' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ----------- | ------ | --------- | -| mid | num | 目标用户UID | 必要 | | -| cid | num | 目标频道ID | 必要 | | +| mid | num | 目标用户mid | 必要 | | +| cid | num | 目标频道id | 必要 | | | pn | num | 页码 | 非必要 | 默认为1 | | ps | num | 每页项数 | 非必要 | 默认为100 | @@ -2179,11 +2179,11 @@ curl -G 'http://api.bilibili.com/x/space/channel/list' \ | 字段 | 类型 | 内容 | 备注 | | -------- | ------ | -------------- | -------- | | archives | array | 包含的视频列表 | | -| cid | num | 频道ID | | +| cid | num | 频道id | | | count | num | 频道内含视频数 | | | cover | str | 封面图片url | | | intro | str | 简介 | 无则为空 | -| mid | num | 创建用户UID | | +| mid | num | 创建用户mid | | | mtime | num | 创建时间 | 时间戳 | | name | str | 标题 | | @@ -2197,7 +2197,7 @@ curl -G 'http://api.bilibili.com/x/space/channel/list' \ `list`中的`archives`数组中的对象： -基本同「[视频详细信息](https://github.com/SocialSisterYi/bilibili-API-collect/blob/master/video/info.md#视频详细信息（avID/bvID互转）)」中的data对象 +基本同「[视频详细信息](https://github.com/SocialSisterYi/bilibili-API-collect/blob/master/video/info.md#视频详细信息（avid/bvid互转）)」中的data对象 `data`中的`page`对象： @@ -2209,7 +2209,7 @@ curl -G 'http://api.bilibili.com/x/space/channel/list' \ **示例：** -查询用户`UID=53456`的频道`170`中的视频 +查询用户`mid=53456`的频道`170`中的视频 ```shell curl -G 'http://api.bilibili.com/x/space/channel/video' \ @@ -2368,7 +2368,7 @@ curl -G 'http://api.bilibili.com/x/space/channel/video' \ 认证方式：Cookie（SESSDATA） -创建成功后会返回新建频道的ID +创建成功后会返回新建频道的id **正文参数（ application/x-www-form-urlencoded ）：** @@ -2393,7 +2393,7 @@ curl -G 'http://api.bilibili.com/x/space/channel/video' \ | 字段 | 类型 | 内容 | 备注 | | ---- | ---- | ------ | ---- | -| cid | num | 频道ID | | +| cid | num | 频道id | | **示例：** @@ -2435,7 +2435,7 @@ curl 'http://api.bilibili.com/x/space/channel/add' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ------------------------ | ------ | ---- | -| cid | num | 频道ID | 必要 | | +| cid | num | 频道id | 必要 | | | name | str | 频道名 | 必要 | | | intro | str | 频道简介 | 非必要 | | | csrf | str | CSRF Token（位于cookie） | 必要 | | @@ -2488,7 +2488,7 @@ curl 'http://api.bilibili.com/x/space/channel/edit' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ------------------------ | ------ | ---- | -| cid | num | 需要删除的频道ID | 必要 | | +| cid | num | 需要删除的频道id | 必要 | | | csrf | str | CSRF Token（位于cookie） | 必要 | | **json回复：** @@ -2543,8 +2543,8 @@ curl 'http://api.bilibili.com/x/space/channel/del' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ------------------------ | ------ | ---------------------- | -| cid | num | 频道ID | 必要 | | -| aids | nums | 要添加的目标稿件avID | 必要 | 多个使用","（%2C）分隔 | +| cid | num | 频道id | 必要 | | +| aids | nums | 要添加的目标稿件avid | 必要 | 多个使用","（%2C）分隔 | | csrf | str | CSRF Token（位于cookie） | 必要 | | **json回复：** @@ -2556,14 +2556,14 @@ curl 'http://api.bilibili.com/x/space/channel/del' \ | code | num | 返回值 | 0：成功
-101：账号未登录
-111：csrf校验失败
-400：请求错误
-404：无此项
53003：本频道里的视频已满
53006：提交视频已失效或频道里有（非该视频UP主） | | message | str | 错误信息 | 默认为0 | | ttl | num | 1 | | -| data | array | 出错稿件avID列表 | | +| data | array | 出错稿件avid列表 | | `data`数组： | 项 | 类型 | 内容 | 备注 | | ---- | ---- | ------------------- | ---- | -| 0 | num | 出错稿件avID1 | | -| n | num | 出错稿件avID（n+1） | | +| 0 | num | 出错稿件avid1 | | +| n | num | 出错稿件avid（n+1） | | | …… | num | …… | …… | **示例：** @@ -2606,8 +2606,8 @@ curl 'http://api.bilibili.com/x/space/channel/video/add' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ------------------------ | ------ | ---- | -| cid | num | 频道ID | 必要 | | -| aid | num | 要删除的目标稿件avID | 必要 | | +| cid | num | 频道id | 必要 | | +| aid | num | 要删除的目标稿件avid | 必要 | | | csrf | str | CSRF Token（位于cookie） | 必要 | | **json回复：** @@ -2657,8 +2657,8 @@ curl 'http://api.bilibili.com/x/space/channel/video/del' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ------------------------ | ------ | ------------------------------------------------------------ | -| cid | num | 频道ID | 必要 | | -| aid | num | 要移动的目标稿件avID | 必要 | | +| cid | num | 频道id | 必要 | | +| aid | num | 要移动的目标稿件avid | 必要 | | | to | num | 视频排序倒数位置 | 非必要 | 默认为1
1为列表底部，视频总数为首端
与显示顺序恰好相反 | | csrf | str | CSRF Token（位于cookie） | 必要 | | @@ -2710,7 +2710,7 @@ curl 'http://api.bilibili.com/x/space/channel/video/sort' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ---------- | ------ | ---- | -| cid | num | 目标频道ID | 必要 | | +| cid | num | 目标频道id | 必要 | | **json回复：** @@ -2763,7 +2763,7 @@ curl -G 'http://api.bilibili.com/x/space/channel/video/check | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ----------- | ------ | ---- | -| up_mid | num | 目标用户UID | 必要 | | +| up_mid | num | 目标用户mid | 必要 | | **json回复：** @@ -2795,9 +2795,9 @@ curl -G 'http://api.bilibili.com/x/space/channel/video/check | 字段 | 类型 | 内容 | 备注 | | ----------- | ---- | ---------------- | --------------- | -| id | num | 收藏夹mlID | | -| fid | num | 原始收藏夹ID | 去除两位UID尾号 | -| mid | num | 创建用户UID | | +| id | num | 收藏夹mlid | | +| fid | num | 原始收藏夹mlid | 去除两位mid尾号 | +| mid | num | 创建用户mid | | | attr | num | 收藏夹属性位配置 | | | title | str | 收藏夹标题 | | | fav_state | num | 0 | 作用尚不明确 | @@ -2813,7 +2813,7 @@ curl -G 'http://api.bilibili.com/x/space/channel/video/check **示例：** -查询用户`UID=7792521`的收藏夹列表 +查询用户`mid=7792521`的收藏夹列表 ```shell curl -G 'http://api.bilibili.com/x/v3/fav/folder/created/list-all' \ @@ -2890,7 +2890,7 @@ curl -G 'http://api.bilibili.com/x/v3/fav/folder/created/list-all' \ | ------ | ---- | ----------- | ------ | ---- | | ps | num | 每页项数 | 必要 | | | pn | num | 页码 | 必要 | | -| up_mid | num | 目标用户UID | 必要 | | +| up_mid | num | 目标用户mid | 必要 | | **json回复：** @@ -2922,9 +2922,9 @@ curl -G 'http://api.bilibili.com/x/v3/fav/folder/created/list-all' \ | 字段 | 类型 | 内容 | 备注 | | ----------- | ---- | ------------------ | ----------------------------------------- | -| id | num | 收藏夹mlID | | -| fid | num | 原始收藏夹ID | 去除两位UID尾号 | -| mid | num | 创建用户UID | | +| id | num | 收藏夹ml | | +| fid | num | 原始收藏夹mlid | 去除两位mid尾号 | +| mid | num | 创建用户mid | | | attr | num | 收藏夹属性 | 转换成8-bit二进制处理
详细说明见下表 | | title | str | 收藏夹标题 | | | cover | str | 收藏夹封面图片url | | @@ -2947,13 +2947,13 @@ curl -G 'http://api.bilibili.com/x/v3/fav/folder/created/list-all' \ | 字段 | 类型 | 内容 | 备注 | | ---- | ---- | ---------- | ------------ | -| mid | num | 创建人UID | | +| mid | num | 创建人mid | | | name | str | 创建人昵称 | | | face | str | 空 | 作用尚不明确 | **示例：** -查询用户`UID=293793435`的收藏夹收藏列表 +查询用户`mid=293793435`的收藏夹收藏列表 ```shell curl -G 'http://api.bilibili.com/x/v3/fav/folder/collected/list' \ @@ -3032,7 +3032,7 @@ curl -G 'http://api.bilibili.com/x/v3/fav/folder/collected/list' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ----------- | ------ | -------- | -| mid | num | 目标用户UID | 必要 | | +| mid | num | 目标用户mid | 必要 | | | pn | num | 页码 | 非必要 | 默认为1 | | ps | num | 每页项数 | 非必要 | 默认为20 | @@ -3080,14 +3080,14 @@ curl -G 'http://api.bilibili.com/x/v3/fav/folder/collected/list' \ | link | str | 课程页面url | 手机版页面url | | page | num | 1 | 作用尚不明确 | | play | num | 课程播放数 | | -| season_id | num | 课程ssID | | +| season_id | num | 课程ssid | | | status | str | 更新状态说明 | | | subtitle | str | 课程副标题 | | | title | str | 课程标题 | | **示例：** -查询用户`UID=33683045`的课程发布列表 +查询用户`mid=33683045`的课程发布列表 ```shell curl -G 'http://api.bilibili.com/pugv/app/web/season/page' \ @@ -3193,7 +3193,7 @@ curl -G 'http://api.bilibili.com/pugv/app/web/season/page' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ----------- | ------ | ---- | -| mid | num | 目标用户UID | 必要 | | +| mid | num | 目标用户mid | 必要 | | **json回复：** @@ -3232,14 +3232,14 @@ curl -G 'http://api.bilibili.com/pugv/app/web/season/page' \ | is_finish | num | 是否已完结 | 0：未完结
1：已完结 | | last_ep_index | num | 0 | 作用尚不明确 | | newest_ep_index | num | 最新一话 | 可能为0 | -| season_id | str | 番剧ssID | | +| season_id | str | 番剧ssid | | | share_url | str | 播放页面链接url | | | title | str | 标题 | | | total_count | num | 总计集数 | 未完结：-1
已完结：非0正整数 | **示例：** -查看用户`UID=14082`的追番预览列表 +查看用户`mid=14082`的追番预览列表 ```shell curl -G 'http://space.bilibili.com/ajax/Bangumi/getList' \ @@ -3303,7 +3303,7 @@ curl -G 'http://space.bilibili.com/ajax/Bangumi/getList' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ----------- | ------ | -------------------- | -| vmid | num | 目标用户UID | 必要 | | +| vmid | num | 目标用户mid | 必要 | | | pn | num | 页码 | 非必要 | 默认为1 | | ps | num | 每页项数 | 非必要 | 默认为15 | | type | num | 查询类型 | 必要 | 1：追番
2：追剧 | @@ -3342,7 +3342,7 @@ curl -G 'http://space.bilibili.com/ajax/Bangumi/getList' \ **示例：** -查看用户`UID=14082`的追番明细 +查看用户`mid=14082`的追番明细 ```shell curl -G 'http://api.bilibili.com/x/space/bangumi/follow/list' \ @@ -3571,7 +3571,7 @@ curl -G 'http://api.bilibili.com/x/space/bangumi/follow/list' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ----------- | ------ | ---- | -| mid | num | 目标用户UID | 必要 | | +| mid | num | 目标用户mid | 必要 | | **json回复：** @@ -3606,12 +3606,12 @@ curl -G 'http://api.bilibili.com/x/space/bangumi/follow/list' \ | cover | str | TAG图片url | 无则为空 | | name | str | TAG名 | | | notify | num | 1 | 作用尚不明确 | -| tag_id | num | TAGID | | +| tag_id | num | tag_id | | | updated_ts | str | 1970-01-01 08:00:00 | 作用尚不明确 | **示例：** -查询用户`UID=2`的关注TAG +查询用户`mid=2`的关注TAG ```shell curl -G 'http://space.bilibili.com/ajax/tags/getSubList' \ diff --git a/user/status_number.md b/user/status_number.md index 79fc95e..12227b8 100644 --- a/user/status_number.md +++ b/user/status_number.md @@ -19,7 +19,7 @@ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ---------- | ---- | ------------ | ----------- | ---- | | access_key | str | APP登录Token | APP方式必要 | | -| vmid | num | 目标用户UID | 必要 | | +| vmid | num | 目标用户mid | 必要 | | **json回复：** @@ -36,7 +36,7 @@ | 字段 | 类型 | 内容 | 备注 | | --------- | ---- | ----------- | ------------------------------------------------ | -| mid | num | 目标用户UID | | +| mid | num | 目标用户mid | | | following | num | 关注数 | | | whisper | num | 悄悄关注数 | 需要登录(Cooklie或APP)
未登录或非自己恒为0 | | black | num | 黑名单数 | 需要登录(Cooklie或APP)
未登录或非自己恒为0 | @@ -44,7 +44,7 @@ **示例：** -查询用户`UID=332704117`的关系状态数 +查询用户`mid=332704117`的关系状态数 ```shell curl -G 'http://api.bilibili.com/x/relation/stat' \ @@ -87,7 +87,7 @@ curl -G 'http://api.bilibili.com/x/relation/stat' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ---------- | ---- | ------------ | ----------- | ---- | | access_key | str | APP登录Token | APP方式必要 | | -| mid | num | 目标用户UID | 必要 | | +| mid | num | 目标用户mid | 必要 | | **json回复：** @@ -122,7 +122,7 @@ curl -G 'http://api.bilibili.com/x/relation/stat' \ **示例：** -查询用户`UID=456664753`的UP主状态数 +查询用户`mid=456664753`的UP主状态数 ```shell curl -G 'http://api.bilibili.com/x/space/upstat' \ @@ -164,7 +164,7 @@ curl -G 'http://api.bilibili.com/x/space/upstat' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ----------- | ------ | ---- | -| mid | num | 目标用户UID | 必要 | | +| mid | num | 目标用户mid | 必要 | | **json回复：** @@ -209,7 +209,7 @@ curl -G 'http://api.bilibili.com/x/space/upstat' \ **示例：** -查询用户`UID=239202390`的订阅&投稿状态数 +查询用户`mid=239202390`的订阅&投稿状态数 ```shell curl -G 'http://api.bilibili.com/x/space/navnum' \ @@ -260,7 +260,7 @@ curl -G 'http://api.bilibili.com/x/space/navnum' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ----------- | ------ | ---- | -| uid | num | 目标用户UID | 必要 | | +| uid | num | 目标用户mid | 必要 | | **json回复：** @@ -284,7 +284,7 @@ curl -G 'http://api.bilibili.com/x/space/navnum' \ **示例：** - 查询用户`UID=53456`的投稿相簿数 + 查询用户`mid=53456`的投稿相簿数 ```shell curl -G 'http://api.vc.bilibili.com/link_draw/v1/doc/upload_count' \ diff --git a/video/attribute_data.md b/video/attribute_data.md new file mode 100644 index 0000000..032868e --- /dev/null +++ b/video/attribute_data.md @@ -0,0 +1,71 @@ +# 视频属性数据说明 + +（PS：以下部分内容来源不明，且部分值前端不可见，有待验证） + +- [attribute字段值(视频属性位)](#attribute字段值(视频属性位)) +- [state字段值(稿件状态)](#state字段值(稿件状态)) + +## attribute字段值(稿件属性位) + +该字段为二进制标志位，多个标志请用`AND`运算叠加 + +| 位 | 内容 | 备注 | +| ---- | ---------------------- | ------------------------------------------------------------ | +| 0 | 禁止排行 | | +| 1 | 动态禁止 | 禁止APP推送动态 | +| 2 | 禁止网页输出 | | +| 3 | 禁止客户端列表 | | +| 4 | 搜索禁止 | 打全标题或av/bv号都搜索不到的那种 | +| 5 | 海外禁止 | | +| 6 | 禁止推荐 | 禁止被APP端天马列表推荐 | +| 7 | 是否显示“禁止转载“标志 | **注：未经作者授权 禁止转载** | +| 8 | 是否高清 | 视频清晰度>=1080P | +| 9 | 是否PGC稿件 | 番剧&影视 | +| 10 | 允许承包 | | +| 11 | 是否番剧 | | +| 12 | 是否私单 | 存在商业推广恰饭内容 | +| 13 | 是否限制地区 | 大多数番剧&影视 | +| 14 | 禁止其他人添加TAG | | +| 15 | ？ | 大多数旧视频会有这个标志 | +| 16 | 跳转 | 番剧及影视av/bv->ep跳转 | +| 17 | 是否影视 | | +| 18 | 是否付费 | | +| 19 | 推送动态 | | +| 20 | 家长模式 | | +| 21 | 是否限制游客和外链 | 分为两种情况，默认全部网页限制referer跳转，但第二种未登录无法访问，可以通过未登陆b站访问http://api.bilibili.com/x/web-interface/view 返回的code为-403来判断 | +| 22 | ？ | | +| 23 | ？ | | +| 24 | 是否为联合投稿 | | +| 25 | ？ | | +| 26 | ？ | | +| 27 | ？ | | +| 28 | ？ | | +| 29 | 是否为互动视频 | | + +## state字段值(稿件状态) + +| 值 | 内容 | 备注 | +| ---- | ------------ | ---------- | +| 1 | 橙色通过 | | +| 0 | 开放浏览 | | +| -1 | 待审 | | +| -2 | 被打回 | | +| -3 | 网警锁定 | | +| -4 | 被锁定 | 视频撞车了 | +| -5 | 管理员锁定 | | +| -6 | 修复待审 | | +| -7 | 暂缓审核 | | +| -8 | 补档待审 | | +| -9 | 等待转码 | | +| -10 | 延迟审核 | | +| -11 | 视频源待修 | | +| -12 | 转储失败 | | +| -13 | 允许评论待审 | | +| -14 | 临时回收站 | | +| -15 | 分发中 | | +| -16 | 转码失败 | | +| -20 | 创建未提交 | | +| -30 | 创建已提交 | | +| -40 | 定时发布 | | +| -100 | 用户删除 | | + diff --git a/video/info.md b/video/info.md index e55c42b..d7890b9 100644 --- a/video/info.md +++ b/video/info.md @@ -2,28 +2,28 @@ -- [获取视频详细信息（web端）](#获取视频详细信息（web端）) +- [获取视频详细信息(web端)](#获取视频详细信息(web端)) - [获取视频简介](#获取视频简介) -- [查询视频分P列表 (avID/bvID转CID)](#查询视频分P列表 (avID/bvID转CID)) +- [查询视频分P列表 (avid/bvid转cid)](#查询视频分P列表 (avid/bvid转cid)) --- -## 获取视频详细信息（web端） +## 获取视频详细信息(web端) > http://api.bilibili.com/x/web-interface/view *请求方式：GET* -认证方式：Cookie（SESSDATA） +认证方式：Cookie(SESSDATA) 限制游客访问的视频需要登录 **url参数：** -| 参数名 | 类型 | 内容 | 必要性 | 备注 | -| ------ | ---- | -------- | ------------ | ------------------ | -| aid | num | 稿件avID | 必要（可选） | avID与bvID任选一个 | -| bvid | str | 稿件bvID | 必要（可选） | avID与bvID任选一个 | +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| ------ | ---- | -------- | ---------- | ------------------ | +| aid | num | 稿件avid | 必要(可选) | avid与bvid任选一个 | +| bvid | str | 稿件bvid | 必要(可选) | avid与bvid任选一个 | **json回复：** @@ -38,102 +38,51 @@ `data`对象： -| 字段 | 类型 | 内容 | 备注 | -| ------------------------------- | ------- | ------------------------------ | ------------------------------------------------------------ | -| bvid | str | 稿件bvID | | -| aid | num | 稿件avID | | -| videos | num | 稿件分P总数 | 默认为1 | -| tid | num | 分区tID | | -| tname | str | 子分区名称 | | -| copyright | num | 视频类型 | 1：原创
2：转载 | -| pic | str | 稿件封面图片url | | -| title | str | 稿件标题 | | -| pubdate | num | 稿件发布时间 | 时间戳 | -| ctime | num | 用户投稿时间 | 时间戳 | -| desc | str | 视频简介 | | -| state | num | 视频状态 | **详情见下表** | -| ~~attribute~~（已经弃用） | ~~num~~ | ~~稿件属性位配置~~ | **详情见下表**| -| duration | num | 稿件总时长（所有分P） | 单位为秒 | -| forward | num | 撞车视频跳转avid | 仅撞车视频存在此字段 | -| mission_id | num | 稿件参与的活动ID | | -| redirect_url | str | 重定向url | 仅番剧或影视视频存在此字段
用于番剧&影视的av/bv->ep | -| rights | obj | 视频属性标志 | | -| owner | obj | 视频UP主信息 | | -| stat | obj | 视频状态数 | | -| dynamic | str | 视频同步发布的的动态的文字内容 | | -| cid | num | 视频1P CID | | -| dimension | obj | 视频1P分辨率 | | -| no_cache | bool | true | 作用尚不明确 | -| pages | array | 视频分P列表 | | -| subtitle | obj | 视频CC字幕信息 | | -| staff | array | 合作成员列表 | 非合作视频无此项 | -| user_garb | obj | 用户装扮信息 | | +| 字段 | 类型 | 内容 | 备注 | +| ----------------------- | ------- | ------------------------------ | ------------------------------------------------------------ | +| bvid | str | 稿件bvid | | +| aid | num | 稿件avid | | +| videos | num | 稿件分P总数 | 默认为1 | +| tid | num | 分区tid | | +| tname | str | 子分区名称 | | +| copyright | num | 视频类型 | 1：原创
2：转载 | +| pic | str | 稿件封面图片url | | +| title | str | 稿件标题 | | +| pubdate | num | 稿件发布时间 | 时间戳 | +| ctime | num | 用户投稿时间 | 时间戳 | +| desc | str | 视频简介 | | +| desc_v2 | array | 新版视频简介 | | +| state | num | 视频状态 | 详情见[属性数据文档](attribute_data.md#attribute字段值(稿件属性位)) | +| ~~attribute~~(已经弃用) | ~~num~~ | ~~稿件属性位配置~~ | 详情见[属性数据文档](attribute_data.md#state字段值(稿件状态)) | +| duration | num | 稿件总时长(所有分P) | 单位为秒 | +| forward | num | 撞车视频跳转avid | 仅撞车视频存在此字段 | +| mission_id | num | 稿件参与的活动id | | +| redirect_url | str | 重定向url | 仅番剧或影视视频存在此字段
用于番剧&影视的av/bv->ep | +| rights | obj | 视频属性标志 | | +| owner | obj | 视频UP主信息 | | +| stat | obj | 视频状态数 | | +| dynamic | str | 视频同步发布的的动态的文字内容 | | +| cid | num | 视频1P cid | | +| dimension | obj | 视频1P分辨率 | | +| no_cache | bool | true | 作用尚不明确 | +| pages | array | 视频分P列表 | | +| subtitle | obj | 视频CC字幕信息 | | +| staff | array | 合作成员列表 | 非合作视频无此项 | +| user_garb | obj | 用户装扮信息 | | -`attribute`字段属性位二进制值表： +`data`中的`desc_v2`数组： - （PS：以下部分内容来源不明，有待验证，下表只做历史保留，无实际作用） +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | ------------ | ---- | +| 0 | obj | 新版简介内容 | | - | 位 | 内容 | 备注 | - | ---- | ---------------------- | --------------------------------------------- | - | 0 | 禁止排行 | | - | 1 | 动态禁止 | 禁止APP推送动态 | - | 2 | 禁止网页输出 | | - | 3 | 禁止客户端列表 | | - | 4 | 搜索禁止 | 打全标题或av/bv号都搜索不到的那种 | - | 5 | 海外禁止 | | - | 6 | 禁止推荐 | 禁止被APP端天马列表推荐 | - | 7 | 是否显示“禁止转载“标志 | **注：未经作者授权 禁止转载** | - | 8 | 是否高清 | 视频清晰度>=1080P | - | 9 | 是否PGC稿件 | 番剧&影视 | - | 10 | 允许承包 | | - | 11 | 是否番剧 | | - | 12 | 是否私单 | 存在商业推广恰饭内容 | - | 13 | 是否限制地区 | 大多数番剧&影视 | - | 14 | 禁止其他人添加TAG | | - | 15 | ？ | | - | 16 | 跳转 | 番剧及影视av/bv->ep跳转 | - | 17 | 是否影视 | | - | 18 | 是否付费 | | - | 19 | 推送动态 | | - | 20 | 家长模式 | | - | 21 | 是否限制游客和外链 | 分为两种情况，默认全部网页限制referer跳转，但第二种未登录无法访问，可以通过未登陆b站访问http://api.bilibili.com/x/web-interface/view 返回的code为-403来判断 | - | 22 | ？ | | - | 23 | ？ | | - | 24 | 是否为联合投稿 | | - | 25 | ？ | | - | 26 | ？ | | - | 27 | ？ | | - | 28 | ？ | | - | 29 | 是否为互动视频 | | +`desc_v2`数组中的对象： -`state`字段值： - -（PS：以下部分内容来源不明，且部分值前端不可见，有待验证） - -| 值 | 内容 | 备注 | -| ---- | ------------ | ---------- | -| 1 | 橙色通过 | | -| 0 | 开放浏览 | | -| -1 | 待审 | | -| -2 | 被打回 | | -| -3 | 网警锁定 | | -| -4 | 被锁定 | 视频撞车了 | -| -5 | 管理员锁定 | | -| -6 | 修复待审 | | -| -7 | 暂缓审核 | | -| -8 | 补档待审 | | -| -9 | 等待转码 | | -| -10 | 延迟审核 | | -| -11 | 视频源待修 | | -| -12 | 转储失败 | | -| -13 | 允许评论待审 | | -| -14 | 临时回收站 | | -| -15 | 分发中 | | -| -16 | 转码失败 | | -| -20 | 创建未提交 | | -| -30 | 创建已提交 | | -| -40 | 定时发布 | | -| -100 | 用户删除 | | +| 字段 | 类型 | 内容 | 备注 | +| -------- | ---- | -------- | ---- | +| raw_text | num | 简介内容 | | +| type | num | ? | | +| biz_id | num | ? | | `data`中的`rights`对象： @@ -157,7 +106,7 @@ | 字段 | 类型 | 内容 | 备注 | | ---- | ---- | -------- | ---- | -| mid | num | UP主UID | | +| mid | num | UP主mid | | | name | str | UP主昵称 | | | face | str | UP主头像 | | @@ -165,7 +114,7 @@ | 字段 | 类型 | 内容 | 备注 | | ---------- | ---- | ------------ | ------- | -| aid | num | 稿件avID | | +| aid | num | 稿件avid | | | view | num | 播放数 | | | danmaku | num | 弹幕数 | | | reply | num | 评论数 | | @@ -191,7 +140,7 @@ | 字段 | 类型 | 内容 | 备注 | | --------- | ---- | --------------- | --------------------------------------------------------- | -| cid | num | 当前分P CID | | +| cid | num | 当前分P cid | | | page | num | 当前分P | | | from | str | 视频来源 | vupload：普通上传（B站）
hunan：芒果TV
qq：腾讯 | | part | str | 当前分P标题 | | @@ -227,11 +176,11 @@ | 字段 | 类型 | 内容 | 备注 | | ------------ | ---- | ------------------- | ---- | -| id | num | 字幕ID | | +| id | num | 字幕id | | | lan | str | 字幕语言 | | | lan_doc | str | 字幕语言名称 | | | is_lock | bool | 是否锁定 | | -| author_mid | num | 字幕上传者UID | | +| author_mid | num | 字幕上传者mid | | | subtitle_url | str | json格式字幕文件url | | | author | obj | 字幕上传者信息 | | @@ -239,7 +188,7 @@ | 字段 | 类型 | 内容 | 备注 | | --------------- | ---- | ----------------- | ------------ | -| mid | num | 字幕上传者UID | | +| mid | num | 字幕上传者mid | | | name | str | 字幕上传者昵称 | | | sex | str | 字幕上传者性别 | 男 女 保密 | | face | str | 字幕上传者头像url | | @@ -261,7 +210,7 @@ | 字段 | 类型 | 内容 | 备注 | | -------- | ---- | -------------- | ---- | -| mid | num | 成员UID | | +| mid | num | 成员mid | | | title | str | 成员名称 | | | name | str | 成员昵称 | | | face | str | 成员头像url | | @@ -288,8 +237,6 @@ `data`中的`user_garb`对象： - - | 字段 | 类型 | 内容 | 备注 | | ----------------- | ---- | ------- | ---- | | url_image_ani_cut | str | 某url？ | | @@ -298,14 +245,14 @@ 获取视频`av85440373`/`BV117411r7R1`的基本信息 -avID方式： +avid方式： ```shell curl -G 'http://api.bilibili.com/x/web-interface/view' \ --data-urlencode 'aid=85440373' ``` -bvID方式： +bvid方式： ```shell curl -G 'http://api.bilibili.com/x/web-interface/view' \ @@ -332,6 +279,13 @@ curl -G 'http://api.bilibili.com/x/web-interface/view' \ "pubdate": 1580377255, "ctime": 1580212263, "desc": "【CB想说的】看完拜年祭之后最爱的一个节目！给有快板的部分简单加了一些不同风格的配乐hhh，感谢沃玛画的我！太可爱了哈哈哈哈哈哈哈！！！\n【Warma想说的】我画了打碟的CB，画风为了还原原版视频所以参考了四迹老师的画风，四迹老师的画真的太可爱啦！不过其实在画的过程中我遇到了一个问题，CB的耳机……到底是戴在哪个耳朵上呢？\n\n原版：av78977080\n编曲（配乐）：Crazy Bucket\n人声（配音）：Warma/谢拉\n曲绘：四迹/Warma\n动画：四迹/Crazy Bucket\n剧本：Mokurei-木灵君\n音频后期：DMYoung/纳兰寻风/Crazy Bucket\n包装：破晓天", + "desc_v2": [ + { + "raw_text": "【CB想说的】看完拜年祭之后最爱的一个节目！给有快板的部分简单加了一些不同风格的配乐hhh，感谢沃玛画的我！太可爱了哈哈哈哈哈哈哈！！！\n【Warma想说的】我画了打碟的CB，画风为了还原原版视频所以参考了四迹老师的画风，四迹老师的画真的太可爱啦！不过其实在画的过程中我遇到了一个问题，CB的耳机……到底是戴在哪个耳朵上呢？\n\n原版：av78977080\n编曲（配乐）：Crazy Bucket\n人声（配音）：Warma/谢拉\n曲绘：四迹/Warma\n动画：四迹/Crazy Bucket\n剧本：Mokurei-木灵君\n音频后期：DMYoung/纳兰寻风/Crazy Bucket\n包装：破晓天", + "type": 1, + "biz_id": 0 + } + ], "state": 0, "duration": 486, "mission_id": 11838, @@ -358,15 +312,15 @@ curl -G 'http://api.bilibili.com/x/web-interface/view' \ }, "stat": { "aid": 85440373, - "view": 1936852, - "danmaku": 11189, - "reply": 2626, - "favorite": 56572, - "coin": 66857, - "share": 9032, + "view": 2087084, + "danmaku": 11495, + "reply": 2669, + "favorite": 58113, + "coin": 68710, + "share": 9190, "now_rank": 0, "his_rank": 55, - "like": 142449, + "like": 148621, "dislike": 0, "evaluation": "", "argue_msg": "" @@ -408,8 +362,22 @@ curl -G 'http://api.bilibili.com/x/web-interface/view' \ "vip": { "type": 2, "status": 1, - "vip_pay_type": 0, - "theme_type": 0 + "due_date": 1642694400000, + "vip_pay_type": 1, + "theme_type": 0, + "label": { + "path": "", + "text": "年度大会员", + "label_theme": "annual_vip", + "text_color": "#FFFFFF", + "bg_style": 1, + "bg_color": "#FB7299", + "border_color": "" + }, + "avatar_subscript": 1, + "nickname_color": "#FB7299", + "role": 3, + "avatar_subscript_url": "http://i0.hdslb.com/bfs/vip/icon_Certification_big_member_22_3x.png" }, "official": { "role": 2, @@ -417,7 +385,7 @@ curl -G 'http://api.bilibili.com/x/web-interface/view' \ "desc": "", "type": 0 }, - "follower": 628808, + "follower": 662460, "label_style": 0 }, { @@ -428,8 +396,22 @@ curl -G 'http://api.bilibili.com/x/web-interface/view' \ "vip": { "type": 2, "status": 1, + "due_date": 1637424000000, "vip_pay_type": 0, - "theme_type": 0 + "theme_type": 0, + "label": { + "path": "", + "text": "年度大会员", + "label_theme": "annual_vip", + "text_color": "#FFFFFF", + "bg_style": 1, + "bg_color": "#FB7299", + "border_color": "" + }, + "avatar_subscript": 1, + "nickname_color": "#FB7299", + "role": 3, + "avatar_subscript_url": "http://i0.hdslb.com/bfs/vip/icon_Certification_big_member_22_3x.png" }, "official": { "role": 1, @@ -437,7 +419,7 @@ curl -G 'http://api.bilibili.com/x/web-interface/view' \ "desc": "", "type": 0 }, - "follower": 2268492, + "follower": 2655737, "label_style": 0 } ], @@ -452,7 +434,7 @@ curl -G 'http://api.bilibili.com/x/web-interface/view' \ 视频标题为：`当我给拜年祭的快板加了电音配乐…` -视频分区为：`tid=28（音乐->原创音乐）` +视频分区为：`tid=28(音乐->原创音乐)` 视频时长：`486s` @@ -462,15 +444,15 @@ curl -G 'http://api.bilibili.com/x/web-interface/view' \ 视频分P为：`1` -视频类型为：`1（原创）` +视频类型为：`1(原创)` -视频UP主为：`66606350（Crazy_Bucket）` +视频UP主为：`66606350(Crazy_Bucket)` 视频简介为： -`【CB想说的】看完拜年祭之后最爱的一个节目！给有快板的部分简单加了一些不同风格的配乐hhh，感谢沃玛画的我！太可爱了哈哈哈哈哈哈哈！！！\n【Warma想说的】我画了打碟的CB，画风为了还原原版视频所以参考了四迹老师的画风，四迹老师的画真的太可爱啦！不过其实在画的过程中我遇到了一个问题，CB的耳机……到底是戴在哪个耳朵上呢？\n\n原版：av78977080\n编曲（配乐）：Crazy Bucket\n人声（配音）：Warma/谢拉\n曲绘：四迹/Warma\n动画：四迹/Crazy Bucket\n剧本：Mokurei-木灵君\n音频后期：DMYoung/纳兰寻风/Crazy Bucket\n包装：破晓天` +`【CB想说的】看完拜年祭之后最爱的一个节目！给有快板的部分简单加了一些不同风格的配乐hhh，感谢沃玛画的我！太可爱了哈哈哈哈哈哈哈！！！\n【Warma想说的】我画了打碟的CB，画风为了还原原版视频所以参考了四迹老师的画风，四迹老师的画真的太可爱啦！不过其实在画的过程中我遇到了一个问题，CB的耳机……到底是戴在哪个耳朵上呢？\n\n原版：av78977080\n编曲(配乐)：Crazy Bucket\n人声(配音)：Warma/谢拉\n曲绘：四迹/Warma\n动画：四迹/Crazy Bucket\n剧本：Mokurei-木灵君\n音频后期：DMYoung/纳兰寻风/Crazy Bucket\n包装：破晓天` -视频状态为：`0（开放浏览）` +视频状态为：`0(开放浏览)` 视频属性为： `显示“禁止转载“标志`、`高清`、`禁止其他人添加TAG`、`联合投稿视频` @@ -492,8 +474,8 @@ http://i1.hdslb.com/bfs/archive/ea0dd34bf41e23a68175680a00e3358cd249105f.jpg | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | -------- | ------------ | ------------------ | -| aid | num | 稿件avID | 必要（可选） | avID与bvID任选一个 | -| bvid | str | 稿件bvID | 必要（可选） | avID与bvID任选一个 | +| aid | num | 稿件avid | 必要（可选） | avid与bvid任选一个 | +| bvid | str | 稿件bvid | 必要（可选） | avid与bvid任选一个 | **json回复：** @@ -508,16 +490,16 @@ http://i1.hdslb.com/bfs/archive/ea0dd34bf41e23a68175680a00e3358cd249105f.jpg **示例：** -查看视频（教主的咕鸽）`av39330059`/`BV1Bt411z799`的简介 +查看视频(教主的咕鸽)`av39330059`/`BV1Bt411z799`的简介 -avID方式： +avid方式： ```shell curl -G 'http://api.bilibili.com/x/archive/desc' \ --data-urlencode 'aid=39330059' ``` -bvID方式： +bvid方式： ```shell curl -G 'http://api.bilibili.com/x/archive/desc' \ @@ -538,7 +520,7 @@ curl -G 'http://api.bilibili.com/x/archive/desc' \ -## 查询视频分P列表 (avID/bvID转CID) +## 查询视频分P列表 (avid/bvid转cid) > http://api.bilibili.com/x/player/pagelist @@ -548,8 +530,8 @@ curl -G 'http://api.bilibili.com/x/archive/desc' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | -------- | ------------ | ------------------ | -| aid | num | 稿件avID | 必要（可选） | avID与bvID任选一个 | -| bvid | str | 稿件bvID | 必要（可选） | avID与bvID任选一个 | +| aid | num | 稿件avid | 必要（可选） | avid与bvid任选一个 | +| bvid | str | 稿件bvid | 必要（可选） | avid与bvid任选一个 | **json回复：** @@ -574,7 +556,7 @@ curl -G 'http://api.bilibili.com/x/archive/desc' \ | 字段 | 类型 | 内容 | 备注 | | --------- | ---- | --------------- | --------------------------------------------------------- | -| cid | num | 当前分P CID | | +| cid | num | 当前分P cid | | | page | num | 当前分P | | | from | str | 视频来源 | vupload：普通上传（B站）
hunan：芒果TV
qq：腾讯 | | part | str | 当前分P标题 | | @@ -595,14 +577,14 @@ curl -G 'http://api.bilibili.com/x/archive/desc' \ 查询视频`av13502509`/`BV1ex411J7GE`的分P列表 -avID方式： +avid方式： ```shell curl -G 'http://api.bilibili.com/x/player/pagelist' \ --data-urlencode 'aid=13502509' ``` -bvID方式： +bvid方式： ```shell curl -G 'http://api.bilibili.com/x/player/pagelist' \ @@ -677,4 +659,3 @@ curl -G 'http://api.bilibili.com/x/player/pagelist' \ - diff --git a/video/interact_video.md b/video/interact_video.md index b362521..1d0a956 100644 --- a/video/interact_video.md +++ b/video/interact_video.md @@ -20,9 +20,9 @@ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------------- | ---- | -------- | ------------ | ------------------ | -| aid | num | 稿件avID | 必要（可选） | avID与bvID任选一个 | -| bvid | str | 稿件bvID | 必要（可选） | avID与bvID任选一个 | -| graph_version | num | 剧情图ID | 必要 | 位于`player.so`中 | +| aid | num | 稿件avid | 必要（可选） | avid与bvid任选一个 | +| bvid | str | 稿件bvid | 必要（可选） | avid与bvid任选一个 | +| graph_version | num | 剧情图id | 必要 | 位于`player.so`中 | | edge_id | num | 模块编号 | 非必要 | 0或留空为起始模块 | **json回复：** @@ -41,7 +41,7 @@ | 字段 | 类型 | 内容 | 备注 | | --------------- | ----- | ------------------- | ------------------------------------------------ | | title | str | 视频模块（分P）标题 | | -| edge_id | num | 当前模块ID | | +| edge_id | num | 当前模块id | | | story_list | array | 进度回溯信息 | 未登录仅有起始模块 | | edges | obj | 当前模块信息 | | | preload | obj | 预加载的分P | | @@ -66,7 +66,7 @@ | node_id | num | 模块编号 | | | edge_id | num | **同上** | | | title | str | 模块（分P）标题 | | -| cid | num | 模块（分P）CID | | +| cid | num | 模块（分P）cid | | | start_pos | num | 记录播放开始位置 | 单位为毫秒 | | cover | str | 分P封面url | | | is_current | num | 是否为当前模块 | 1：是
仅为当前模块时存在 | @@ -121,11 +121,11 @@ | 字段 | 类型 | 内容 | 备注 | | --------------- | ---- | -------------------- | ------------------------------------- | -| id | num | 选项所跳转的模块ID | | -| platform_action | str | 跳转信息文字 | JUMP+{所跳转的模块编号}+{所跳转的CID} | +| id | num | 选项所跳转的模块id | | +| platform_action | str | 跳转信息文字 | JUMP+{所跳转的模块编号}+{所跳转的cid} | | native_action | str | 点击后对变量运算语句 | 每项间用分号隔开
无为空 | | condition | str | 选项出现条件判断语句 | 无为空 | -| cid | num | 选项所跳转分P的CID | | +| cid | num | 选项所跳转分P的cid | | | x | num | 选项出现的x坐标 | 仅坐标模式有此项 | | y | num | 选项出现的y坐标 | 仅坐标模式有此项 | | text_align | num | 选项文本对齐方式 | | @@ -166,8 +166,8 @@ | 字段 | 类型 | 内容 | 备注 | | ---- | ---- | -------- | ---- | -| aid | num | 稿件avID | | -| cid | num | 分P CID | | +| aid | num | 稿件avid | | +| cid | num | 分P cid | | `data`中的`hidden_vars`数组： @@ -193,7 +193,7 @@ 查询互动视频`av73267982`下剧情图`155446`模块`5556092`的信息 -avID方式： +avid方式： ```shell curl -G 'http://api.bilibili.com/x/stein/edgeinfo_v2' \ @@ -203,7 +203,7 @@ curl -G 'http://api.bilibili.com/x/stein/edgeinfo_v2' \ -b 'SESSDATA=xxx' ``` -bvID方式： +bvid方式： ```shell curl -G 'http://api.bilibili.com/x/stein/edgeinfo_v2' \ diff --git a/video/like_coin_fav.md b/video/like_coin_fav.md index cccaa7f..810a26b 100644 --- a/video/like_coin_fav.md +++ b/video/like_coin_fav.md @@ -35,8 +35,8 @@ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ------------------------ | ------------ | ---------------------- | -| aid | num | 稿件avID | 必要（可选） | avID与bvID任选一个 | -| bvid | str | 稿件bvID | 必要（可选） | avID与bvID任选一个 | +| aid | num | 稿件avid | 必要（可选） | avid与bvid任选一个 | +| bvid | str | 稿件bvid | 必要（可选） | avid与bvid任选一个 | | like | num | 操作方式 | 必要 | 1：点赞
2：取消赞 | | csrf | str | CSRF Token（位于cookie） | 必要 | | @@ -54,7 +54,7 @@ 点赞视频`av79677524`/`BV1uJ411r7hL` -avID方式： +avid方式： ```shell curl 'http://api.bilibili.com/x/web-interface/archive/like' \ @@ -64,7 +64,7 @@ curl 'http://api.bilibili.com/x/web-interface/archive/like' \ -b 'SESSDATA=xxx' ``` -bvID方式： +bvid方式： ```shell curl 'http://api.bilibili.com/x/web-interface/archive/like' \ @@ -100,7 +100,7 @@ curl 'http://api.bilibili.com/x/web-interface/archive/like' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ---------- | ---- | ------------ | ----------- | ---------------------- | | access_key | str | APP登录Token | APP方式必要 | | -| aid | num | 稿件avID | 必要 | | +| aid | num | 稿件avid | 必要 | | | like | num | 操作方式 | 必要 | 0：点赞
1：取消赞 | **json回复：** @@ -160,8 +160,8 @@ curl 'http://app.bilibili.com/x/v2/view/like' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ---------- | ---- | ------------ | ------------ | ------------------ | | access_key | str | APP登录Token | APP方式必要 | | -| aid | num | 稿件avID | 必要（可选） | avID与bvID任选一个 | -| bvid | str | 稿件bvID | 必要（可选） | avID与bvID任选一个 | +| aid | num | 稿件avid | 必要（可选） | avid与bvid任选一个 | +| bvid | str | 稿件bvid | 必要（可选） | avid与bvid任选一个 | **json回复：** @@ -178,7 +178,7 @@ curl 'http://app.bilibili.com/x/v2/view/like' \ 视频`av39330059`/`BV1Bt411z799`的状态为已点赞 -avID方式： +avid方式： ```shell curl -G 'http://api.bilibili.com/x/web-interface/archive/has/like' \ @@ -186,7 +186,7 @@ curl -G 'http://api.bilibili.com/x/web-interface/archive/has/like' \ -b 'SESSDATA=xxx' ``` -bvID方式： +bvid方式： ```shell curl -G 'api.bilibili.com/x/web-interface/archive/has/like' \ @@ -225,8 +225,8 @@ curl -G 'api.bilibili.com/x/web-interface/archive/has/like' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ----------- | ---- | ------------------------ | ------------ | --------------------------------------- | -| aid | num | 稿件avID | 必要（可选） | avID与bvID任选一个 | -| bvid | str | 稿件bvID | 必要（可选） | avID与bvID任选一个 | +| aid | num | 稿件avid | 必要（可选） | avid与bvid任选一个 | +| bvid | str | 稿件bvid | 必要（可选） | avid与bvid任选一个 | | multiply | num | 投币数量 | 必要 | 上限为2 | | select_like | num | 是否附加点赞 | 非必要 | 0：不点赞
1：同时点赞
默认为0 | | csrf | str | CSRF Token（位于cookie） | 必要 | | @@ -252,7 +252,7 @@ data 对象： 为视频`av90671873`/`BV1N7411A7wC`投币2枚 -avID方式： +avid方式： ```shell curl 'http://api.bilibili.com/x/web-interface/coin/add' \ @@ -263,7 +263,7 @@ curl 'http://api.bilibili.com/x/web-interface/coin/add' \ -b 'SESSDATA=xxx' ``` -bvID方式： +bvid方式： ```shell curl 'http://api.bilibili.com/x/web-interface/coin/add' \ @@ -303,7 +303,7 @@ curl 'http://api.bilibili.com/x/web-interface/coin/add' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ----------- | ---- | ------------ | ----------- | --------------------------------------- | | access_key | str | APP登录Token | APP方式必要 | | -| aid | num | 稿件avID | 必要 | | +| aid | num | 稿件avid | 必要 | | | multiply | num | 投币数量 | 必要 | 上限为2 | | select_like | num | 附加点赞 | 非必要 | 0：不点赞
1：同时点赞
默认为0 | @@ -363,8 +363,8 @@ curl 'http://app.bilibili.com/x/v2/view/coin/add' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ---------- | ---- | ------------ | ------------ | ------------------ | | access_key | str | APP登录Token | APP方式必要 | | -| aid | num | 稿件avID | 必要（可选） | avID与bvID任选一个 | -| bvid | str | 稿件bvID | 必要（可选） | avID与bvID任选一个 | +| aid | num | 稿件avid | 必要（可选） | avid与bvid任选一个 | +| bvid | str | 稿件bvid | 必要（可选） | avid与bvid任选一个 | **json回复：** @@ -387,7 +387,7 @@ curl 'http://app.bilibili.com/x/v2/view/coin/add' \ 视频`av37896701`/`BV18t411q7zz`的投币数为2枚 -avID方式： +avid方式： ```shell curl -G 'api.bilibili.com/x/web-interface/archive/coins' \ @@ -395,7 +395,7 @@ curl -G 'api.bilibili.com/x/web-interface/archive/coins' \ -b 'SESSDATA=xxx' ``` -bvID方式： +bvid方式： ```shell curl -G 'api.bilibili.com/x/web-interface/archive/coins' \ @@ -440,10 +440,10 @@ curl -G 'api.bilibili.com/x/web-interface/archive/coins' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------------- | ---- | ------------------------ | -------------- | ------------------------------ | | access_key | str | APP登录Token | APP方式必要 | | -| rid | num | 稿件avID | 必要 | | +| rid | num | 稿件avid | 必要 | | | type | num | 必须为2 | 必要 | | -| add_media_ids | nums | 需要加入的收藏夹ID | 非必要 | 同时添加多个，用`,`（%2C）分隔 | -| del_media_ids | nums | 需要取消的收藏夹ID | 非必要 | 同时取消多个，用`,`（%2C）分隔 | +| add_media_ids | nums | 需要加入的收藏夹mlid | 非必要 | 同时添加多个，用`,`（%2C）分隔 | +| del_media_ids | nums | 需要取消的收藏夹mlid | 非必要 | 同时取消多个，用`,`（%2C）分隔 | | csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | | **json回复：** @@ -518,7 +518,7 @@ curl 'http://api.bilibili.com/medialist/gateway/coll/resource/deal' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ---------- | -------- | ------------------ | ----------- | ---- | | access_key | str | APP登录Token | APP方式必要 | | -| aid | num或str | 稿件avID或稿件bvID | 必要 | | +| aid | num或str | 稿件avid或稿件bvid | 必要 | | **json回复：** @@ -542,7 +542,7 @@ data 对象： 视频`av46281123`/`BV1Bb411H7Dv`的状态为已收藏 -avID方式： +avid方式： ```shell curl -G 'http://api.bilibili.com/x/v2/fav/video/favoured' \ @@ -550,7 +550,7 @@ curl -G 'http://api.bilibili.com/x/v2/fav/video/favoured' \ -b 'SESSDATA=xxx' ``` -bvID方式： +bvid方式： ```shell curl -G 'http://api.bilibili.com/x/v2/fav/video/favoured' \ @@ -593,8 +593,8 @@ curl -G 'http://api.bilibili.com/x/v2/fav/video/favoured' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ------------------------ | ------------ | ------------------ | -| aid | num | 稿件avID | 必要（可选） | avID与bvID任选一个 | -| bvid | str | 稿件bvID | 必要（可选） | avID与bvID任选一个 | +| aid | num | 稿件avid | 必要（可选） | avid与bvid任选一个 | +| bvid | str | 稿件bvid | 必要（可选） | avid与bvid任选一个 | | csrf | str | CSRF Token（位于cookie） | 必要 | | **json回复：** @@ -621,7 +621,7 @@ curl -G 'http://api.bilibili.com/x/v2/fav/video/favoured' \ 将视频`av91003840`/`BV1Wj411f79U`一键三连 -avID方式： +avid方式： ```shell curl 'http://api.bilibili.com/x/web-interface/archive/like/triple' \ @@ -630,7 +630,7 @@ curl 'http://api.bilibili.com/x/web-interface/archive/like/triple' \ -b 'SESSDATA=xxx' ``` -bvID方式： +bvid方式： ```shell curl 'http://api.bilibili.com/x/web-interface/archive/like/triple' \ @@ -673,7 +673,7 @@ curl 'http://api.bilibili.com/x/web-interface/archive/like/triple' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ---------- | ---- | ------------ | ----------- | ---- | | access_key | str | APP登录Token | APP方式必要 | | -| aid | num | 稿件avID | 必要 | | +| aid | num | 稿件avid | 必要 | | **json回复：** @@ -738,8 +738,8 @@ curl 'http://app.bilibili.com/x/v2/view/like/triple' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ------------------------ | ------------ | ------------------ | -| aid | num | 稿件avID | 必要（可选） | avID与bvID任选一个 | -| bvid | str | 稿件bvID | 必要（可选） | avID与bvID任选一个 | +| aid | num | 稿件avid | 必要（可选） | avid与bvid任选一个 | +| bvid | str | 稿件bvid | 必要（可选） | avid与bvid任选一个 | | csrf | str | CSRF Token（位于cookie） | 必要 | | **json回复：** diff --git a/video/pbp.md b/video/pbp.md index 140c612..b2cab6d 100644 --- a/video/pbp.md +++ b/video/pbp.md @@ -20,9 +20,9 @@ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | -------- | ------ | ---- | -| cid | num | 视频CID | 必要 | | -| aid | num | 稿件avID | 非必要 | | -| bvid | num | 稿件bvID | 非必要 | | +| cid | num | 视频cid | 必要 | | +| aid | num | 稿件avid | 非必要 | | +| bvid | num | 稿件bvid | 非必要 | | **json回复：** @@ -51,7 +51,7 @@ **示例：** -获取视频`CID=3724723`的获取弹幕趋势顶点列表 +获取视频`cid=3724723`的获取弹幕趋势顶点列表 ```shell curl -G 'http://api.bilibili.com/pbp/data' \ diff --git a/video/recommend.md b/video/recommend.md index 6709145..79ea44a 100644 --- a/video/recommend.md +++ b/video/recommend.md @@ -16,8 +16,8 @@ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | -------- | ------------ | ------------------ | -| aid | num | 稿件avID | 必要（可选） | avID与bvID任选一个 | -| bvid | str | 稿件bvID | 必要（可选） | avID与bvID任选一个 | +| aid | num | 稿件avid | 必要（可选） | avid与bvid任选一个 | +| bvid | str | 稿件bvid | 必要（可选） | avid与bvid任选一个 | **json回复：** @@ -47,14 +47,14 @@ 查询视频`av7`/`BV1xx411c7m9`的推荐视频列表 -avID方式： +avid方式： ```shell curl -G 'http://api.bilibili.com/x/web-interface/archive/related' \ --data-urlencode 'aid=7' ``` -bvID方式： +bvid方式： ```shell curl -G 'http://api.bilibili.com/x/web-interface/archive/related' \ diff --git a/video/report.md b/video/report.md index ce26072..3341644 100644 --- a/video/report.md +++ b/video/report.md @@ -18,8 +18,8 @@ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ---------- | ---- | ------------------------ | -------------- | --------------------- | | access_key | str | APP登录Token | APP方式必要 | | -| aid | num | 稿件avID | 必要 | | -| cid | num | 视频CID | 必要 | 用于识别分P | +| aid | num | 稿件avid | 必要 | | +| cid | num | 视频cid | 必要 | 用于识别分P | | progress | num | 观看进度 | 非必要 | 单位为秒
默认为0 | | platform | str | 平台标识 | 非必要 | 可为android | | csrf | str | CSRF Token（位于cookie） | Cookie方式必要 | | @@ -36,7 +36,7 @@ **示例：** -记录视频`av13662970`（`CID=126654047`）的观看记录位于`1248`秒 +记录视频`av13662970`（`cid=126654047`）的观看记录位于`1248`秒 Cookie方式： @@ -91,12 +91,12 @@ curl 'http://api.bilibili.com/x/v2/history/report' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ----------- | ---- | ------------------------ | ------------ | ------------------------------------------------------------ | -| aid | num | 稿件avID | 必要（可选） | avID与bvID任选一个 | -| bvid | str | 稿件bvID | 必要（可选） | avID与bvID任选一个 | -| cid | num | 视频CID | 非必要 | 用于识别分P | -| epid | num | 番剧epID | 非必要 | | -| sid | num | 番剧ssID | 非必要 | | -| mid | num | 当前用户UID | 非必要 | | +| aid | num | 稿件avid | 必要（可选） | avid与bvid任选一个 | +| bvid | str | 稿件bvid | 必要（可选） | avid与bvid任选一个 | +| cid | num | 视频cid | 非必要 | 用于识别分P | +| epid | num | 番剧epid | 非必要 | | +| sid | num | 番剧ssid | 非必要 | | +| mid | num | 当前用户mid | 非必要 | | | played_time | num | 视频播放进度 | 非必要 | 单位为秒
默认为0 | | realtime | num | 总计播放时间 | 非必要 | 单位为秒 | | start_ts | num | 开始播放时刻 | 非必要 | 时间戳 | diff --git a/video/snapshot.md b/video/snapshot.md index d2df9d3..edf74e6 100644 --- a/video/snapshot.md +++ b/video/snapshot.md @@ -25,9 +25,9 @@ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ------------------ | ------------ | ----------------------------------- | -| aid | num | 稿件avID | 必要（可选） | avID与bvID任选一个 | -| bvid | str | 稿件bvID | 必要（可选） | avID与bvID任选一个 | -| cid | num | 分P CID | 非必要 | 默认为1P | +| aid | num | 稿件avid | 必要（可选） | avid与bvid任选一个 | +| bvid | str | 稿件bvid | 必要（可选） | avid与bvid任选一个 | +| cid | num | 分P cid | 非必要 | 默认为1P | | index | num | json数组截取时间表 | 非必要 | 1：需要
0：不需要
默认为0 | **json回复：** @@ -74,7 +74,7 @@ 获取视频`av26273789`/`BV1os411H7wm`的快照 -avID方式： +avid方式： ```shell curl -G 'http://api.bilibili.com/x/player/videoshot' \ @@ -82,7 +82,7 @@ curl -G 'http://api.bilibili.com/x/player/videoshot' \ --data-urlencode 'index=1' ``` -bvID方式： +bvid方式： ```shell curl -G 'http://api.bilibili.com/x/player/videoshot' \ @@ -125,8 +125,8 @@ curl -G 'http://api.bilibili.com/x/player/videoshot' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ---------- | ----------- | ---- | | appkey | str | APP密钥 | APP方式必要 | | -| aid | num | 稿件avID | 必要 | | -| cid | num | 分P CID | 必要 | | +| aid | num | 稿件avid | 必要 | | +| cid | num | 分P cid | 必要 | | | ts | num | 当前时间戳 | APP方式必要 | | | sign | str | APP签名 | APP方式必要 | | @@ -162,7 +162,7 @@ curl -G 'http://api.bilibili.com/x/player/videoshot' \ 示例： -获取视频`av26273789`（`CID=49075258`）的快照 +获取视频`av26273789`（`cid=49075258`）的快照 ```shell curl -G 'http://app.bilibili.com/x/v2/view/video/shot' \ @@ -209,7 +209,7 @@ curl -G 'http://app.bilibili.com/x/v2/view/video/shot' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | -------- | ------ | ---- | -| aid | num | 稿件avID | 必要 | | +| aid | num | 稿件avid | 必要 | | **json回复：** diff --git a/video/status_number.md b/video/status_number.md index e26d69d..821122e 100644 --- a/video/status_number.md +++ b/video/status_number.md @@ -1,11 +1,11 @@ # 视频状态数 -- [视频状态数（仅avID）](#视频状态数（仅avID）) -- [视频状态数（bvID/avID）](#视频状态数（bvID/avID）) +- [视频状态数（仅avid）](#视频状态数（仅avid）) +- [视频状态数（bvid/avid）](#视频状态数（bvid/avid）) --- -## 视频状态数（仅avID） +## 视频状态数（仅avid） > http://api.bilibili.com/archive_stat/stat *请求方式：GET* @@ -14,7 +14,7 @@ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | -------- | ------ | ---- | -| aid | num | 稿件avID | 必要 | | +| aid | num | 稿件avid | 必要 | | **json回复：** @@ -31,7 +31,7 @@ | 字段 | 类型 | 内容 | 备注 | | ---------- | ------------------------ | ------------------------------ | -------------------- | -| aid | num | 稿件avID | | +| aid | num | 稿件avid | | | view | 正常：num
屏蔽：str | 正常：播放次数
屏蔽："--" | | | danmaku | num | 弹幕条数 | | | reply | num | 评论条数 | | @@ -49,7 +49,7 @@ 查询视频`av91572143`的状态数 -avID方式： +avid方式： ```shell curl -G 'http://api.bilibili.com/archive_stat/stat' \ @@ -84,7 +84,7 @@ curl -G 'http://api.bilibili.com/archive_stat/stat' \ -## 视频状态数（bvID/avID） +## 视频状态数（bvid/avid） > http://api.bilibili.com/x/web-interface/archive/stat @@ -96,8 +96,8 @@ curl -G 'http://api.bilibili.com/archive_stat/stat' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | -------- | ------------ | ------------------ | -| aid | num | 稿件avID | 必要（可选） | avID与bvID任选一个 | -| bvid | str | 稿件bvID | 必要（可选） | avID与bvID任选一个 | +| aid | num | 稿件avid | 必要（可选） | avid与bvid任选一个 | +| bvid | str | 稿件bvid | 必要（可选） | avid与bvid任选一个 | **json回复：** @@ -114,8 +114,8 @@ curl -G 'http://api.bilibili.com/archive_stat/stat' \ | 字段 | 类型 | 内容 | 备注 | | ---------- | ------------------------ | ------------------------------ | -------------------- | -| aid | num | 稿件avID | | -| bvid | str | 稿件bvID | | +| aid | num | 稿件avid | | +| bvid | str | 稿件bvid | | | view | 正常：num
屏蔽：str | 正常：播放次数
屏蔽："--" | | | danmaku | num | 弹幕条数 | | | reply | num | 评论条数 | | @@ -135,14 +135,14 @@ curl -G 'http://api.bilibili.com/archive_stat/stat' \ 查询视频`av2271112`/`BV1es411D7sW`的状态数 -avID方式： +avid方式： ```shell curl -G 'http://api.bilibili.com/x/web-interface/archive/stat' \ --data-urlencode 'aid=2271112' ``` -bvID方式： +bvid方式： ```shell curl -G 'http://api.bilibili.com/x/web-interface/archive/stat' \ diff --git a/video/tags.md b/video/tags.md index b7e7ccb..1073a1d 100644 --- a/video/tags.md +++ b/video/tags.md @@ -18,8 +18,8 @@ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | -------- | ------------ | ------------------ | -| aid | num | 稿件avID | 必要（可选） | avID与bvID任选一个 | -| bvid | str | 稿件bvID | 必要（可选） | avID与bvID任选一个 | +| aid | num | 稿件avid | 必要（可选） | avid与bvid任选一个 | +| bvid | str | 稿件bvid | 必要（可选） | avid与bvid任选一个 | **json回复：** @@ -44,7 +44,7 @@ | 字段 | 类型 | 内容 | 备注 | | ------------- | ---- | -------------- | ------------------------------------------------------------ | -| tag_id | num | TAGID | | +| tag_id | num | tag_id | | | tag_name | str | TAG名称 | | | cover | str | TAG图片url | | | head_cover | str | TAG页面头图url | | @@ -73,7 +73,7 @@ 查询视频`av89772773`/`BV1M741177Kg`的TAG -avID方式： +avid方式： ```shell curl -G 'http://api.bilibili.com/x/tag/archive/tags' \ @@ -81,7 +81,7 @@ curl -G 'http://api.bilibili.com/x/tag/archive/tags' \ -b 'SESSDATA=xxx' ``` -bvID方式： +bvid方式： ```shell curl -G 'http://api.bilibili.com/x/tag/archive/tags' \ @@ -222,8 +222,8 @@ curl -G 'http://api.bilibili.com/x/tag/archive/tags' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ------------------------ | ------ | ---- | -| aid | num | 稿件avID | 必要 | | -| tag_id | num | TAGID | 必要 | | +| aid | num | 稿件avid | 必要 | | +| tag_id | num | tag_id | 必要 | | | csrf | str | CSRF Token（位于cookie） | 必要 | | **json回复：** @@ -275,8 +275,8 @@ curl 'http://api.bilibili.com/x/tag/archive/like2' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ------------------------ | ------ | ---- | -| aid | num | 稿件avID | 必要 | | -| tag_id | num | TAGID | 必要 | | +| aid | num | 稿件avid | 必要 | | +| tag_id | num | tag_id | 必要 | | | csrf | str | CSRF Token（位于cookie） | 必要 | | **json回复：** diff --git a/video/video_zone.md b/video/video_zone.md index 09f5a36..3346343 100644 --- a/video/video_zone.md +++ b/video/video_zone.md @@ -1,6 +1,6 @@ # 视频分区一览 -用于通过稿件avID判断所在的分区，或推荐分区视频等....... +用于通过稿件avid判断所在的分区，或推荐分区视频等....... 亦可用于更深♂入了解B站的分区 @@ -8,7 +8,7 @@ -| 名称 | 代号 | tID | 简介 | url路由 | +| 名称 | 代号 | tid | 简介 | url路由 | | -------------- | --------- | ---- | ------------------------------------------------------------ | ------------------------------------------------------------ | | 动画（主分区） | douga | 1 | | [/v/douga](https://www.bilibili.com/v/douga) | | MAD·AMV | mad | 24 | 具有一定制作程度的动画或静画的二次创作视频 | [/v/douga/mad](https://www.bilibili.com/v/douga/mad) | @@ -21,7 +21,7 @@ -| 名称 | 代号 | tID | 简介 | url路由 | +| 名称 | 代号 | tid | 简介 | url路由 | | -------------- | ----------- | ---- | -------------------------------------------------- | ------------------------------------------------------------ | | 番剧（主分区） | anime | 13 | | [/anime](https://www.bilibili.com/anime) | | 连载动画 | serial | 33 | 当季连载的动画番剧 | [/v/anime/serial](https://www.bilibili.com/v/anime/serial) | @@ -33,7 +33,7 @@ -| 名称 | 代号 | tID | 简介 | url路由 | +| 名称 | 代号 | tid | 简介 | url路由 | | -------------- | ----------- | ---- | ----------------- | ------------------------------------------------------------ | | 国创（主分区） | guochuang | 167 | | [/guochuang](https://www.bilibili.com/guochuang) | | 国产动画 | chinese | 153 | 我国出品的PGC动画 | [/v/guochuang/chinese](https://www.bilibili.com/v/guochuang/chinese) | @@ -46,7 +46,7 @@ -| 名称 | 代号 | tID | 简介 | url路由 | +| 名称 | 代号 | tid | 简介 | url路由 | | -------------- | ---------- | ---- | ------------------------------------------------------------ | ------------------------------------------------------------ | | 音乐（主分区） | music | 3 | | [/v/music](https://www.bilibili.com/v/music) | | 原创音乐 | original | 28 | 个人或团队制作以音乐为主要原创因素的歌曲或纯音乐 | [/v/music/original](https://www.bilibili.com/v/music/original) | @@ -62,7 +62,7 @@ -| 名称 | 代号 | tID | 简介 | url路由 | +| 名称 | 代号 | tid | 简介 | url路由 | | -------------- | ------- | ---- | ------------------------------------------------------------ | ------------------------------------------------------------ | | 舞蹈（主分区） | dance | 129 | | [/v/dance](https://www.bilibili.com/v/dance) | | 宅舞 | otaku | 20 | 与ACG相关的翻跳、原创舞蹈 | [/v/dance/otaku](https://www.bilibili.com/v/dance/otaku) | @@ -76,7 +76,7 @@ -| 名称 | 代号 | tID | 简介 | url路由 | +| 名称 | 代号 | tid | 简介 | url路由 | | -------------- | ----------- | ---- | ------------------------------------------------------------ | ------------------------------------------------------------ | | 游戏（主分区） | game | 4 | | [/v/game](https://www.bilibili.com/v/game) | | 单机游戏 | stand_alone | 17 | 以所有平台（PC、主机、移动端）的单机或联机游戏为主的视频内容，包括游戏预告、CG、实况解说及相关的评测、杂谈与视频剪辑等 | [/v/game/stand_alone](https://www.bilibili.com/v/game/stand_alone) | @@ -94,7 +94,7 @@ -| 名称 | 代号 | tID | 简介 | url路由 | +| 名称 | 代号 | tid | 简介 | url路由 | | ---------------------------------------------- | ----------------- | ------ | ------------------------------------------------------ | ------------------------------------------------------------ | | 知识(主分区) | knowledge | 36 | | [/v/knowledge](https://www.bilibili.com/v/knowledge) | | 科学科普 | science | 201 | 回答你的十万个为什么 | [/v/knowledge/science](https://www.bilibili.com/v/knowledge/science) | @@ -115,7 +115,7 @@ 旧：新： -| 名称 | 代号 | tID | 简介 | url路由 | +| 名称 | 代号 | tid | 简介 | url路由 | | -------------------- | ------------------- | ------- | ---------------------------------------------------------- | ------------------------------------------------------------ | | 科技(主分区) | tech | 188 | | [/v/tech](https://www.bilibili.com/v/tech) | | 数码(~~原手机平板~~) | digital | 95 | 科技数码产品大全，一起来做发烧友 | [/v/tech/digital](https://www.bilibili.com/v/tech/digital) | @@ -133,7 +133,7 @@ -| 名称 | 代号 | tID | 简介 | url路由 | +| 名称 | 代号 | tid | 简介 | url路由 | | -------------- | -------- | ---- | ------------------------------------------------------------ | ---------------------------------------------------------- | | 汽车（主分区） | car | 223 | | [/v/car](https://www.bilibili.com/v/car) | | 汽车生活 | life | 176 | 分享汽车及出行相关的生活体验类视频 | [/v/car/life](https://www.bilibili.com/v/car/life) | @@ -148,7 +148,7 @@ -| 名称 | 代号 | tID | 简介 | url路由 | +| 名称 | 代号 | tid | 简介 | url路由 | | -------------------- | -------------- | ------- | ------------------------------------------------ | ------------------------------------------------------------ | | 生活（主分区） | life | 160 | | [/v/life](https://www.bilibili.com/v/life) | | 搞笑 | funny | 138 | 各种沙雕有趣的搞笑剪辑，挑战，表演，配音等视频 | [/v/life/funny](https://www.bilibili.com/v/life/funny) | @@ -167,7 +167,7 @@ -| 名称 | 代号 | tID | 简介 | url路由 | +| 名称 | 代号 | tid | 简介 | url路由 | | ------------------------------ | ----------- | ---- | -------------------------------- | ------------------------------------------------------------ | | 美食（主分区） | food | 211 | | [/v/food](https://www.bilibili.com/v/food) | | 美食制作（原[生活]->[美食圈]） | make | 76 | 学做人间美味，展示精湛厨艺 | [/v/food/make](https://www.bilibili.com/v/food/make) | @@ -182,7 +182,7 @@ -| 名称 | 代号 | tID | 简介 | url路由 | +| 名称 | 代号 | tid | 简介 | url路由 | | -------- | ---------------- | ---- | ------------------------------------------------------------ | ------------------------------------------------------------ | | 动物圈 | animal（主分区） | 217 | | [/v/animal](https://www.bilibili.com/v/animal) | | 喵星人 | cat | 218 | 喵喵喵喵喵 | [/v/animal/cat](https://www.bilibili.com/v/animal/cat) | @@ -196,7 +196,7 @@ -| 名称 | 代号 | tID | 简介 | url路由 | +| 名称 | 代号 | tid | 简介 | url路由 | | -------------- | --------------- | ---- | ------------------------------------------------------------ | ------------------------------------------------------------ | | 鬼畜（主分区） | kichiku | 119 | | [/v/kichiku](https://www.bilibili.com/v/kichiku) | | 鬼畜调教 | guide | 22 | 使用素材在音频、画面上做一定处理，达到与BGM一定的同步感 | [/v/kichiku/guide](https://www.bilibili.com/v/kichiku/guide) | @@ -209,7 +209,7 @@ -| 名称 | 代号 | tID | 简介 | url路由 | +| 名称 | 代号 | tid | 简介 | url路由 | | -------------- | -------- | ---- | ------------------------------------------------------------ | ------------------------------------------------------------ | | 时尚（主分区） | fashion | 155 | | [/v/fashion](https://www.bilibili.com/v/fashion) | | 美妆 | makeup | 157 | 涵盖妆容、发型、美甲等教程，彩妆、护肤相关产品测评、分享等 | [/v/fashion/makeup](https://www.bilibili.com/v/fashion/makeup) | @@ -226,7 +226,7 @@ -| 名称 | 代号 | tID | 简介 | url路由 | +| 名称 | 代号 | tid | 简介 | url路由 | | -------------- | ----------- | ---- | -------------------------------------------- | ------------------------------------------------------------ | | 资讯（主分区） | information | 202 | | [/v/information](https://www.bilibili.com/v/information) | | 热点 | hotspot | 203 | 全民关注的时政热门资讯 | [/v/information/hotspot](https://www.bilibili.com/v/information/hotspot) | @@ -240,7 +240,7 @@ -| 名称 | 代号 | tID | 简介 | url路由 | +| 名称 | 代号 | tid | 简介 | url路由 | | ------------------ | ------ | ------- | ---- | ------------ | | ~~广告（主分区）~~ | ~~ad~~ | ~~165~~ | | ~~/v/ad~~ | | ~~广告~~ | ~~ad~~ | ~~166~~ | | ~~/v/ad/ad~~ | @@ -249,7 +249,7 @@ -| 名称 | 代号 | tID | 简介 | url路由 | +| 名称 | 代号 | tid | 简介 | url路由 | | ----------------------- | --------- | ------- | ----------------------------------- | -------------------------------------------------------- | | 娱乐（主分区） | ent | 5 | | [/v/ent](https://www.bilibili.com/v/ent) | | 综艺 | variety | 71 | 国内外有趣的综艺和综艺相关精彩剪辑 | [/v/ent/variety](https://www.bilibili.com/v/ent/variety) | @@ -260,7 +260,7 @@ -| 名称 | 代号 | tID | 简介 | url路由 | +| 名称 | 代号 | tid | 简介 | url路由 | | -------------- | ------------ | ---- | -------------------------------- | ------------------------------------------------------------ | | 影视（主分区） | cinephile | 181 | | [/v/cinephile](https://www.bilibili.com/v/cinephile) | | 影视杂谈 | cinecism | 182 | 影视评论、解说、吐槽、科普等 | [/v/cinephile/cinecism](https://www.bilibili.com/v/cinephile/cinecism) | @@ -272,7 +272,7 @@ -| 名称 | 代号 | tID | 简介 | url路由 | +| 名称 | 代号 | tid | 简介 | url路由 | | ---------------- | ----------- | ---- | ---- | ------------------------------------------------------------ | | 纪录片（主分区） | documentary | 177 | | [/documentary](https://www.bilibili.com/documentary) | | 人文·历史 | history | 37 | | [/v/documentary/history](https://www.bilibili.com/v/documentary/history) | @@ -284,7 +284,7 @@ -| 名称 | 代号 | tID | 简介 | url路由 | +| 名称 | 代号 | tid | 简介 | url路由 | | -------------- | ------- | ---- | ---- | ------------------------------------------------------------ | | 电影（主分区） | movie | 23 | | [/movie](https://www.bilibili.com/movie) | | 华语电影 | chinese | 147 | | [/v/movie/chinese](https://www.bilibili.com/v/movie/chinese) | @@ -296,7 +296,7 @@ -| 名称 | 代号 | tID | 简介 | url路由 | +| 名称 | 代号 | tid | 简介 | url路由 | | ---------------- | -------- | ---- | ---- | -------------------------------------------------------- | | 电视剧（主分区） | tv | 11 | | [/tv](https://www.bilibili.com/tv) | | 国产剧 | mainland | 185 | | [/v/tv/mainland](https://www.bilibili.com/v/tv/mainland) | diff --git a/video/videostream_url.md b/video/videostream_url.md index 650ea51..7fb838a 100644 --- a/video/videostream_url.md +++ b/video/videostream_url.md @@ -83,15 +83,15 @@ B站的视频为http流媒体，需要对应的api以视频id获取取流url， **部分视频**会有**分段**，需要特别注意 -若视频有分P，仅为单P的视频的url，换P则需更换CID重新获取 +若视频有分P，仅为单P的视频的url，换P则需更换cid重新获取 **url参数：** | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ---------------- | ------------ | ------------------------------------------------------------ | -| avid | num | 稿件avID | 必要（可选） | avID与bvID任选一个 | -| bvid | str | 稿件bvID | 必要（可选） | avID与bvID任选一个 | -| cid | num | 视频CID | 必要 | | +| avid | num | 稿件avid | 必要（可选） | avid与bvid任选一个 | +| bvid | str | 稿件bvid | 必要（可选） | avid与bvid任选一个 | +| cid | num | 视频cid | 必要 | | | qn | num | 视频清晰度选择 | 非必要 | 未登录默认32（480P）
登录默认64（720P）
**值含义见上表**
注：dash方式无效 | | fnval | num | 视频获取方式选择 | 非必要 | 默认为0
0 2：flv方式（可能会有分段）
1：低清mp4方式（仅240P与360P，且限速65K/s）
16 80：dash方式（音视频分流，支持H.265） | | fnver | num | 0 | 非必要 | 固定为0 | @@ -179,9 +179,9 @@ B站的视频为http流媒体，需要对应的api以视频id获取取流url， **视频无分段时：** -获取视频`av99999999`/`BV1y7411Q7Eq`中的1P（CID=`171776208`）的视频流url，清晰度为1080P+，使用flv方式获取 +获取视频`av99999999`/`BV1y7411Q7Eq`中的1P（cid=`171776208`）的视频流url，清晰度为1080P+，使用flv方式获取 -avID方式： +avid方式： ```shell curl -G 'http://api.bilibili.com/x/player/playurl' \ @@ -194,7 +194,7 @@ curl -G 'http://api.bilibili.com/x/player/playurl' \ -b 'SESSDATA=xxx' ``` - bvID方式： + bvid方式： ```shell curl -G 'http://api.bilibili.com/x/player/playurl' \ @@ -417,9 +417,9 @@ curl -G 'http://api.bilibili.com/x/player/playurl' \ **示例：** -获取视频`av969628065`/`BV1rp4y1e745`中的1P（CID=`244954665`）的视频流url，使用dash方式获取 +获取视频`av969628065`/`BV1rp4y1e745`中的1P（cid=`244954665`）的视频流url，使用dash方式获取 -avID方式： +avid方式： ```shell curl -G 'http://api.bilibili.com/x/player/playurl' \ @@ -432,7 +432,7 @@ curl -G 'http://api.bilibili.com/x/player/playurl' \ -b 'SESSDATA=xxx' ``` - bvID方式： + bvid方式： ```shell curl -G 'http://api.bilibili.com/x/player/playurl' \