From 4fd408f111761d41545c4248c5b3100526a79832 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: Thu, 16 Apr 2020 18:47:19 +0800 Subject: [PATCH] =?UTF-8?q?=E4=BC=98=E5=8C=96=E6=96=87=E6=A1=A3=E6=A0=BC?= =?UTF-8?q?=E5=BC=8F?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- creativecenter/statistics&data.md | 36 +++++++----- danmaku/danmaku.md | 10 ++-- danmaku/history.md | 10 ++-- danmaku/snapshot.md | 10 ++-- dynamic/publish.md | 4 +- electric/Bcoin.md | 6 +- electric/WeChat&Alipay.md | 12 ++-- electric/charge_msg.md | 6 +- live/info.md | 6 +- login/QR.md | 11 +++- login/login_info.md | 12 +++- login/msg.md | 4 +- login/private_msg.md | 4 +- other/ip.md | 4 +- ranking&dynamic/dynamic.md | 6 +- ranking&dynamic/ranking.md | 6 +- user/check_nickname.md | 2 + user/info.md | 21 +++++-- user/relation.md | 94 ++++++++++++++++++++----------- user/space.md | 66 ++++++++++++++-------- user/status_number.md | 29 +++++++--- video/info.md | 18 ++++-- video/like_coin_fav.md | 42 +++++++++----- video/recommend.md | 6 +- video/snapshot.md | 13 ++++- video/status_number.md | 14 +++-- 26 files changed, 303 insertions(+), 149 deletions(-) diff --git a/creativecenter/statistics&data.md b/creativecenter/statistics&data.md index a195d4b..57d866d 100644 --- a/creativecenter/statistics&data.md +++ b/creativecenter/statistics&data.md @@ -12,6 +12,8 @@ **json回复：** +根对象： + | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | ----------------------------- | | code | num | 返回值 | 0：成功
-101：账号未登录 | @@ -64,7 +66,7 @@ | ｛YYYYMMDD｝ | num | 掉粉数 | 字段名为日期 | | …… | num | …… | 近30天的掉粉情况 | -示例： +**示例：** http://member.bilibili.com/x/web/index/stat @@ -162,6 +164,8 @@ http://member.bilibili.com/x/web/index/stat **json回复：** +根对象： + | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | ----------------------------- | | code | num | 返回值 | 0：成功
-101：账号未登录 | @@ -186,7 +190,7 @@ http://member.bilibili.com/x/web/index/stat | incr_fav | num | 新增收藏数 | | | incr_share | num | 新增分享数 | | -示例： +**示例：** http://member.bilibili.com/x/web/data/article @@ -222,13 +226,13 @@ http://member.bilibili.com/x/web/data/article 数据为前30天 -参数： +**参数：** -| 参数名 | 类型 | 内容 | 必要性 | 备注 | -| ------ | ---- | ------------ | ------ | ---- | -| type | url | 目标数据类型 | 必要 | | +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| ------ | ---- | ------------ | ------ | -------------- | +| type | url | 目标数据类型 | 必要 | 类型代码见下表 | -`type`参数： +类型代码`type`： | 代码 | 含义 | | ---- | ---- | @@ -243,6 +247,8 @@ http://member.bilibili.com/x/web/data/article **json回复：** +根对象： + | 字段 | 类型 | 内容 | 备注 | | ------- | ----- | -------- | ------------------------------------------------- | | code | num | 返回值 | 0：成功
-101：账号未登录
-400：请求错误 | @@ -266,7 +272,7 @@ http://member.bilibili.com/x/web/data/article | date_key | num | 对应时间 | 时间戳 前一天的8:00 | | total_inc | num | 增加数量 | 意义为数据类型决定 | -示例： +**示例：** 查询30天前的视频播放增量趋势，可知`2020-04-05`的播放增量为`46`，`2020-04-04`的播放增量为`58` @@ -311,13 +317,13 @@ http://member.bilibili.com/x/web/data/pandect?type=1 数据为前30天 -参数： +**参数：** -| 参数名 | 类型 | 内容 | 必要性 | 备注 | -| ------ | ---- | ------------ | ------ | ---- | -| type | url | 目标数据类型 | 必要 | | +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| ------ | ---- | ------------ | ------ | -------------- | +| type | url | 目标数据类型 | 必要 | 类型代码见下表 | -`type`参数： +类型代码`type`： | 代码 | 含义 | | ---- | ---- | @@ -330,6 +336,8 @@ http://member.bilibili.com/x/web/data/pandect?type=1 **json回复：** +根对象： + | 字段 | 类型 | 内容 | 备注 | | ------- | ----- | -------- | ------------------------------------------------- | | code | num | 返回值 | 0：成功
-101：账号未登录
-400：请求错误 | @@ -353,7 +361,7 @@ http://member.bilibili.com/x/web/data/pandect?type=1 | date_key | num | 对应时间 | 时间戳 前一天的8:00 | | total_inc | num | 增加数量 | 意义为数据类型决定 | -示例： +**示例：** 查询30天前的文章阅读增量趋势，可知`2020-04-05`的阅读增量为`6`，`2020-04-04`的阅读增量为`6` diff --git a/danmaku/danmaku.md b/danmaku/danmaku.md index b082da3..a1faeec 100644 --- a/danmaku/danmaku.md +++ b/danmaku/danmaku.md @@ -1,6 +1,6 @@ # 弹幕 -弹幕均为xml格式，下载至本地后加载 +获取的均为xml格式标准弹幕文件，下载至本地后加载 实时弹幕池容量有限（根据视频类型500-3000条不等），占满后再发送会使实时弹幕池底部的弹幕压入历史弹幕池（类似于堆栈） @@ -12,13 +12,13 @@ **使用deflate压缩，注意解码** -参数： +**参数：** | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ------- | ------ | ---- | | oid | url | 视频CID | 必要 | | -示例： +**示例：** http://api.bilibili.com/x/v1/dm/list.so?oid=144541892 @@ -32,13 +32,13 @@ http://api.bilibili.com/x/v1/dm/list.so?oid=144541892 **使用deflate压缩，注意解码** -参数： +**参数：** | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ------- | ------ | ---- | | cid | url | 视频CID | 必要 | | -示例： +**示例：** http://comment.bilibili.com/144541892.xml diff --git a/danmaku/history.md b/danmaku/history.md index e938a2d..5618d80 100644 --- a/danmaku/history.md +++ b/danmaku/history.md @@ -8,7 +8,7 @@ *方式：GET* -参数： +**参数：** | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | -------- | ------ | ------------ | @@ -18,6 +18,8 @@ **json回复：** +根对象： + | 字段 | 类型 | 内容 | 备注 | | ------- | ------------------------------- | -------- | ------------------------------------------------- | | code | num | 返回值 | 0：成功
-400：请求错误
-101：账号未登录 | @@ -33,7 +35,7 @@ | n | str | 存在弹幕的日期(n+1) | yyyy-mm-dd | | …… | str | …… | …… | -示例： +**示例：** 查询了cid为144541892的视频位于2020年1月中有历史弹幕记录的日期 @@ -83,7 +85,7 @@ http://api.bilibili.com/x/v2/dm/history/index?type=1&oid=144541892&month=2019-12 **使用deflate压缩，注意解码** -参数： +**参数：** | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | -------- | ------ | ------------ | @@ -91,7 +93,7 @@ http://api.bilibili.com/x/v2/dm/history/index?type=1&oid=144541892&month=2019-12 | oid | url | 视频CID | 必要 | | | date | url | 弹幕日期 | 必要 | yyyy-mm-dd | -示例： +**示例：** https://api.bilibili.com/x/v2/dm/history?type=1&oid=144541892&date=2020-01-21 diff --git a/danmaku/snapshot.md b/danmaku/snapshot.md index ce8e0a8..22014f6 100644 --- a/danmaku/snapshot.md +++ b/danmaku/snapshot.md @@ -8,7 +8,7 @@ 最近产生的几条弹幕内容，**最多20条** -参数： +**参数：** | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ------------------ | ------ | ---- | @@ -16,6 +16,8 @@ **json回复：** +根对象： + | 字段 | 类型 | 内容 | 备注 | | ------- | ----- | -------- | --------------------------------------------- | | code | num | 返回值 | 0：成功
-400：请求错误
-404：无视频 | @@ -32,7 +34,9 @@ | …… | str | …… | …… | | 19 | str | 预览内容20 | 最后一条 | -示例： +**示例：** + +获取视频`av43337021`/`BV1rb411m7gE`的弹幕快照，总计20条 http://api.bilibili.com/x/v2/dm/ajax?aid=43337021 @@ -68,5 +72,3 @@ http://api.bilibili.com/x/v2/dm/ajax?aid=43337021 } ``` -获取了视频av43337021的弹幕快照，总计20条 - diff --git a/dynamic/publish.md b/dynamic/publish.md index 71cfe3f..f1660bd 100644 --- a/dynamic/publish.md +++ b/dynamic/publish.md @@ -12,7 +12,7 @@ 注意：非日常类型像素宽高必须大于420 -参数（multipart/form-data）： +**参数（multipart/form-data）：** | 参数名 | 类型 | 内容 | 必要性 | 备注 | | -------- | ---- | ------------------ | ------ | ------------------------------------------------------------ | @@ -21,6 +21,8 @@ **json回复：** +根对象： + | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | ------------------------------------------------------------ | | code | num | 返回值 | 0：成功
-1：未添加图片
-2：参数错误
-3：图片尺寸过小
-4：账号未登录
-7：图片信息错误 | diff --git a/electric/Bcoin.md b/electric/Bcoin.md index c0df7b5..e67e046 100644 --- a/electric/Bcoin.md +++ b/electric/Bcoin.md @@ -10,7 +10,7 @@ 需要登录(SESSDATA) -参数（ application/x-www-form-urlencoded ）： +**参数（ application/x-www-form-urlencoded ）：** | 参数名 | 类型 | 内容 | 必要性 | 备注 | | -------- | ---- | ------------------- | ------ | ------------------------------------------------- | @@ -22,6 +22,8 @@ **json回复：** +根对象： + | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | ------------------------------------------------------------ | | code | num | 返回值 | 0：成功（并不代表充电成功）
-400：请求错误
-111：csrf校验失败
-101：账号未登录 | @@ -41,7 +43,7 @@ | status | num | 返回结果 | 4：成功
-2：低于20电池下限
-4：B币不足 | | msg | str | 错误信息 | 默认为空 | -示例： +**示例：** 以空间的方式向用户`UID=293793435`充了20电池，得到2经验，交易编号为`BPRG5CEC3VUPOOANA540` diff --git a/electric/WeChat&Alipay.md b/electric/WeChat&Alipay.md index 8e73d26..0c244cc 100644 --- a/electric/WeChat&Alipay.md +++ b/electric/WeChat&Alipay.md @@ -22,7 +22,7 @@ 秘钥有效时间为10分钟 -参数（ application/x-www-form-urlencoded ）： +**参数（ application/x-www-form-urlencoded ）：** | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------------------- | ---- | ------------------- | ------ | ------------------------------------------------------------ | @@ -35,6 +35,8 @@ **json回复：** +根对象： + | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | ------------------------------------------------------------ | | code | num | 返回值 | 0：成功
-400：请求错误
-500：服务器错误
-111：csrf校验失败
-101：账号未登录 | @@ -50,7 +52,7 @@ | qr_token | str | 扫码秘钥 | | | exp | num | 获得经验数 | | -示例： +**示例：** 申请空间的方式向用户23215368充电10电池且不使用B币的支付二维码 @@ -77,7 +79,7 @@ curl -b "SESSDATA=xxx" -d "up_mid=23215368&elec_num=10&is_bp_remains_prior=false *方式：GET* -参数： +**参数：** | 参数名 | 类型 | 内容 | 必要性 | 备注 | | -------- | ---- | -------- | ------ | ---- | @@ -85,6 +87,8 @@ curl -b "SESSDATA=xxx" -d "up_mid=23215368&elec_num=10&is_bp_remains_prior=false **json回复：** +根对象： + | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | ----------------------------- | | code | num | 返回值 | 0：成功
-101：账号未登录 | @@ -101,7 +105,7 @@ curl -b "SESSDATA=xxx" -d "up_mid=23215368&elec_num=10&is_bp_remains_prior=false | mid | num | 当前用户UID | | | status | num | 状态值 | 若秘钥错误则无此项
1：已支付
2：未扫描
3：未确认 | -示例： +**示例：** 当申请到的支付二维码未被扫描时，`data`.`ststus`的值为`2` diff --git a/electric/charge_msg.md b/electric/charge_msg.md index d013720..06ca1c0 100644 --- a/electric/charge_msg.md +++ b/electric/charge_msg.md @@ -6,7 +6,7 @@ 需要登录(SESSDATA) -参数（ application/x-www-form-urlencoded ）： +**参数（ application/x-www-form-urlencoded ）：** | 参数名 | 类型 | 内容 | 必要性 | 备注 | | -------- | ---- | ------------------- | ------ | ---- | @@ -16,13 +16,15 @@ **json回复：** +根对象： + | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | ------------------------------------------------------------ | | code | num | 返回值 | 0：成功
-400：请求错误
-111：csrf校验失败
-101：账号未登录
88203：不能重复留言 | | message | str | 错误信息 | 默认为0 | | ttl | num | 1 | 作用尚不明确 | -示例： +**示例：** 成功为交易编号为`BPRG5CEC3VUPOOANA540`的充电操作，添加了内容为`支持一下大佬`的留言 diff --git a/live/info.md b/live/info.md index 72dca83..edd14fd 100644 --- a/live/info.md +++ b/live/info.md @@ -6,7 +6,7 @@ *方式：GET* -参数： +**参数：** | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ----------- | ------ | ---- | @@ -14,6 +14,8 @@ **json回复：** +根对象： + | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | --------------------------- | | code | num | 返回值 | 0：成功
-400：请求错误 | @@ -36,7 +38,7 @@ | broadcast_type | num | 0 | | | online_hidden | num | 0 | | -示例： +**示例：** 查询用户`UID=322892`的直播间信息 diff --git a/login/QR.md b/login/QR.md index 5551ade..68c844c 100644 --- a/login/QR.md +++ b/login/QR.md @@ -23,6 +23,8 @@ **json回复：** +根对象： + | 字段 | 类型 | 内容 | 备注 | | ------ | ---- | -------- | ------------ | | code | num | 返回值 | 0：成功 | @@ -37,7 +39,7 @@ | url | str | 二维码内容url | 恒为87字符 | | oauthKey | str | 扫码登录秘钥 | 恒为32字符 | -示例： +**示例：** 用申请到的`data`.`url`中的值生成二维码，等待手机客户端扫描，并将`data`.`oauthKey`保存等待使用 @@ -68,7 +70,8 @@ http://passport.bilibili.com/qrcode/getLoginUrl `sid` `DedeUserID` `DedeUserID__ckMd5` `SESSDATA` `bili_jct` -参数（ application/x-www-form-urlencoded ）： +**参数（ application/x-www-form-urlencoded ）：** + | 参数名 | 类型 | 内容 | 必要性 | 备注 | | -------- | ---- | ------------ | ------ | ----------------------------- | | oauthKey | data | 扫码登录秘钥 | 必要 | | @@ -76,6 +79,8 @@ http://passport.bilibili.com/qrcode/getLoginUrl **json回复：** +根对象： + | 字段 | 类型 | 内容 | 备注 | | ------- | ---------------------------- | ----------------------------------------- | ------------------------------------------------------------ | | status | bool | 扫码是否成功 | true：成功
false：未成功 | @@ -89,7 +94,7 @@ data 对象： | ---- | ---- | --------------- | ---- | | url | str | 游戏分站登录url | | -示例： +**示例：** curl -d "oauthKey=xxx" "http://passport.bilibili.com/qrcode/getLoginInfo" diff --git a/login/login_info.md b/login/login_info.md index cad67f7..4ac231b 100644 --- a/login/login_info.md +++ b/login/login_info.md @@ -12,6 +12,8 @@ **json回复：** +根对象： + | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | ----------------------------- | | code | num | 返回值 | 0：成功
-101：账号未登录 | @@ -90,7 +92,7 @@ | coupon_balance | num | 每月奖励B币数 | | | coupon_due_time | num | 0 | 作用尚不明确 | -示例： +**示例：** 查询当前登录用户的信息 @@ -166,6 +168,8 @@ http://api.bilibili.com/x/web-interface/nav **json回复：** +根对象： + | 字段 | 类型 | 内容 | 备注 | | ------ | ---- | -------- | ----------------------------- | | code | num | 返回值 | 0：成功
-101：账号未登录 | @@ -198,7 +202,7 @@ http://api.bilibili.com/x/web-interface/nav | current_exp | num | 当前经验 | | | next_exp | num | 升级下一等级需达到的经验 | | -示例： +**示例：** 查询当前登录用户的信息 @@ -242,6 +246,8 @@ http://account.bilibili.com/home/userInfo **json回复：** +根对象： + | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | ----------------------------- | | code | num | 返回值 | 0：成功
-101：账号未登录 | @@ -255,7 +261,7 @@ http://account.bilibili.com/home/userInfo | follower | num | 粉丝数 | | | dynamic_count | num | 发布动态数 | | -示例： +**示例：** 查询当前登录用户的状态数 diff --git a/login/msg.md b/login/msg.md index 54d5a7e..eda522b 100644 --- a/login/msg.md +++ b/login/msg.md @@ -10,6 +10,8 @@ **json回复：** +根对象： + | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | ----------------------------- | | code | num | 返回值 | 0：成功
-101：账号未登录 | @@ -28,7 +30,7 @@ data 对象： | sys_msg | num | 未读系统通知数 | | | up | num | 0 | 作用尚不明确 | -示例： +**示例：** 以下信息代表了未读点赞数为`10`，未读回复数为`3`，未读at消息数为`1`，未读系统通知数为`1` diff --git a/login/private_msg.md b/login/private_msg.md index 0dee668..da53232 100644 --- a/login/private_msg.md +++ b/login/private_msg.md @@ -10,6 +10,8 @@ **json回复：** +根对象： + | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | --------------------------- | | code | num | 返回值 | 0：成功
-6：账号未登录 | @@ -25,7 +27,7 @@ data 对象： | follow_unread | num | 已关注用户未读私信数 | | | _gt_ | num | 0 | 作用尚不明确 | -示例： +**示例：** 以下信息代表了为未关注用户未读私信数为`10`条，已关注用户未读私信数为`3`条 diff --git a/other/ip.md b/other/ip.md index 6918ad0..c821ada 100644 --- a/other/ip.md +++ b/other/ip.md @@ -6,6 +6,8 @@ **json回复：** +根对象： + | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | ------------ | | code | num | 返回值 | 0：成功 | @@ -27,7 +29,7 @@ | zone_id | num | ？？？ | | | country_code | num | 国家/地区代码 | | -示例： +**示例：** http://api.bilibili.com/x/web-interface/zone diff --git a/ranking&dynamic/dynamic.md b/ranking&dynamic/dynamic.md index 7e96a34..6ff4ce5 100644 --- a/ranking&dynamic/dynamic.md +++ b/ranking&dynamic/dynamic.md @@ -6,7 +6,7 @@ *方式：GET* -参数： +**参数：** | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ----------- | ------ | ------- | @@ -16,6 +16,8 @@ **json回复：** +根对象： + | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | --------------------------- | | code | num | 返回值 | 0：成功
-400：请求错误 | @@ -50,7 +52,7 @@ | num | num | 当前页码 | | | size | num | 每页项数 | | -示例： +**示例：** 获取`tID=21`（生活->日常）分区中的2条最新动态视频信息 diff --git a/ranking&dynamic/ranking.md b/ranking&dynamic/ranking.md index 89f1501..71d8ef1 100644 --- a/ranking&dynamic/ranking.md +++ b/ranking&dynamic/ranking.md @@ -10,7 +10,7 @@ 获取相应时间段内播放量增速为前11的视频 -参数： +**参数：** | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ----------- | ------ | ---------------------------------------------------- | @@ -19,6 +19,8 @@ **json回复：** +根对象： + | 字段 | 类型 | 内容 | 备注 | | ------- | ------ | -------- | --------------------------- | | code | num | 返回值 | 0：成功
-400：请求错误 | @@ -39,7 +41,7 @@ 基本同「[视频详细信息](https://github.com/SocialSisterYi/bilibili-API-collect/blob/master/video/info.md#视频详细信息（avID/bvID互转）)」中的data对象 -示例： +**示例：** 获取`tID=1`（动画）分区中的三日视频排行榜 diff --git a/user/check_nickname.md b/user/check_nickname.md index efc22f9..5073114 100644 --- a/user/check_nickname.md +++ b/user/check_nickname.md @@ -13,6 +13,8 @@ **json回复：** +根对象： + | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | --------------------------- | | code | num | 状态码 | **详细说明见下一表格** | diff --git a/user/info.md b/user/info.md index 9689f01..739f253 100644 --- a/user/info.md +++ b/user/info.md @@ -7,13 +7,16 @@ *方式:GET* -参数： +**参数：** + | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ----------- | ------ | ---- | | mid | url | 目标用户UID | 必要 | | **json回复：** +根对象： + | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | --------------------------- | | code | num | 返回值 | 0：成功
-400：请求错误 | @@ -84,7 +87,7 @@ | level | str | 勋章等级 | | | condition | str | 勋章条件 | | -示列： +**示列：** 查询用户`UID=2`的详细信息 @@ -193,14 +196,17 @@ http://i2.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png *方式:GET* -参数： +**参数：** + | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | -------------------- | ------ | ----------------------- | | mid | url | 目标用户UID | 必要 | | | photo | url | 是否请求用户主页头图 | 非必要 | true：是
false：否 | - **json回复：** + +根对象： + | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | --------------------------- | | code | num | 返回值 | 0：成功
-400：请求错误 | @@ -309,7 +315,7 @@ http://i2.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png | s_img | str | 主页头图url 小图 | | | l_img | str | 主页头图url 正常 | | -示列： +**示列：** http://api.bilibili.com/x/web-interface/card?mid=2&photo=true ```json @@ -401,6 +407,9 @@ http://api.bilibili.com/x/web-interface/card?mid=2&photo=true 功能同「[登录用户信息1](../login/login_info.md#登录用户信息1（完整）)」 **json回复：** + +根对象： + | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | ------------------------- | | code | num | 返回值 | 0：成功
-101：未登录 | @@ -490,7 +499,7 @@ http://api.bilibili.com/x/web-interface/card?mid=2&photo=true | current_exp | num | 0 | 作用尚不明确 | | next_exp | num | 0 | 作用尚不明确 | -示例： +**示例：** http://api.bilibili.com/x/space/myinfo ```json diff --git a/user/relation.md b/user/relation.md index 5b277c7..52bffa3 100644 --- a/user/relation.md +++ b/user/relation.md @@ -10,7 +10,7 @@ 登录(SESSDATA)可看自己全部 -参数： +**参数：** | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ----------- | ------ | -------------------------------- | @@ -20,6 +20,8 @@ **json回复：** +根对象： + | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | --------------------------------------------------- | | code | num | 返回值 | 0：成功
-400：请求错误
22007：访问超过5页 | @@ -84,7 +86,7 @@ | ---- | ---- | ---- | ------------ | | path | str | 空 | 作用尚不明确 | -示例： +**示例：** 以每页2项的方式获取`UID=293793435`的用户的第1页的粉丝明细 @@ -165,7 +167,7 @@ http://api.bilibili.com/x/relation/followers?vmid=293793435&ps=2&pn=1 登录(SESSDATA)可看自己全部 -参数： +**参数：** | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ----------- | ------ | -------------------------------- | @@ -175,6 +177,8 @@ http://api.bilibili.com/x/relation/followers?vmid=293793435&ps=2&pn=1 **json回复：** +根对象： + | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | --------------------------------------------------- | | code | num | 返回值 | 0：成功
-400：请求错误
22007：访问超过5页 | @@ -247,7 +251,7 @@ data 对象： | ---- | ---- | ---- | ------------ | | path | str | 空 | 作用尚不明确 | -示例： +**示例：** 以每页2项的方式获取`UID=293793435`的用户的第1页的关注明细 @@ -328,16 +332,16 @@ http://api.bilibili.com/x/relation/followings?vmid=293793435&ps=2&pn=1 需要登录(SESSDATA) -参数（ application/x-www-form-urlencoded ）： +**参数（ application/x-www-form-urlencoded ）：** -| 参数名 | 类型 | 内容 | 必要性 | 备注 | -| ------ | ---- | ------------------- | ------ | ---- | -| fid | data | 目标用户UID | 必要 | | -| act | data | 操作代码 | 必要 | | -| re_src | data | 必须为11 | 必要 | | -| csrf | data | cookies中的bili_jct | 必要 | | +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| ------ | ---- | ------------------- | ------ | -------------- | +| fid | data | 目标用户UID | 必要 | | +| act | data | 操作代码 | 必要 | 操作代码见下表 | +| re_src | data | 必须为11 | 必要 | | +| csrf | data | cookies中的bili_jct | 必要 | | -操作代码： +操作代码`act`： | 代码 | 含义 | | ---- | ------------ | @@ -351,13 +355,15 @@ http://api.bilibili.com/x/relation/followings?vmid=293793435&ps=2&pn=1 **json回复：** +根对象： + | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | ------------------------------------------------------------ | | code | num | 返回值 | 0：成功
-101：账号未登录
-102：账号被封停
-111：csrf校验失败
-400：请求错误
22003：用户位于黑名单 | | message | str | 错误信息 | 默认为0 | | ttl | num | 1 | 作用尚不明确 | -示例： +**示例：** 关注`UID=14082`的用户 @@ -381,7 +387,7 @@ curl -b SESSDATA=xxx -d "fid=14082&act=1&re_src=11&csrf=xxx" http://api.bilibili 需要登录(SESSDATA) -参数： +**参数：** | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ----------- | ------ | ---- | @@ -389,6 +395,8 @@ curl -b SESSDATA=xxx -d "fid=14082&act=1&re_src=11&csrf=xxx" http://api.bilibili **json回复：** +根对象： + | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | ------------------------------------------------- | | code | num | 返回值 | 0：成功
-101：账号未登录
-400：请求错误 | @@ -414,7 +422,7 @@ curl -b SESSDATA=xxx -d "fid=14082&act=1&re_src=11&csrf=xxx" http://api.bilibili | n | num | 位于分组（n+1）的分组ID | | | …… | num | …… | …… | -示例： +**示例：** 可得对于`UID=258150656`的用户，在`2018/10/28 0:51:41`时关注，且设为特别关注，并位于ID为`-10`分组中 @@ -445,7 +453,7 @@ http://api.bilibili.com/x/relation?fid=258150656 需要登录(SESSDATA) -参数： +**参数：** | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ----------- | ------ | ---- | @@ -453,6 +461,8 @@ http://api.bilibili.com/x/relation?fid=258150656 **json回复：** +根对象： + | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | ------------------------------------------------- | | code | num | 返回值 | 0：成功
-101：账号未登录
-400：请求错误 | @@ -495,7 +505,7 @@ http://api.bilibili.com/x/relation?fid=258150656 | n | num | 位于分组（n+1）的分组ID | | | …… | num | …… | …… | -示例： +**示例：** 可得对于`UID=15858903`的用户，在`2019/1/24 14:24:19`时关注了对方，且互相关注，自己将对方特别关注，并同时位于ID为`-10`和`194110`的分组中，对方也将自己设为特别关注，并同时位于ID为`-10`和`56502`的分组中（虽然我看不到） @@ -541,6 +551,8 @@ http://api.bilibili.com/x/space/acc/relation?mid=15858903 **json回复：** +根对象： + | 字段 | 类型 | 内容 | 备注 | | ------- | ------ | -------- | ----------------------------- | | code | num | 返回值 | 0：成功
-101：账号未登录 | @@ -565,7 +577,7 @@ http://api.bilibili.com/x/space/acc/relation?mid=15858903 | name | str | 分组名称 | | | count | num | 分组成员数 | | -示例： +**示例：** 查询所有的分组的名字以及ID @@ -604,7 +616,7 @@ http://api.bilibili.com/x/relation/tags 需要登录(SESSDATA) -参数： +**参数：** | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | -------- | ------ | ---------------------------------- | @@ -614,6 +626,8 @@ http://api.bilibili.com/x/relation/tags **json回复：** +根对象： + | 字段 | 类型 | 内容 | 备注 | | ------- | ------ | -------- | ------------------------------------------------------------ | | code | num | 返回值 | 0：成功
-101：账号未登录
-400：请求错误
22104：该分组不存在
-101：账号未登录 | @@ -666,7 +680,7 @@ http://api.bilibili.com/x/relation/tags | ---- | ---- | ---- | ------------ | | path | str | 空 | 作用尚不明确 | -示例： +**示例：** 以每页2项的方式获取了ID为`207542`分组的第1页的粉丝明细 @@ -733,7 +747,7 @@ http://api.bilibili.com/x/relation/tag?tagid=207542&ps=2&pn=1 需要登录(SESSDATA) -参数： +**参数：** | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ----------- | ------ | ---- | @@ -741,6 +755,8 @@ http://api.bilibili.com/x/relation/tag?tagid=207542&ps=2&pn=1 **json回复：** +根对象： + | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | ------------------------------------------------- | | code | num | 返回值 | 0：成功
-101：账号未登录
-400：请求错误 | @@ -756,7 +772,7 @@ http://api.bilibili.com/x/relation/tag?tagid=207542&ps=2&pn=1 | ｛加入的分组ID n｝ | str | 分组n名称 | | | …… | str | …… | | -示例： +**示例：** 查询用户`UID=319214221`存在的所有分组ID和名称 @@ -786,7 +802,7 @@ http://api.bilibili.com/x/relation/tag/user?fid=319214221 需要登录(SESSDATA) -参数（ application/x-www-form-urlencoded ）： +**参数（ application/x-www-form-urlencoded ）：** | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ------------------- | ------ | ---------- | @@ -795,6 +811,8 @@ http://api.bilibili.com/x/relation/tag/user?fid=319214221 **json回复：** +根对象： + | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | ------------------------------------------------------------ | | code | num | 返回值 | 0：成功
-111：csrf校验失败
-101：账号未登录
-400：请求错误
22106：该分组已经存在
22103：分组名过长 | @@ -808,7 +826,7 @@ http://api.bilibili.com/x/relation/tag/user?fid=319214221 | ----- | ---- | -------------- | ---- | | tagid | num | 创建的分组的ID | | -示例： +**示例：** 创建了名为`vUP`的分组，得到ID为`216677` @@ -835,7 +853,7 @@ curl -b SESSDATA=xxx -d "tag=vUP&csrf=xxx" http://api.bilibili.com/x/relation/ta 需要登录(SESSDATA) -参数（ application/x-www-form-urlencoded ）： +**参数（ application/x-www-form-urlencoded ）：** | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ------------------- | ------ | ---------- | @@ -845,13 +863,15 @@ curl -b SESSDATA=xxx -d "tag=vUP&csrf=xxx" http://api.bilibili.com/x/relation/ta **json回复：** +根对象： + | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | ------------------------------------------------------------ | | code | num | 返回值 | 0：成功
-111：csrf校验失败
-101：账号未登录
-400：请求错误
22103：分组名过长
22104：该分组不存在 | | message | str | 错误信息 | 默认为0 | | ttl | num | 1 | 作用尚不明确 | -示例： +**示例：** 把ID为`194112`的分组更名为`膜法师` @@ -877,7 +897,7 @@ curl -b SESSDATA=xxx -d "tagid=194112&name=%e8%86%9c%e6%b3%95%e5%b8%88&csrf=xxx" 需要登录(SESSDATA) -参数（ application/x-www-form-urlencoded ）： +**参数（ application/x-www-form-urlencoded ）：** | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ------------------- | ------ | ---- | @@ -886,6 +906,8 @@ curl -b SESSDATA=xxx -d "tagid=194112&name=%e8%86%9c%e6%b3%95%e5%b8%88&csrf=xxx" **json回复：** +根对象： + | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | ------------------------------------------------------------ | | code | num | 返回值 | 0：成功
-111：csrf校验失败
-101：账号未登录
-400：请求错误 | @@ -918,7 +940,7 @@ curl -b SESSDATA=xxx -d "tagid=216699&csrf=xxx" http://api.bilibili.com/x/relati 需要登录(SESSDATA) -参数（ application/x-www-form-urlencoded ）： +**参数（ application/x-www-form-urlencoded ）：** | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ------------------- | ------ | -------------------------- | @@ -928,13 +950,15 @@ curl -b SESSDATA=xxx -d "tagid=216699&csrf=xxx" http://api.bilibili.com/x/relati **json回复：** +根对象： + | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | ------------------------------------------------------------ | | code | num | 返回值 | 0：成功
-111：csrf校验失败
-101：账号未登录
-400：请求错误
22104：无权限
22105：未关注 | | message | str | 错误信息 | 默认为0 | | ttl | num | 1 | 作用尚不明确 | -示例： +**示例：** 把关注用户`UID=205631797`同时添加分组关系到ID为`-10`和`207542`的分组中 @@ -958,7 +982,7 @@ curl -b SESSDATA=xxx -d "fids=205631797&tagids=-10%2C207542&csrf=xxx" http://api 需要登录(SESSDATA) -参数（ application/x-www-form-urlencoded ）： +**参数（ application/x-www-form-urlencoded ）：** | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ------------------- | ------ | -------------------------- | @@ -968,13 +992,15 @@ curl -b SESSDATA=xxx -d "fids=205631797&tagids=-10%2C207542&csrf=xxx" http://api **json回复：** +根对象： + | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | ------------------------------------------------------------ | | code | num | 返回值 | 0：成功
-111：csrf校验失败
-101：账号未登录
-400：请求错误
22104：无权限
22105：未关注 | | message | str | 错误信息 | 默认为0 | | ttl | num | 1 | 作用尚不明确 | -示例： +**示例：** 把关注用户`UID=4856007`和`UID=326499679`同时复制到ID为`231305`的分组中 @@ -998,7 +1024,7 @@ curl -b SESSDATA=xxx -d "fids=4856007%2C326499679&tagids=231305&csrf=xxx" http:/ 需要登录(SESSDATA) -参数（ application/x-www-form-urlencoded ）： +**参数（ application/x-www-form-urlencoded ）：** | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------------ | ---- | ------------------- | ------ | -------------------------- | @@ -1009,12 +1035,16 @@ curl -b SESSDATA=xxx -d "fids=4856007%2C326499679&tagids=231305&csrf=xxx" http:/ **json回复：** +根对象： + | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | ------------------------------------------------------------ | | code | num | 返回值 | 0：成功
-111：csrf校验失败
-101：账号未登录
-400：请求错误
22104：无权限
22105：未关注 | | message | str | 错误信息 | 默认为0 | | ttl | num | 1 | 作用尚不明确 | +**示例：** + 把关注用户`UID=3211734 69`和`UID=327086920`同时从ID为`207542`的分组移动到ID为`231305`的分组中 diff --git a/user/space.md b/user/space.md index 0b1d799..af27e6e 100644 --- a/user/space.md +++ b/user/space.md @@ -10,7 +10,7 @@ 粉丝在其主页上可见 -参数： +**参数：** | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ----------- | ------ | ---- | @@ -18,6 +18,8 @@ **json回复：** +根对象： + | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | ---------------------------------------------------- | | code | num | 返回值 | 0：成功
-400：请求错误
53016：没有置顶视频 | @@ -29,7 +31,7 @@ 基本同「[视频详细信息](https://github.com/SocialSisterYi/bilibili-API-collect/blob/master/video/info.md#视频详细信息（avID/bvID互转）)」中的data对象 -示例： +**示例：** 查询用户`UID=23215368`的置顶视频 @@ -112,7 +114,7 @@ http://api.bilibili.com/x/space/top/arc?vmid=23215368 最多可以设置3个 -参数： +**参数：** | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ----------- | ------ | ---- | @@ -120,6 +122,8 @@ http://api.bilibili.com/x/space/top/arc?vmid=23215368 **json回复：** +根对象： + | 字段 | 类型 | 内容 | 备注 | | ------- | ------ | ---------- | --------------------------- | | code | num | 返回值 | 0：成功
-400：请求错误 | @@ -139,7 +143,7 @@ http://api.bilibili.com/x/space/top/arc?vmid=23215368 基本同「[视频详细信息](https://github.com/SocialSisterYi/bilibili-API-collect/blob/master/video/info.md#视频详细信息（avID/bvID互转）)」中的data对象 -示例： +**示例：** 查询用户`UID=23215368`的代表作视频列表 @@ -333,7 +337,7 @@ http://api.bilibili.com/x/space/masterpiece?vmid=23215368 *方式:GET* -参数： +**参数：** | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ----------- | ------ | ---- | @@ -343,6 +347,8 @@ http://api.bilibili.com/x/space/masterpiece?vmid=23215368 **json回复：** +根对象： + | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | --------------------------- | | code | num | 返回值 | 0：成功
-400：请求错误 | @@ -419,7 +425,7 @@ http://api.bilibili.com/x/space/masterpiece?vmid=23215368 | pn | num | 当前页码 | | | ps | num | 每页项数 | | -示例： +**示例：** `pn`（页码）和`ps`（每页项数）只改变`vlist`中成员的多少与内容 @@ -519,7 +525,7 @@ http://api.bilibili.com/x/space/arc/search?mid=53456&ps=2&pn=1 带有转义，且只能获取最多15条 -参数： +**参数：** | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ----------- | ------ | ---- | @@ -527,6 +533,8 @@ http://api.bilibili.com/x/space/arc/search?mid=53456&ps=2&pn=1 **json回复：** +根对象： + | 字段 | 类型 | 内容 | 备注 | | ------ | ------------------------ | ---------------------------------- | --------------------------- | | status | bool | 状态 | false：失败
true：成功 | @@ -565,7 +573,7 @@ http://api.bilibili.com/x/space/arc/search?mid=53456&ps=2&pn=1 | title | str | 标题 | | | total_count | num | 总计集数 | 未完结：-1
已完结：非0正整数 | -示例： +**示例：** 查看用户`UID=14082`的追番预览列表 @@ -618,7 +626,7 @@ http://space.bilibili.com/ajax/Bangumi/getList?mid=14082 *方式:GET* -参数： +**参数：** | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ----------- | ------ | -------------------- | @@ -629,6 +637,8 @@ http://space.bilibili.com/ajax/Bangumi/getList?mid=14082 **json回复：** +根对象： + | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | ---------------------------------------------------------- | | code | num | 返回值 | 0：成功
-400：请求错误
53013：用户隐私设置未公开 | @@ -657,7 +667,7 @@ http://space.bilibili.com/ajax/Bangumi/getList?mid=14082 基本同「番剧详细信息」中的result对象（未完工） -示例： +**示例：** 查看用户`UID=14082`的追番明细 @@ -864,7 +874,7 @@ http://api.bilibili.com/x/space/bangumi/follow/list?vmid=14082&pn=1&ps=2&type=1 所有类型的相簿 -参数： +**参数：** | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ------------ | ------ | ------- | @@ -873,6 +883,8 @@ http://api.bilibili.com/x/space/bangumi/follow/list?vmid=14082&pn=1&ps=2&type=1 **json回复：** +根对象： + | 字段 | 类型 | 内容 | 备注 | | ------- | ------ | -------- | --------------------------- | | code | num | 返回值 | 0：成功
-400：请求错误 | @@ -919,7 +931,7 @@ http://api.bilibili.com/x/space/bangumi/follow/list?vmid=14082&pn=1&ps=2&type=1 | img_src | str | 图片url | | | img_width | num | 图片宽度 | | -示例： +**示例：** 查询用户`UID=53456`的投稿相簿预览 @@ -982,7 +994,7 @@ http://api.bilibili.com/x/space/album/index?mid=53456&ps=2 *方式:GET* -参数： +**参数：** | 参数名 | 类型 | 内容 | 必要性 | 备注 | | --------- | ---- | ----------- | ------ | ------------------------------------------------------------ | @@ -993,6 +1005,8 @@ http://api.bilibili.com/x/space/album/index?mid=53456&ps=2 **json回复：** +根对象： + | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | ------------- | | code | num | 返回值 | 0：成功 | @@ -1045,7 +1059,7 @@ http://api.bilibili.com/x/space/album/index?mid=53456&ps=2 | img_src | str | 图片url | | | img_width | num | 图片宽度 | | -示例： +**示例：** 查询用户`UID=53456`的投稿明细中的全部类型 @@ -1117,7 +1131,7 @@ http://api.vc.bilibili.com/link_draw/v1/doc/doc_list?uid=2&page_num=1&page_size= *方式:GET* -参数： +**参数：** | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ----------- | ------ | ---- | @@ -1125,6 +1139,8 @@ http://api.vc.bilibili.com/link_draw/v1/doc/doc_list?uid=2&page_num=1&page_size= **json回复：** +根对象： + | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | ------------ | | code | num | 返回值 | 0：成功 | @@ -1159,7 +1175,7 @@ http://api.vc.bilibili.com/link_draw/v1/doc/doc_list?uid=2&page_num=1&page_size= | mtime | num | 创建时间 | 时间戳 | | name | str | 标题 | | -示例： +**示例：** 查询用户`UID=53456`的频道列表 @@ -1233,7 +1249,7 @@ http://api.bilibili.com/x/space/channel/list?mid=53456 *方式:GET* -参数： +**参数：** | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ----------- | ------ | --------- | @@ -1244,6 +1260,8 @@ http://api.bilibili.com/x/space/channel/list?mid=53456 **json回复：** +根对象： + | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | ------------------------------------------------------- | | code | num | 返回值 | 0：成功
-400：请求错误
-404：无用户对应的频道 | @@ -1291,7 +1309,7 @@ http://api.bilibili.com/x/space/channel/list?mid=53456 | num | num | 当前页码 | | | size | num | 每页项数 | | -示例： +**示例：** 查询用户`UID=53456`的频道`170`中的视频 @@ -1441,7 +1459,7 @@ http://api.bilibili.com/x/space/channel/video?mid=53456&cid=170&ps=2&pn=1 *方式:GET* -参数： +**参数：** | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ----------- | ------ | ---- | @@ -1449,6 +1467,8 @@ http://api.bilibili.com/x/space/channel/video?mid=53456&cid=170&ps=2&pn=1 **json回复：** +根对象： + | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | --------------------------- | | code | num | 返回值 | 0：成功
-400：请求错误 | @@ -1456,7 +1476,7 @@ http://api.bilibili.com/x/space/channel/video?mid=53456&cid=170&ps=2&pn=1 | ttl | num | 1 | 作用尚不明确 | | data | str | 公告信息 | 无则为空 | -示例： +**示例：** 查看用户`UID=53456`的空间公告 @@ -1483,7 +1503,7 @@ http://api.bilibili.com/x/space/notice?mid=53456 带有转义 -参数： +**参数：** | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ----------- | ------ | ---- | @@ -1491,6 +1511,8 @@ http://api.bilibili.com/x/space/notice?mid=53456 **json回复：** +根对象： + | 字段 | 类型 | 内容 | 备注 | | ------- | ------ | -------- | --------------------------- | | code | num | 返回值 | 0：成功
-400：请求错误 | @@ -1520,7 +1542,7 @@ http://api.bilibili.com/x/space/notice?mid=53456 | …… | str | …… | | | 4 | str | TAG5 | 上限5条 | -示例： +**示例：** 查看用户`UID=53456`的个人TAG diff --git a/user/status_number.md b/user/status_number.md index 544956c..c227741 100644 --- a/user/status_number.md +++ b/user/status_number.md @@ -5,13 +5,16 @@ *方式:GET* -参数： +**参数：** + | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ----------- | ------ | ---- | | vmid | url | 目标用户UID | 必要 | | **json回复：** +根对象： + | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | --------------------------- | | code | num | 返回值 | 0：成功
-400：请求错误 | @@ -29,7 +32,7 @@ | black | num | 黑名单数 | 需要登录(SESSDATA)
只能查看自己的
默认为0 | | follower | num | 粉丝数 | | -示例： +**示例：** 查询用户`UID=332704117`的关系状态数 @@ -58,13 +61,16 @@ http://api.bilibili.com/x/relation/stat?vmid=332704117 *方式:GET* -参数： +**参数：** + | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ----------- | ------ | ---- | | mid | url | 目标用户UID | 必要 | | - **json回复：** + +根对象： + | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | --------------------------- | | code | num | 返回值 | 0：成功
-400：请求错误 | @@ -92,7 +98,7 @@ http://api.bilibili.com/x/relation/stat?vmid=332704117 | ---- | ----- | ---------- | ----- | | view | num | 专栏阅读量 | | -示例： +**示例：** 查询用户`UID=456664753`的UP主状态数 @@ -122,13 +128,16 @@ http://api.bilibili.com/x/space/upstat?mid=456664753 *方式:GET* -参数： +**参数：** + | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ----------- | ------ | ---- | | mid | url | 目标用户UID | 必要 | | **json回复：** +根对象： + | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | --------------------------- | | code | num | 返回值 | 0：成功
-400：请求错误 | @@ -166,7 +175,7 @@ http://api.bilibili.com/x/space/upstat?mid=456664753 | master | num | 全部收藏夹数 | 需要登录(SESSDATA)
只能查看自己的 | | guest | num | 公开收藏夹数 | 无视隐私设置 | -示例： +**示例：** 查询用户`UID=239202390`的订阅&投稿状态数 @@ -206,7 +215,7 @@ http://api.bilibili.com/x/space/navnum?mid=239202390 *方式：GET* -参数： +**参数：** | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ----------- | ------ | ---- | @@ -214,6 +223,8 @@ http://api.bilibili.com/x/space/navnum?mid=239202390 **json回复：** +根对象： + | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | ------------- | | code | num | 返回值 | 0：成功 | @@ -230,7 +241,7 @@ http://api.bilibili.com/x/space/navnum?mid=239202390 | photo_count | num | 发布摄影数 | | | daily_count | num | 发布日常（图片动态）数 | | -示例： +**示例：** 查询用户`UID=53456`的投稿相簿数 diff --git a/video/info.md b/video/info.md index 1c7b197..db8f352 100644 --- a/video/info.md +++ b/video/info.md @@ -8,7 +8,7 @@ *方式:GET* -参数： +**参数：** | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | -------- | ------ | ------------------ | @@ -17,6 +17,8 @@ **json回复：** +根对象： + | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | --------------------------------------------- | | code | num | 返回值 | 0：成功
-400：请求错误
-404：无视频 | @@ -204,7 +206,7 @@ | desc | str | 成员认证备注 | 无为空 | | type | num | 成员认证类型 | -1：无
0：有 | -示例： +**示例：** http://api.bilibili.com/x/web-interface/view?aid=85440373 @@ -353,7 +355,7 @@ http://i0.hdslb.com/bfs/face/5387950a59be8038daaae3f66dfb5a85e20d5737.jpg *方式:GET* -参数： +**参数：** | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | -------- | ------ | ------------------ | @@ -362,6 +364,8 @@ http://i0.hdslb.com/bfs/face/5387950a59be8038daaae3f66dfb5a85e20d5737.jpg **json回复：** +根对象： + | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | -------------------------------------------------- | | code | num | 返回值 | 0：成功
-400：请求错误
62002：稿件不可见 | @@ -369,7 +373,7 @@ http://i0.hdslb.com/bfs/face/5387950a59be8038daaae3f66dfb5a85e20d5737.jpg | ttl | num | 1 | 作用尚不明确 | | data | str | 简介内容 | | -示例： +**示例：** 查看视频~~（教主的咕鸽）~~`av39330059`/`BV1Bt411z799`的简介 @@ -394,7 +398,7 @@ http://api.bilibili.com/x/web-interface/archive/desc?aid=39330059 *方式:GET* -参数： +**参数：** | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | -------- | ------ | ------------------ | @@ -403,6 +407,8 @@ http://api.bilibili.com/x/web-interface/archive/desc?aid=39330059 **json回复：** +根对象： + | 字段 | 类型 | 内容 | 备注 | | ------- | ----- | -------- | --------------------------------------------- | | code | num | 返回值 | 0：成功
-400：请求错误
-404：无视频 | @@ -439,7 +445,7 @@ http://api.bilibili.com/x/web-interface/archive/desc?aid=39330059 | height | num | 当前分P 高度 | 可能为0 | | rotate | num | 0 | 作用尚不明确 | -示例： +**示例：** 查询视频`av13502509`/`BV1ex411J7GE`的分P列表 diff --git a/video/like_coin_fav.md b/video/like_coin_fav.md index 828f526..3d8901c 100644 --- a/video/like_coin_fav.md +++ b/video/like_coin_fav.md @@ -12,7 +12,7 @@ *方式：POST* -参数（ application/x-www-form-urlencoded ）： +**参数（ application/x-www-form-urlencoded ）：** | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ------------------- | ------ | ---------------------- | @@ -23,13 +23,15 @@ **json回复：** +根对象： + | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | ------------------------------------------------------------ | | code | num | 返回值 | 0：成功
-101：账号未登录
-111：csrf校验失败
-400：请求错误
10003：不存在该稿件
65006：已赞过
65004：取消点赞失败 | | message | str | 错误信息 | 默认为0 | | ttl | num | 1 | 作用尚不明确 | -示例： +**示例：** 为视频av79677524/BV1uJ411r7hL点赞 @@ -55,7 +57,7 @@ curl -b "SESSDATA=xxx" -d "aid=79677524&like=1&csrf=xxx" "http://api.bilibili.co *方式：POST* -参数（ application/x-www-form-urlencoded ）： +**参数（ application/x-www-form-urlencoded ）：** | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ----------- | ---- | ------------------- | ------ | --------------------------------------- | @@ -67,6 +69,8 @@ curl -b "SESSDATA=xxx" -d "aid=79677524&like=1&csrf=xxx" "http://api.bilibili.co **json回复：** +根对象： + | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | ------------------------------------------------------------ | | code | num | 返回值 | 0：成功
-101：账号未登录
-102：账号被封停
-104：硬币不足
-111：csrf校验失败
-400：请求错误
10003：不存在该稿件
34002：不能给自己投币
34003：非法的投币数量
34005：超过投币上限 | @@ -80,7 +84,7 @@ data 对象： | ---- | ---- | ------------ | ----------------------------------------------------- | | like | bool | 是否点赞成功 | true：成功
false：失败
已赞过则附加点赞失败 | -示例： +**示例：** 为视频`av90671873`/`BV1N7411A7wC`投币2枚 @@ -111,7 +115,7 @@ curl -b "SESSDATA=xxx" -d "aid=90671873&select_like=1&multiply=2&csrf=xxx" "http 需要验证referer为 `http://www.bilibili.com`或`https://www.bilibili.com`域名下 -参数（ application/x-www-form-urlencoded ）： +**参数（ application/x-www-form-urlencoded ）：** | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------------- | ---- | ------------------- | ------ | ----------------------- | @@ -123,6 +127,8 @@ curl -b "SESSDATA=xxx" -d "aid=90671873&select_like=1&multiply=2&csrf=xxx" "http **json回复：** +根对象： + | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | ------------------------------------------------------------ | | code | num | 返回值 | 0：成功
-101：账号未登录
-111：csrf校验失败
-400：请求错误
-403：访问权限不足
10003：不存在该稿件
11201：已经收藏过了
11202：已经取消收藏了
72010017：参数错误 | @@ -135,7 +141,7 @@ curl -b "SESSDATA=xxx" -d "aid=90671873&select_like=1&multiply=2&csrf=xxx" "http | ------ | ---- | ----- | ------------ | | prompt | bool | false | 作用尚不明确 | -示例： +**示例：** 将视频`av49166435`添加到收藏夹`49166435`中 @@ -163,7 +169,7 @@ curl --referer "http://www.bilibili.com" -b "SESSDATA=xxx" -d "rid=90671873&type 同时点赞投币收藏视频，收藏于默认收藏夹中 -参数（ application/x-www-form-urlencoded ）： +**参数（ application/x-www-form-urlencoded ）：** | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ------------------- | ------ | ------------------ | @@ -173,6 +179,8 @@ curl --referer "http://www.bilibili.com" -b "SESSDATA=xxx" -d "rid=90671873&type **json回复：** +根对象： + | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | ------------------------------------------------------------ | | code | num | 返回值 | 0：成功
-101：账号未登录
-111：csrf校验失败
-400：请求错误
10003：不存在该稿件 | @@ -189,7 +197,7 @@ curl --referer "http://www.bilibili.com" -b "SESSDATA=xxx" -d "rid=90671873&type | fav | bool | 是否收藏成功 | | | multiply | num | 投币枚数 | 默认为2 | -示例： +**示例：** 将视频`av91003840`/`BV1Wj411f79U`一键三连 @@ -223,7 +231,7 @@ curl -b "SESSDATA=xxx" -d "aid=91003840&csrf=xxx" "http://api.bilibili.com/x/web *方式:GET* -参数： +**参数：** | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ------------------ | ------ | ---- | @@ -231,6 +239,8 @@ curl -b "SESSDATA=xxx" -d "aid=91003840&csrf=xxx" "http://api.bilibili.com/x/web **json回复：** +根对象： + | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | ------------------------------------------------- | | code | num | 返回值 | 0：成功
-400：请求错误
-101：账号未登录 | @@ -245,7 +255,7 @@ data 对象： | count | num | 1 | 作用尚不明确 | | favoured | bool | 是否收藏 | true：已收藏
false：未收藏 | -示例： +**示例：** 视频`av46281123`/`BV1Bb411H7Dv`的状态为已收藏 @@ -275,7 +285,7 @@ http://api.bilibili.com/x/v2/fav/video/favoured?aid=46281123 *方式:GET* -参数： +**参数：** | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | -------- | ------ | ------------------ | @@ -284,6 +294,8 @@ http://api.bilibili.com/x/v2/fav/video/favoured?aid=46281123 **json回复：** +根对象： + | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | ---------- | ------------------------------------------------- | | code | num | 返回值 | 0：成功
-400：请求错误
-101：账号未登录 | @@ -291,7 +303,7 @@ http://api.bilibili.com/x/v2/fav/video/favoured?aid=46281123 | ttl | num | 1 | 作用尚不明确 | | data | num | 被点赞标志 | 0：未点赞
1：已点赞 | -示例： +**示例：** 视频`av39330059`/`BV1Bt411z799`的状态为已点赞 @@ -318,7 +330,7 @@ http://api.bilibili.com/x/web-interface/archive/has/like?aid=39330059 *方式:GET* -参数： +**参数：** | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | -------- | ------ | ------------------ | @@ -327,6 +339,8 @@ http://api.bilibili.com/x/web-interface/archive/has/like?aid=39330059 **json回复：** +根对象： + | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | ------------------------------------------------- | | code | num | 返回值 | 0：成功
-400：请求错误
-101：账号未登录 | @@ -340,7 +354,7 @@ http://api.bilibili.com/x/web-interface/archive/has/like?aid=39330059 | -------- | ---- | -------- | --------- | | multiply | num | 投币枚数 | 未投币为0 | -示例： +**示例：** 视频`av37896701`/`BV18t411q7zz`的投币数为2枚 diff --git a/video/recommend.md b/video/recommend.md index 0419da5..bf4d8f9 100644 --- a/video/recommend.md +++ b/video/recommend.md @@ -8,7 +8,7 @@ 最多获取40条推荐视频 -参数： +**参数：** | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | -------- | ------ | ------------------ | @@ -17,6 +17,8 @@ **json回复：** +根对象： + | 字段 | 类型 | 内容 | 备注 | | ------- | ------ | -------- | ---------------------------- | | code | num | 返回值 | 0：成功
-400：请求错误 | @@ -37,7 +39,7 @@ 基本同「[视频详细信息](info.md#视频详细信息)」中的data对象 -示例： +**示例：** 查询视频`av7`/`BV1xx411c7m9`的推荐视频列表 diff --git a/video/snapshot.md b/video/snapshot.md index 617331c..49ac8d3 100644 --- a/video/snapshot.md +++ b/video/snapshot.md @@ -11,7 +11,8 @@ *方式:GET* -参数： +**参数：** + | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ------------------ | ------ | ----------------------------------- | | aid | url | 视频avID | 非必要 | avID与bvID任选一个 | @@ -21,6 +22,8 @@ **json回复：** +根对象： + | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | ------------------------------------------------ | | code | num | 返回值 | 0：成功
40001：请求错误
40003：无视频 | @@ -57,7 +60,7 @@ | n | num | 图片n 截取时间 | 单位为秒 | | …… | num | …… | 单位为秒 | -示例： +**示例：** http://api.bilibili.com/x/player/videoshot?aid=26273789&index=1 @@ -90,12 +93,16 @@ http://api.bilibili.com/x/player/videoshot?aid=26273789&index=1 内容与「获取视频快照1」加参数「index」=1相同，但url带有转义，仅限第1P +**参数：** + | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | -------- | ------ | ---- | | aid | url | 视频avID | 必要 | | **json回复：** +根对象： + | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | ---------------------------------------------- | | code | num | 返回值 | 0：成功
40001：请求错误
-404：无视频 | @@ -132,7 +139,7 @@ http://api.bilibili.com/x/player/videoshot?aid=26273789&index=1 | n | num | 图片n 截取时间 | 单位为秒 | | …… | num | …… | 单位为秒 | -示例： +**示例：** http://api.bilibili.com/pvideo?aid=26273789 diff --git a/video/status_number.md b/video/status_number.md index f76bd8f..b66ce89 100644 --- a/video/status_number.md +++ b/video/status_number.md @@ -5,13 +5,16 @@ *方式:GET* -参数： +**参数：** + | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | -------- | ------ | ---- | | aid | url | 视频avID | 必要 | | **json回复：** +根对象： + | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | ----------------------------------------------- | | code | num | 返回值 | 0：成功
40001：请求错误
40003：无视频 | @@ -37,7 +40,7 @@ | no_reprint | num | 禁止转载标志 | 0：无
1：禁止 | | copyright | num | 版权标志 | 1：自制
2：转载 | -示例： +**示例：** 查询视频`av91572143`的状态数 @@ -80,7 +83,8 @@ http://api.bilibili.com/archive_stat/stat?aid=91572143 **此API克python，UA中只要存在\*python\*字眼就无法获取正确内容，如用py请改UA** -参数： +**参数：** + | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | -------- | ------ | ------------------ | | aid | url | 视频avID | 非必要 | avID与bvID任选一个 | @@ -88,6 +92,8 @@ http://api.bilibili.com/archive_stat/stat?aid=91572143 **json回复：** +根对象： + | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | ----------------------------------------------- | | code | num | 返回值 | 0：成功
-400：请求错误
40003：无视频 | @@ -116,7 +122,7 @@ http://api.bilibili.com/archive_stat/stat?aid=91572143 | argue_msg | str | 警告信息 | 默认为空 | | evaluation | str | 视频评分 | 默认为空 | -示例： +**示例：** 查询视频`av2271112`/`BV1es411D7sW`的状态数