From e379d904c2753fa30e9083f59016f07e89d19467 Mon Sep 17 00:00:00 2001 From: SocialSisterYi <1440239038@qq.com> Date: Tue, 6 Jun 2023 11:02:19 +0800 Subject: [PATCH] =?UTF-8?q?update=E3=80=90=E7=94=A8=E6=88=B7=E5=85=B3?= =?UTF-8?q?=E7=B3=BB=E3=80=91APIDoc?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/user/relation.md | 1724 +++++++++++++++++------------------------ 1 file changed, 711 insertions(+), 1013 deletions(-) diff --git a/docs/user/relation.md b/docs/user/relation.md index 375ed95..1ac2891 100644 --- a/docs/user/relation.md +++ b/docs/user/relation.md @@ -1,73 +1,42 @@ # 用户关系相关 -## 查询用户粉丝明细 +## 查询关系列表 -> https://api.bilibili.com/x/relation/followers +### 关系列表对象 -*请求方式：GET* +| 字段 | 类型 | 内容 | 备注 | +| --------------- | ------------------------------------------- | --------------- | ------------------------------------------------------------ | +| mid | num | 用户 mid | | +| attribute | num | 关注属性 | 0：未关注
1：已关注
2：已关注
6：已互粉
128：已拉黑 | +| mtime | num | 关注对方时间 | 时间戳
互关后刷新 | +| tag | 默认分组：null
存在至少一个分组：array | 分组 id | | +| special | num | 特别关注标志 | 0：否
1：是 | +| contract_info | obj | （？） | | +| uname | str | 用户昵称 | | +| face | str | 用户头像url | | +| face_nft | num | 是否为 NFT 头像 | 0：非 NFT 头像
1：NFT 头像 | +| sign | str | 用户签名 | | +| official_verify | obj | 认证信息 | | +| vip | obj | 会员信息 | | +| nft_icon | str | （？） | | +| rec_reason | str | （？） | | +| track_id | str | （？） | | -认证方式：Cookie(SESSDATA)或APP +数组`list`中的对象中的`tag`数组： -登录可看自己前1000名，其他用户可查看前250名（网页端请求时ps为20，所以直接查看只能看到前100名） - -**url参数：** - -| 参数名 | 类型 | 内容 | 必要性 | 备注 | -| ---------- | ---- | ------------ | ----------- | ---------------------------------- | -| access_key | str | APP登录Token | APP方式必要 | | -| vmid | num | 目标用户mid | 必要 | | -| ps | num | 每页项数 | 非必要 | 默认为50 | -| pn | num | 页码 | 非必要 | 默认为1
其他用户仅可查看前5页 | - -**json回复：** - -根对象： - -| 字段 | 类型 | 内容 | 备注 | -| ------- | ---- | -------- | --------------------------------------------------- | -| code | num | 返回值 | 0：成功
-400：请求错误
22007：访问超过5页 | -| message | str | 错误信息 | 默认为0 | -| ttl | num | 1 | | -| data | obj | 信息本体 | | - -`data`对象： - -| 字段 | 类型 | 内容 | 备注 | -| ---------- | ----- | -------- | ------------ | -| list | array | 明细列表 | | -| re_version | num | ？？？ | 作用尚不明确 | -| total | num | 粉丝总数 | | - -`data`中的`list`数组： - -| 项 | 类型 | 内容 | 备注 | -| ---- | ---- | --------- | ---------------- | -| 0 | obj | 粉丝1 | | -| n | obj | 粉丝(n+1) | 按照关注顺序排列 | -| …… | obj | …… | …… | - -`list`中的对象： - -| 字段 | 类型 | 内容 | 备注 | -| --------------- | ---- | ------------ | --------------------------------------- | -| mid | num | 用户mid | | -| attribute | num | 关注属性 | 0：未关注
2：已关注
6：已互粉 | -| mtime | num | 成为粉丝时间 | 时间戳
互关后刷新 | -| tag | null | | | -| special | num | 0 | | -| uname | str | 用户昵称 | | -| face | str | 用户头像url | | -| sign | str | 用户签名 | | -| official_verify | obj | 认证信息 | | -| vip | obj | 会员信息 | | +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | ------------------------ | ---- | +| 0 | num | 位于分组 1 的分组 id | | +| n | num | 位于分组（n+1）的分组 id | | +| …… | num | …… | …… | `list`中的对象中的`official_verify`对象： | 字段 | 类型 | 内容 | 备注 | | ---- | ---- | ------------ | ------------------- | -| type | num | 用户认证类型 | -1：无
0：个人认证
1：机构认证 | +| type | num | 用户认证类型 | -1：无
1：认证 | | desc | str | 用户认证信息 | 无为空 | `list`中的对象中的`vip`对象： @@ -76,18 +45,64 @@ | ------------- | ---- | ------------ | ----------------------------------------------- | | vipType | num | 会员类型 | 0：无
1：月度大会员
2：年度以上大会员 | | vipDueDate | num | 会员到期时间 | 时间戳 毫秒 | -| dueRemark | str | 空 | 作用尚不明确 | -| accessStatus | num | 0 | 作用尚不明确 | +| dueRemark | str | （？） | | +| accessStatus | num | （？） | | | vipStatus | num | 大会员状态 | 0：无
1：有 | -| vipStatusWarn | str | 空 | 作用尚不明确 | -| themeType | num | 0 | 作用尚不明确 | -| label | obj | ？？？ | 作用尚不明确 | +| vipStatusWarn | str | （？） | | +| themeType | num | （？） | | +| label | obj | （？） | | `vip`中的`label`对象： -| 字段 | 类型 | 内容 | 备注 | -| ---- | ---- | ---- | ------------ | -| path | str | 空 | 作用尚不明确 | +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ------ | ---- | +| path | str | （？） | | + +### 查询用户粉丝明细 + +> https://api.bilibili.com/x/relation/followers + +*请求方式：GET* + +认证方式：Cookie（SESSDATA）或 APP + +登录可看当前用户前 1000 名，其他用户可查看前 250 名（网页端请求时`ps`为 20，所以直接查看只能看到前 100 名） + +**url参数：** + +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| ---------- | ---- | -------------- | ------------ | ------------------------------------- | +| access_key | str | APP 登录 Token | APP 方式必要 | | +| vmid | num | 目标用户 mid | 必要 | | +| ps | num | 每页项数 | 非必要 | 默认为 50 | +| pn | num | 页码 | 非必要 | 默认为 1
其他用户仅可查看前 5 页 | + +**json回复：** + +根对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------- | ---- | -------- | ----------------------------------------------------- | +| code | num | 返回值 | 0：成功
-400：请求错误
22007：访问超过 5 页 | +| message | str | 错误信息 | 默认为 0 | +| ttl | num | 1 | | +| data | obj | 信息本体 | | + +`data`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ---------- | ----- | -------- | ---- | +| list | array | 明细列表 | | +| re_version | num | （？） | | +| total | num | 粉丝总数 | | + +`data`中的`list`数组： + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | ------------ | ---------------------------------- | +| 0 | obj | 粉丝 1 | 详见 [关系列表对象](#关系列表对象) | +| n | obj | 粉丝 （n+1） | 按照添加顺序排列 | +| …… | obj | …… | …… | **示例：** @@ -95,10 +110,10 @@ ```shell curl -G 'https://api.bilibili.com/x/relation/followers' \ ---data-urlencode 'vmid=293793435' \ ---data-urlencode 'ps=2' \ ---data-urlencode 'pn=1' \ --b 'SESSDATA=xxx' + --data-urlencode 'vmid=293793435' \ + --data-urlencode 'ps=2' \ + --data-urlencode 'pn=1' \ + -b 'SESSDATA=xxx' ```
@@ -169,27 +184,25 @@ curl -G 'https://api.bilibili.com/x/relation/followers' \
-## 查询用户关注明细 - - +### 查询用户关注明细 > https://api.bilibili.com/x/relation/followings *请求方式：GET* -认证方式：Cookie(SESSDATA)或APP +认证方式：Cookie（SESSDATA）或 APP -登录可看自己全部，其他用户仅可查看前5页 +登录可看当前用户全部，其他用户仅可查看前5页 **url参数：** -| 参数名 | 类型 | 内容 | 必要性 | 备注 | -| ---------- | ---- | ------------ | ----------- | ------------------------------------------------------- | -| access_key | str | APP登录Token | APP方式必要 | | -| vmid | num | 目标用户mid | 必要 | | -| order_type | str | 排序方式 | 非必要 | 按照关注顺序排列：留空
按照最常访问排列：attention | -| ps | num | 每页项数 | 非必要 | 默认为50 | -| pn | num | 页码 | 非必要 | 默认为1
其他用户仅可查看前5页 | +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| ---------- | ---- | -------------- | ------------ | ------------------------------------------------------- | +| access_key | str | APP 登录 Token | APP 方式必要 | | +| vmid | num | 目标用户 mid | 必要 | | +| order_type | str | 排序方式 | 非必要 | 按照关注顺序排列：留空
按照最常访问排列：attention | +| ps | num | 每页项数 | 非必要 | 默认为 50 | +| pn | num | 页码 | 非必要 | 默认为 1
其他用户仅可查看前 5 页 | **json回复：** @@ -197,75 +210,26 @@ curl -G 'https://api.bilibili.com/x/relation/followers' \ | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | ------------------------------------------------------------ | -| code | num | 返回值 | 0：成功
-400：请求错误
22007：访问超过5页
22115：用户已设置隐私，无法查看 | -| message | str | 错误信息 | 默认为0 | +| code | num | 返回值 | 0：成功
-400：请求错误
22007：访问超过 5 页
22115：用户已设置隐私，无法查看 | +| message | str | 错误信息 | 默认为 0 | | ttl | num | 1 | | | data | obj | 信息本体 | | `data`对象： -| 字段 | 类型 | 内容 | 备注 | -| ---------- | ----- | -------- | ------------ | -| list | array | 明细列表 | | -| re_version | num | ？？？ | 作用尚不明确 | -| total | num | 关注总数 | | +| 字段 | 类型 | 内容 | 备注 | +| ---------- | ----- | -------- | ---- | +| list | array | 明细列表 | | +| re_version | num | （？） | | +| total | num | 关注总数 | | `data`中的`list`数组： -| 项 | 类型 | 内容 | 备注 | -| ---- | ---- | --------- | ---------------- | -| 0 | obj | 关注1 | | -| n | obj | 关注(n+1) | 按照关注顺序排列 | -| …… | obj | …… | …… | - -数组`list`中的对象： - -| 字段 | 类型 | 内容 | 备注 | -| --------------- | ---------------------------------------- | ------------ | --------------------------------------- | -| mid | num | 用户mid | | -| attribute | num | 关注属性 | 0：未关注
2：已关注
6：已互粉 | -| mtime | num | 关注对方时间 | 时间戳
互关后刷新 | -| tag | 默认分组：null
存在至少一个分组：array | 分组id | | -| special | num | 特别关注标志 | 0：否
1：是 | -| uname | str | 用户昵称 | | -| face | str | 用户头像url | | -| sign | str | 用户签名 | | -| official_verify | obj | 认证信息 | | -| vip | obj | 会员信息 | | - -数组`list`中的对象中的`tag`数组： - -| 项 | 类型 | 内容 | 备注 | -| ---- | ---- | --------------------- | ---- | -| 0 | num | 位于分组1的分组id | | -| n | num | 位于分组(n+1)的分组id | | -| …… | num | …… | …… | - -`list`中的对象中的`official_verify`对象： - -| 字段 | 类型 | 内容 | 备注 | -| ---- | ---- | ------------ | ------------------- | -| type | num | 用户认证类型 | -1：无
1：认证 | -| desc | str | 用户认证信息 | 无为空 | - -`list`中的对象中的`vip`对象： - -| 字段 | 类型 | 内容 | 备注 | -| ------------- | ---- | ------------ | ----------------------------------------------- | -| vipType | num | 会员类型 | 0：无
1：月度大会员
2：年度以上大会员 | -| vipDueDate | num | 会员到期时间 | 时间戳 毫秒 | -| dueRemark | str | 空 | 作用尚不明确 | -| accessStatus | num | 0 | 作用尚不明确 | -| vipStatus | num | 大会员状态 | 0：无
1：有 | -| vipStatusWarn | str | 空 | 作用尚不明确 | -| themeType | num | 0 | 作用尚不明确 | -| label | obj | ？？？ | 作用尚不明确 | - -`vip`中的`label`对象： - -| 字段 | 类型 | 内容 | 备注 | -| ---- | ---- | ---- | ------------ | -| path | str | 空 | 作用尚不明确 | +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | ----------- | -------------------------------- | +| 0 | obj | 关注1 | 见 [关系列表对象](#关系列表对象) | +| n | obj | 关注（n+1） | 按照添加顺序排列 | +| …… | obj | …… | …… | **示例：** @@ -273,11 +237,11 @@ curl -G 'https://api.bilibili.com/x/relation/followers' \ ```shell curl -G 'https://api.bilibili.com/x/relation/followings' \ ---data-urlencode 'vmid=293793435' \ ---data-urlencode 'order_type=' \ ---data-urlencode 'ps=2' \ ---data-urlencode 'pn=1' \ --b 'SESSDATA=xxx' + --data-urlencode 'vmid=293793435' \ + --data-urlencode 'order_type=' \ + --data-urlencode 'ps=2' \ + --data-urlencode 'pn=1' \ + -b 'SESSDATA=xxx' ```
@@ -348,73 +312,72 @@ curl -G 'https://api.bilibili.com/x/relation/followings' \
-## 查询用户关注明细2 - - +### 查询用户关注明细2 > https://app.biliapi.net/x/v2/relation/followings *请求方式：GET* -仅可查看前5页，可以获取已设置可见性隐私的关注列表 +仅可查看前 5 页，可以获取已设置可见性隐私的关注列表 **url参数：** -| 参数名 | 类型 | 内容 | 必要性 | 备注 | -| ---------- | ---- | ------------ | ------ | -------------------------- | -| vmid | num | 目标用户mid | 必要 | | -| ps | num | 每页项数 | 非必要 | 默认为50 | -| pn | num | 页码 | 非必要 | 默认为1
仅可查看前5页 | +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| ------ | ---- | ------------ | ------ | ----------------------------- | +| vmid | num | 目标用户 mid | 必要 | | +| ps | num | 每页项数 | 非必要 | 默认为 50 | +| pn | num | 页码 | 非必要 | 默认为 1
仅可查看前 5 页 | **json回复：** 根对象： -| 字段 | 类型 | 内容 | 备注 | -| ------- | ---- | -------- | --------------------------------------------------- | -| code | num | 返回值 | 0：成功
-400：请求错误
22007：访问超过5页 | -| message | str | 错误信息 | 默认为0 | -| ttl | num | 1 | | -| data | obj | 信息本体 | | +| 字段 | 类型 | 内容 | 备注 | +| ------- | ---- | -------- | ----------------------------------------------------- | +| code | num | 返回值 | 0：成功
-400：请求错误
22007：访问超过 5 页 | +| message | str | 错误信息 | 默认为 0 | +| ttl | num | 1 | | +| data | obj | 信息本体 | | `data`对象： -| 字段 | 类型 | 内容 | 备注 | -| ---------- | ----- | -------- | ------------ | -| list | array | 明细列表 | | -| re_version | num | ？？？ | 作用尚不明确 | -| total | num | 关注总数 | | +| 字段 | 类型 | 内容 | 备注 | +| ---------- | ----- | -------- | ---- | +| list | array | 明细列表 | | +| re_version | num | （？） | | +| total | num | 关注总数 | | `data`中的`list`数组： -| 项 | 类型 | 内容 | 备注 | -| ---- | ---- | --------- | ---------------- | -| 0 | obj | 关注1 | | -| n | obj | 关注(n+1) | 按照关注顺序排列 | -| …… | obj | …… | …… | +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | ----------- | --------------------------------------------- | +| 0 | obj | 关注 1 | 与 [关系列表对象](#关系列表对象) 数据结构不同 | +| n | obj | 关注（n+1） | 按照添加顺序排列 | +| …… | obj | …… | …… | 数组`list`中的对象： | 字段 | 类型 | 内容 | 备注 | | --------------- | ---------------------------------------- | ------------ | --------------------------------------- | -| mid | num | 用户mid | | +| 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 | | +| face | str | 用户头像 url | | | sign | str | 用户签名 | | | official_verify | obj | 认证信息 | | | vip | obj | 会员信息 | | +| live | num | 是否直播 | 0：未直播
1：直播中 | 数组`list`中的对象中的`tag`数组： -| 项 | 类型 | 内容 | 备注 | -| ---- | ---- | --------------------- | ---- | -| 0 | num | 位于分组1的分组id | | -| n | num | 位于分组(n+1)的分组id | | -| …… | num | …… | …… | +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | ------------------------ | ---- | +| 0 | num | 位于分组 1 的分组 id | | +| n | num | 位于分组（n+1）的分组 id | | +| …… | num | …… | …… | `list`中的对象中的`official_verify`对象： @@ -429,18 +392,18 @@ curl -G 'https://api.bilibili.com/x/relation/followings' \ | ------------- | ---- | ------------ | ----------------------------------------------- | | vipType | num | 会员类型 | 0：无
1：月度大会员
2：年度以上大会员 | | vipDueDate | num | 会员到期时间 | 时间戳 毫秒 | -| dueRemark | str | 空 | 作用尚不明确 | -| accessStatus | num | 0 | 作用尚不明确 | +| dueRemark | str | （？） | | +| accessStatus | num | （？） | | | vipStatus | num | 大会员状态 | 0：无
1：有 | -| vipStatusWarn | str | 空 | 作用尚不明确 | -| themeType | num | 0 | 作用尚不明确 | -| label | obj | ？？？ | 作用尚不明确 | +| vipStatusWarn | str | （？） | | +| themeType | num | （？） | | +| label | obj | （？） | | `vip`中的`label`对象： -| 字段 | 类型 | 内容 | 备注 | -| ---- | ---- | ---- | ------------ | -| path | str | 空 | 作用尚不明确 | +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- | ------ | ---- | +| path | str | （？） | | **示例：** @@ -448,9 +411,9 @@ curl -G 'https://api.bilibili.com/x/relation/followings' \ ```shell curl -G 'https://app.biliapi.net/x/v2/relation/followings' \ ---data-urlencode 'vmid=293793435' \ ---data-urlencode 'ps=2' \ ---data-urlencode 'pn=1' \ + --data-urlencode 'vmid=293793435' \ + --data-urlencode 'ps=2' \ + --data-urlencode 'pn=1' \ ```
@@ -521,181 +484,48 @@ curl -G 'https://app.biliapi.net/x/v2/relation/followings' \
-## 查询用户关注明细3 - - - -> https://line3-h5-mobile-api.biligame.com/game/center/h5/user/relationship/following_list - -*请求方式：GET* - -可获取用户所有关注列表，对于设置了可见性隐私的用户会返回空列表 - -**url参数：** - -| 参数名 | 类型 | 内容 | 必要性 | 备注 | -| ------ | ---- | ------------ | ----------- | -------- | -| vmid | num | 目标用户mid | 必要 | | -| ps | num | 每页项数 | 非必要 | 默认为20 | -| pn | num | 页码 | 非必要 | 默认为1 | - -**json回复：** - -根对象： - -| 字段 | 类型 | 内容 | 备注 | -| ---------- | ---- | ---------- | --------------------------- | -| code | num | 返回值 | 0：成功
-400：请求错误 | -| message | str | 错误信息 | 成功时无此项 | -| data | obj | 信息本体 | 失败时无此项 | -| ts | num | 当前时间戳 | 单位为毫秒 | -| request_id | str | 请求id | | - -`data`对象： - -| 字段 | 类型 | 内容 | 备注 | -| ---------- | ----- | -------- | ------------ | -| list | array | 明细列表 | | - -`data`中的`list`数组： - -| 项 | 类型 | 内容 | 备注 | -| ---- | ---- | --------- | ---------------- | -| 0 | obj | 关注1 | | -| n | obj | 关注(n+1) | 按照关注顺序排列 | -| …… | obj | …… | …… | - -数组`list`中的对象： - -| 字段 | 类型 | 内容 | 备注 | -| --------------- | ---- | ----------- | --------------------------------------- | -| mid | str | 用户mid | | -| attribute | num | 关注属性 | 0：未关注
2：已关注
6：已互粉 | -| uname | str | 用户昵称 | | -| face | str | 用户头像url | | - -**示例：** - -获取用户`mid=293793435`的关注明细 - -```shell -curl -G 'https://line3-h5-mobile-api.biligame.com/game/center/h5/user/relationship/following_list' \ ---data-urlencode 'vmid=293793435' \ ---data-urlencode 'ps=2' \ ---data-urlencode 'pn=1' \ --b 'SESSDATA=xxx' -``` - -
-查看响应示例： - -```json -{ - "code": 0, - "data": { - "list": [{ - "mid": "14082", - "attribute": 2, - "uname": "山新", - "face": "https://i0.hdslb.com/bfs/face/74c82caee6d9eb623e56161ea8ed6d68afabfeae.jpg" - }, { - "mid": "420831218", - "attribute": 2, - "uname": "支付宝Alipay", - "face": "https://i2.hdslb.com/bfs/face/aaf18aeb2d9822e28a590bd8d878572ca8c59e04.jpg" - }] - }, - "ts": 1677410818395, - "request_id": "d9d541b9f2d24e21821e2d6d2d16c17d" -} -``` - -
- -## 搜索关注明细 - - +### 搜索关注明细 > https://api.bilibili.com/x/relation/followings/search *请求方式：GET* -认证方式：Cookie(SESSDATA)或APP +认证方式：Cookie（SESSDATA）或 APP **url参数：** -| 参数名 | 类型 | 内容 | 必要性 | 备注 | -| ---------- | ---- | ------------ | ----------- | -------- | -| access_key | str | APP登录Token | APP方式必要 | | -| vmid | str | 目标用户mid | 必要 | | -| name | str | 搜索关键词 | 必要 | | -| ps | num | 每页项数 | 非必要 | 默认为50 | -| pn | num | 页码 | 非必要 | 默认为1 | +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| ---------- | ---- | -------------- | ------------ | --------- | +| access_key | str | APP 登录 Token | APP 方式必要 | | +| vmid | str | 目标用户 mid | 必要 | | +| name | str | 搜索关键词 | 非必要 | | +| ps | num | 每页项数 | 非必要 | 默认为 50 | +| pn | num | 页码 | 非必要 | 默认为 1 | + +根对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------- | ---- | -------- | ----------------------------------------------------- | +| code | num | 返回值 | 0：成功
-400：请求错误
22007：访问超过 5 页 | +| message | str | 错误信息 | 默认为 0 | +| ttl | num | 1 | | +| data | obj | 信息本体 | | data 对象： -| 字段 | 类型 | 内容 | 备注 | -| ---------- | ----- | -------- | ------------ | -| list | array | 明细列表 | | -| re_version | num | ？？？ | 作用尚不明确 | -| total | num | 关注总数 | | +| 字段 | 类型 | 内容 | 备注 | +| ---------- | ----- | -------- | ---- | +| list | array | 明细列表 | | +| re_version | num | （？） | | +| total | num | 关注总数 | | `data`中的`list`数组： -| 项 | 类型 | 内容 | 备注 | -| ---- | ---- | ------------- | ---------------- | -| 0 | obj | 共同关注1 | | -| n | obj | 共同关注(n+1) | 按照关注顺序排列 | -| …… | obj | …… | …… | - -数组`list`中的对象： - -| 字段 | 类型 | 内容 | 备注 | -| --------------- | ------------------------------------------- | ------------ | --------------------------------------- | -| mid | num | 用户mid | | -| attribute | num | 关注属性 | 0：未关注
2：已关注
6：已互粉 | -| mtime | num | 关注对方时间 | 时间戳
互关后刷新 | -| tag | 默认分组：null
存在至少一个分组：array | 分组id | | -| special | num | 特别关注标志 | 0：否
1：是 | -| uname | str | 用户昵称 | | -| face | str | 用户头像url | | -| sign | str | 用户签名 | | -| official_verify | obj | 认证信息 | | -| vip | obj | 会员信息 | | - -数组`list`中的对象中的`tag`数组： - -| 项 | 类型 | 内容 | 备注 | -| ---- | ---- | --------------------- | ---- | -| 0 | num | 位于分组1的分组id | | -| n | num | 位于分组(n+1)的分组id | | -| …… | num | …… | …… | - -`list`中的对象中的`official_verify`对象： - -| 字段 | 类型 | 内容 | 备注 | -| ---- | ---- | ------------ | ------------------- | -| type | num | 用户认证类型 | -1：无
1：认证 | -| desc | str | 用户认证信息 | 无为空 | - -`list`中的对象中的`vip`对象： - -| 字段 | 类型 | 内容 | 备注 | -| ------------- | ---- | ------------ | ----------------------------------------------- | -| vipType | num | 会员类型 | 0：无
1：月度大会员
2：年度以上大会员 | -| vipDueDate | num | 会员到期时间 | 时间戳 毫秒 | -| dueRemark | str | 空 | 作用尚不明确 | -| accessStatus | num | 0 | 作用尚不明确 | -| vipStatus | num | 大会员状态 | 0：无
1：有 | -| vipStatusWarn | str | 空 | 作用尚不明确 | -| themeType | num | 0 | 作用尚不明确 | -| label | obj | ？？？ | 作用尚不明确 | - -`vip`中的`label`对象： - -| 字段 | 类型 | 内容 | 备注 | -| ---- | ---- | ---- | ------------ | -| path | str | 空 | 作用尚不明确 | +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | --------------- | -------------------------------- | +| 0 | obj | 匹配项目 1 | 见 [关系列表对象](#关系列表对象) | +| n | obj | 匹配项目（n+1） | 按照添加顺序排列 | +| …… | obj | …… | …… | **示例：** @@ -703,17 +533,15 @@ data 对象： ```shell curl -G 'https://api.bilibili.com/x/relation/followings/search' \ ---data-urlencode 'vmid=293793435' \ ---data-urlencode 'name=warma' \ ---data-urlencode 'ps=2' \ ---data-urlencode 'pn=1' \ --b 'SESSDATA=xxx' + --data-urlencode 'vmid=293793435' \ + --data-urlencode 'name=warma' \ + --data-urlencode 'ps=2' \ + --data-urlencode 'pn=1' \ + -b 'SESSDATA=xxx' ```
查看响应示例： - - ```json { "code": 0, @@ -757,24 +585,22 @@ curl -G 'https://api.bilibili.com/x/relation/followings/search' \
-## 查询共同关注明细 - - +### 查询共同关注明细 > https://api.bilibili.com/x/relation/same/followings *请求方式：GET* -认证方式：Cookie(SESSDATA)或APP +认证方式：Cookie（SESSDATA）或 APP **url参数：** -| 参数名 | 类型 | 内容 | 必要性 | 备注 | -| ---------- | ---- | ------------ | ----------- | -------- | -| access_key | str | APP登录Token | APP方式必要 | | -| vmid | num | 目标用户mid | 必要 | | -| ps | num | 每页项数 | 非必要 | 默认为50 | -| pn | num | 页码 | 非必要 | 默认为1 | +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| ---------- | ---- | -------------- | ------------ | --------- | +| access_key | str | APP 登录 Token | APP 方式必要 | | +| vmid | num | 目标用户 mid | 必要 | | +| ps | num | 每页项数 | 非必要 | 默认为 50 | +| pn | num | 页码 | 非必要 | 默认为 1 | **json回复：** @@ -783,74 +609,25 @@ curl -G 'https://api.bilibili.com/x/relation/followings/search' \ | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | ------------------------------------------------- | | code | num | 返回值 | 0：成功
-101：账号未登录
-400：请求错误 | -| message | str | 错误信息 | 默认为0 | +| message | str | 错误信息 | 默认为 0 | | ttl | num | 1 | | | data | obj | 信息本体 | | data 对象： -| 字段 | 类型 | 内容 | 备注 | -| ---------- | ----- | -------- | ------------ | -| list | array | 明细列表 | | -| re_version | num | ？？？ | 作用尚不明确 | -| total | num | 关注总数 | | +| 字段 | 类型 | 内容 | 备注 | +| ---------- | ----- | -------- | ---- | +| list | array | 明细列表 | | +| re_version | num | （？） | | +| total | num | 关注总数 | | `data`中的`list`数组： -| 项 | 类型 | 内容 | 备注 | -| ---- | ---- | ------------- | ---------------- | -| 0 | obj | 共同关注1 | | -| n | obj | 共同关注(n+1) | 按照关注顺序排列 | -| …… | obj | …… | …… | - -数组`list`中的对象： - -| 字段 | 类型 | 内容 | 备注 | -| --------------- | ------------------------------------------- | ------------ | --------------------------------------- | -| mid | num | 用户mid | | -| attribute | num | 关注属性 | 0：未关注
2：已关注
6：已互粉 | -| mtime | num | 关注对方时间 | 时间戳
互关后刷新 | -| tag | 默认分组：null
存在至少一个分组：array | 分组id | | -| special | num | 特别关注标志 | 0：否
1：是 | -| uname | str | 用户昵称 | | -| face | str | 用户头像url | | -| sign | str | 用户签名 | | -| official_verify | obj | 认证信息 | | -| vip | obj | 会员信息 | | - -数组`list`中的对象中的`tag`数组： - -| 项 | 类型 | 内容 | 备注 | -| ---- | ---- | --------------------- | ---- | -| 0 | num | 位于分组1的分组id | | -| n | num | 位于分组(n+1)的分组id | | -| …… | num | …… | …… | - -`list`中的对象中的`official_verify`对象： - -| 字段 | 类型 | 内容 | 备注 | -| ---- | ---- | ------------ | ------------------- | -| type | num | 用户认证类型 | -1：无
1：认证 | -| desc | str | 用户认证信息 | 无为空 | - -`list`中的对象中的`vip`对象： - -| 字段 | 类型 | 内容 | 备注 | -| ------------- | ---- | ------------ | ----------------------------------------------- | -| vipType | num | 会员类型 | 0：无
1：月度大会员
2：年度以上大会员 | -| vipDueDate | num | 会员到期时间 | 时间戳 毫秒 | -| dueRemark | str | 空 | 作用尚不明确 | -| accessStatus | num | 0 | 作用尚不明确 | -| vipStatus | num | 大会员状态 | 0：无
1：有 | -| vipStatusWarn | str | 空 | 作用尚不明确 | -| themeType | num | 0 | 作用尚不明确 | -| label | obj | ？？？ | 作用尚不明确 | - -`vip`中的`label`对象： - -| 字段 | 类型 | 内容 | 备注 | -| ---- | ---- | ---- | ------------ | -| path | str | 空 | 作用尚不明确 | +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | --------------- | -------------------------------- | +| 0 | obj | 共同关注 1 | 见 [关系列表对象](#关系列表对象) | +| n | obj | 共同关注（n+1） | 按照添加顺序排列 | +| …… | obj | …… | …… | **示例：** @@ -937,23 +714,19 @@ curl -G 'https://api.bilibili.com/x/relation/same/followings' \ -## 查询悄悄关注明细 +### 查询悄悄关注明细 - - -> https://api.bilibili.com/x/relation/whispers +> https://api.bilibili.com/x/relation/whispers *请求方式：GET* -认证方式：Cookie(SESSDATA)或APP +认证方式：Cookie（SESSDATA）或 APP **url参数：** -| 参数名 | 类型 | 内容 | 必要性 | 备注 | -| ---------- | ---- | ------------ | ----------- | -------- | -| access_key | str | APP登录Token | APP方式必要 | | -| ps | num | 每页项数 | 非必要 | 默认为50 | -| pn | num | 页码 | 非必要 | 默认为1 | +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| ---------- | ---- | -------------- | ------------ | ---- | +| access_key | str | APP 登录 Token | APP 方式必要 | | **json回复：** @@ -968,83 +741,29 @@ curl -G 'https://api.bilibili.com/x/relation/same/followings' \ data 对象： -| 字段 | 类型 | 内容 | 备注 | -| ---------- | ----- | -------- | ------------ | -| list | array | 明细列表 | | -| re_version | num | ？？？ | 作用尚不明确 | +| 字段 | 类型 | 内容 | 备注 | +| ---------- | ----- | -------- | ---- | +| list | array | 明细列表 | | +| re_version | num | （？） | | `data`中的`list`数组： -| 项 | 类型 | 内容 | 备注 | -| ---- | ---- | --------- | ---------------- | -| 0 | obj | 关注1 | | -| n | obj | 关注(n+1) | 按照关注顺序排列 | -| …… | obj | …… | …… | - -数组`list`中的对象： - -| 字段 | 类型 | 内容 | 备注 | -| --------------- | ------------------------------------------- | ------------ | --------------------------------------- | -| mid | num | 用户mid | | -| attribute | num | 关注属性 | 0：未关注
2：已关注
6：已互粉 | -| mtime | num | 关注对方时间 | 时间戳
互关后刷新 | -| tag | 默认分组：null
存在至少一个分组：array | 分组id | | -| special | num | 特别关注标志 | 0：否
1：是 | -| uname | str | 用户昵称 | | -| face | str | 用户头像url | | -| sign | str | 用户签名 | | -| official_verify | obj | 认证信息 | | -| vip | obj | 会员信息 | | - -数组`list`中的对象中的`tag`数组： - -| 项 | 类型 | 内容 | 备注 | -| ---- | ---- | --------------------- | ---- | -| 0 | num | 位于分组1的分组id | | -| n | num | 位于分组(n+1)的分组id | | -| …… | num | …… | …… | - -`list`中的对象中的`official_verify`对象： - -| 字段 | 类型 | 内容 | 备注 | -| ---- | ---- | ------------ | ------------------- | -| type | num | 用户认证类型 | -1：无
1：认证 | -| desc | str | 用户认证信息 | 无为空 | - -`list`中的对象中的`vip`对象： - -| 字段 | 类型 | 内容 | 备注 | -| ------------- | ---- | ------------ | ----------------------------------------------- | -| vipType | num | 会员类型 | 0：无
1：月度大会员
2：年度以上大会员 | -| vipDueDate | num | 会员到期时间 | 时间戳 毫秒 | -| dueRemark | str | 空 | 作用尚不明确 | -| accessStatus | num | 0 | 作用尚不明确 | -| vipStatus | num | 大会员状态 | 0：无
1：有 | -| vipStatusWarn | str | 空 | 作用尚不明确 | -| themeType | num | 0 | 作用尚不明确 | -| label | obj | ？？？ | 作用尚不明确 | - -`vip`中的`label`对象： - -| 字段 | 类型 | 内容 | 备注 | -| ---- | ---- | ---- | ------------ | -| path | str | 空 | 作用尚不明确 | +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | --------------- | -------------------------------- | +| 0 | obj | 悄悄关注 1 | 见 [关系列表对象](#关系列表对象) | +| n | obj | 悄悄关注（n+1） | 按照操作顺序排列 | +| …… | obj | …… | …… | **示例：** -获取悄悄关注明细 - ```shell curl -G 'https://api.bilibili.com/x/relation/whispers' \ ---data-urlencode 'ps=2' \ ---data-urlencode 'pn=1' \ --b 'SESSDATA=xxx' + -b 'SESSDATA=xxx' ```
查看响应示例： - ```json { "code": 0, @@ -1083,26 +802,23 @@ curl -G 'https://api.bilibili.com/x/relation/whispers' \ } } ``` -
-## 查询互相关注明细 - - +### 查询互相关注明细 > https://api.bilibili.com/x/relation/friends *请求方式：GET* -认证方式：Cookie(SESSDATA)或APP +认证方式：Cookie（SESSDATA）或 APP 查询与自己互关的用户明细，可看全部 **url参数：** -| 参数名 | 类型 | 内容 | 必要性 | 备注 | -| ---------- | ---- | ------------ | ----------- | -------- | -| access_key | str | APP登录Token | APP方式必要 | | +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| ---------- | ---- | -------------- | ------------ | ---- | +| access_key | str | APP 登录 Token | APP 方式必要 | | **json回复：** @@ -1117,81 +833,28 @@ curl -G 'https://api.bilibili.com/x/relation/whispers' \ data 对象： -| 字段 | 类型 | 内容 | 备注 | -| ---------- | ----- | -------- | ------------ | -| list | array | 明细列表 | | -| re_version | num | ？？？ | 作用尚不明确 | +| 字段 | 类型 | 内容 | 备注 | +| ---------- | ----- | -------- | ---- | +| list | array | 明细列表 | | +| re_version | num | （？） | | `data`中的`list`数组： -| 项 | 类型 | 内容 | 备注 | -| ---- | ---- | --------- | ---------------- | -| 0 | obj | 互关1 | | -| n | obj | 互关(n+1) | 按照关注顺序排列 | -| …… | obj | …… | …… | - -数组`list`中的对象： - -| 字段 | 类型 | 内容 | 备注 | -| --------------- | ------------------------------------------- | ------------ | --------------------------------------- | -| mid | num | 用户mid | | -| attribute | num | 关注属性 | 6：已互粉 | -| mtime | num | 关注对方时间 | 时间戳
互关后刷新 | -| tag | 默认分组：null
存在至少一个分组：array | 分组id | | -| special | num | 特别关注标志 | 0：否
1：是 | -| uname | str | 用户昵称 | | -| face | str | 用户头像url | | -| sign | str | 用户签名 | | -| official_verify | obj | 认证信息 | | -| vip | obj | 会员信息 | | - -数组`list`中的对象中的`tag`数组： - -| 项 | 类型 | 内容 | 备注 | -| ---- | ---- | --------------------- | ---- | -| 0 | num | 位于分组1的分组id | | -| n | num | 位于分组(n+1)的分组id | | -| …… | num | …… | …… | - -`list`中的对象中的`official_verify`对象： - -| 字段 | 类型 | 内容 | 备注 | -| ---- | ---- | ------------ | ------------------- | -| type | num | 用户认证类型 | -1：无
1：认证 | -| desc | str | 用户认证信息 | 无为空 | - -`list`中的对象中的`vip`对象： - -| 字段 | 类型 | 内容 | 备注 | -| ------------- | ---- | ------------ | ----------------------------------------------- | -| vipType | num | 会员类型 | 0：无
1：月度大会员
2：年度以上大会员 | -| vipDueDate | num | 会员到期时间 | 时间戳 毫秒 | -| dueRemark | str | 空 | 作用尚不明确 | -| accessStatus | num | 0 | 作用尚不明确 | -| vipStatus | num | 大会员状态 | 0：无
1：有 | -| vipStatusWarn | str | 空 | 作用尚不明确 | -| themeType | num | 0 | 作用尚不明确 | -| label | obj | ？？？ | 作用尚不明确 | - -`vip`中的`label`对象： - -| 字段 | 类型 | 内容 | 备注 | -| ---- | ---- | ---- | ------------ | -| path | str | 空 | 作用尚不明确 | +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | ----------- | -------------------------------- | +| 0 | obj | 互关 1 | 见 [关系列表对象](#关系列表对象) | +| n | obj | 互关（n+1） | 按照添加顺序排列 | +| …… | obj | …… | …… | **示例：** -获取互相关注明细 - ```shell curl -G 'https://api.bilibili.com/x/relation/friends' \ --b 'SESSDATA=xxx' + -b 'SESSDATA=xxx' ```
查看响应示例： - - ```json { "code": 0, @@ -1200,44 +863,166 @@ curl -G 'https://api.bilibili.com/x/relation/friends' \ "data": { "list": [ { - "mid": 293793435, - "attribute": 6, - "mtime": 1583817598, - "tag": [-10], - "special": 1, - "uname": "社会易姐QwQ", - "face": "https://i0.hdslb.com/bfs/face/aebb2639a0d47f2ce1fec0631f412eaf53d4a0be.jpg", - "sign": "BAC项目负责人 | 带砖技术宅 | MC 编程 电子 | 车万众\u0026术术人 | 粉丝群1136462265 博客shakaianee.top", - "face_nft": 0, - "official_verify": { - "type": -1, - "desc": "" - }, - "vip": { - "vipType": 2, - "vipDueDate": 1675872000000, - "dueRemark": "", - "accessStatus" :0, - "vipStatus": 1, - "vipStatusWarn": "", - "themeType": 0, - "label": { - "path": "", - "text": "年度大会员", - "label_theme": "annual_vip", - "text_color": "#FFFFFF", - "bg_style": 1, - "bg_color": "#FB7299", - "border_color": "" + "mid": 596000, + "attribute": 6, + "mtime": 1685110154, + "tag": null, + "special": 0, + "uname": "椛椛在睡觉", + "face": "https://i2.hdslb.com/bfs/face/365c1ef3b2a3afe21d6832796338fad5119b2592.jpg", + "sign": "欢迎来找椛椛玩~ https://blogs.momiji-jin.com/", + "face_nft": 0, + "official_verify": { + "type": -1, + "desc": "" }, - "avatar_subscript": 1, - "nickname_color": "#FB7299", - "avatar_subscript_url": "" - }, - "nft_icon": "", - "rec_reason": "", - "track_id": "" - } + "vip": { + "vipType": 2, + "vipDueDate": 1702742400000, + "dueRemark": "", + "accessStatus": 0, + "vipStatus": 1, + "vipStatusWarn": "", + "themeType": 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", + "avatar_subscript_url": "" + }, + "nft_icon": "", + "rec_reason": "", + "track_id": "" + }, + { + "mid": 24022863, + "attribute": 6, + "mtime": 1685026230, + "tag": [ + -10 + ], + "special": 1, + "uname": "黄禄轩电脑专用账号", + "face": "https://i0.hdslb.com/bfs/face/a70ec7d2a3822980a915ef4b30371af0cbc79132.jpg", + "sign": "若要私信，请私信「黄禄轩手机专用账号」http://space.bilibili.com/17640193/，群:410311648", + "face_nft": 0, + "official_verify": { + "type": -1, + "desc": "" + }, + "vip": { + "vipType": 2, + "vipDueDate": 1686412800000, + "dueRemark": "", + "accessStatus": 0, + "vipStatus": 1, + "vipStatusWarn": "", + "themeType": 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", + "avatar_subscript_url": "" + }, + "nft_icon": "", + "rec_reason": "", + "track_id": "" + }, + { + "mid": 85438718, + "attribute": 6, + "mtime": 1684759843, + "tag": [ + 194110 + ], + "special": 0, + "uname": "忘忧北萱草Official", + "face": "https://i2.hdslb.com/bfs/face/68d8cba01aab907dbb2cf2e17074f20947156237.jpg", + "sign": "现已加入 OrangeFire 豪华套餐！", + "face_nft": 0, + "official_verify": { + "type": -1, + "desc": "" + }, + "vip": { + "vipType": 2, + "vipDueDate": 1691683200000, + "dueRemark": "", + "accessStatus": 0, + "vipStatus": 1, + "vipStatusWarn": "", + "themeType": 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", + "avatar_subscript_url": "" + }, + "nft_icon": "", + "rec_reason": "", + "track_id": "" + }, + { + "mid": 41620134, + "attribute": 6, + "mtime": 1684759649, + "tag": null, + "special": 0, + "uname": "Tiggy_Chan", + "face": "https://i0.hdslb.com/bfs/face/8c8d9f43eda207f8cb8503bfdf6cc3802a1cd6c1.jpg", + "sign": "此号只发科技类视频，娱乐类转至：虎子酱233", + "face_nft": 0, + "official_verify": { + "type": -1, + "desc": "" + }, + "vip": { + "vipType": 1, + "vipDueDate": 1669219200000, + "dueRemark": "", + "accessStatus": 0, + "vipStatus": 0, + "vipStatusWarn": "", + "themeType": 0, + "label": { + "path": "", + "text": "", + "label_theme": "", + "text_color": "", + "bg_style": 0, + "bg_color": "", + "border_color": "" + }, + "avatar_subscript": 0, + "nickname_color": "", + "avatar_subscript_url": "" + }, + "nft_icon": "", + "rec_reason": "", + "track_id": "" + }, + …… ], "re_version": 0 } @@ -1246,21 +1031,21 @@ curl -G 'https://api.bilibili.com/x/relation/friends' \
-## 查询黑名单明细 +### 查询黑名单明细 > https://api.bilibili.com/x/relation/blacks *请求方式：GET* -认证方式：Cookie(SESSDATA)或APP +认证方式：Cookie（SESSDATA）或 APP **url参数：** -| 参数名 | 类型 | 内容 | 必要性 | 备注 | -| ---------- | ---- | ------------ | ----------- | -------- | -| access_key | str | APP登录Token | APP方式必要 | | -| ps | num | 每页项数 | 非必要 | 默认为50 | -| pn | num | 页码 | 非必要 | 默认为1 | +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| ---------- | ---- | -------------- | ------------ | --------- | +| access_key | str | APP 登录 Token | APP 方式必要 | | +| ps | num | 每页项数 | 非必要 | 默认为 50 | +| pn | num | 页码 | 非必要 | 默认为 1 | **json回复：** @@ -1269,66 +1054,25 @@ curl -G 'https://api.bilibili.com/x/relation/friends' \ | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | ------------------------------------------------- | | code | num | 返回值 | 0：成功
-101：账号未登录
-400：请求错误 | -| message | str | 错误信息 | 默认为0 | +| message | str | 错误信息 | 默认为 0 | | ttl | num | 1 | | | data | obj | 信息本体 | | data 对象： -| 字段 | 类型 | 内容 | 备注 | -| ---------- | ----- | ------------ | ------------ | -| list | array | 明细列表 | | -| re_version | num | ？？？ | 作用尚不明确 | -| total | num | 黑名单总计数 | | +| 字段 | 类型 | 内容 | 备注 | +| ---------- | ----- | ------------ | ---- | +| list | array | 明细列表 | | +| re_version | num | （？） | | +| total | num | 黑名单总计数 | | `data`中的`list`数组： -| 项 | 类型 | 内容 | 备注 | -| ---- | ---- | --------- | ---------------- | -| 0 | obj | 关注1 | | -| n | obj | 关注(n+1) | 按照关注顺序排列 | -| …… | obj | …… | …… | - -数组`list`中的对象： - -| 字段 | 类型 | 内容 | 备注 | -| --------------- | ---- | ------------ | ---------------------- | -| mid | num | 用户mid | | -| attribute | num | 关注属性 | 128：已拉黑 | -| mtime | num | 关注对方时间 | 时间戳
互关后刷新 | -| tag | null | | | -| special | num | 0 | | -| uname | str | 用户昵称 | | -| face | str | 用户头像url | | -| sign | str | 用户签名 | | -| official_verify | obj | 认证信息 | | -| vip | obj | 会员信息 | | - -`list`中的对象中的`official_verify`对象： - -| 字段 | 类型 | 内容 | 备注 | -| ---- | ---- | ------------ | ------------------- | -| type | num | 用户认证类型 | -1：无
1：认证 | -| desc | str | 用户认证信息 | 无为空 | - -`list`中的对象中的`vip`对象： - -| 字段 | 类型 | 内容 | 备注 | -| ------------- | ---- | ------------ | ----------------------------------------------- | -| vipType | num | 会员类型 | 0：无
1：月度大会员
2：年度以上大会员 | -| vipDueDate | num | 会员到期时间 | 时间戳 毫秒 | -| dueRemark | str | 空 | 作用尚不明确 | -| accessStatus | num | 0 | 作用尚不明确 | -| vipStatus | num | 大会员状态 | 0：无
1：有 | -| vipStatusWarn | str | 空 | 作用尚不明确 | -| themeType | num | 0 | 作用尚不明确 | -| label | obj | ？？？ | 作用尚不明确 | - -`vip`中的`label`对象： - -| 字段 | 类型 | 内容 | 备注 | -| ---- | ---- | ---- | ------------ | -| path | str | 空 | 作用尚不明确 | +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | -------------- | -------------------------------- | +| 0 | obj | 黑名单 1 | 见 [关系列表对象](#关系列表对象) | +| n | obj | 黑名单 （n+1） | 按照添加顺序排列 | +| …… | obj | …… | …… | **示例：** @@ -1336,15 +1080,13 @@ data 对象： ```shell curl -G 'https://api.bilibili.com/x/relation/blacks' \ ---data-urlencode 'ps=2' \ ---data-urlencode 'pn=1' \ --b 'SESSDATA=xxx' + --data-urlencode 'ps=2' \ + --data-urlencode 'pn=1' \ + -b 'SESSDATA=xxx' ```
查看响应示例： - - ```json { "code": 0, @@ -1413,25 +1155,27 @@ curl -G 'https://api.bilibili.com/x/relation/blacks' \
-## 操作用户关系 +## 操作关系 +### 操作用户关系 + > https://api.bilibili.com/x/relation/modify *请求方式：POST* -认证方式：Cookie(SESSDATA)或APP +认证方式：Cookie（SESSDATA）或 APP -**正文参数( application/x-www-form-urlencoded )：** +**正文参数（application/x-www-form-urlencoded）：** -| 参数名 | 类型 | 内容 | 必要性 | 备注 | -| ---------- | ---- | ---------------------- | -------------- | -------------------------------------------------------- | -| access_key | str | APP登录Token | APP方式必要 | | -| fid | num | 目标用户mid | 必要 | | -| act | num | 操作代码 | 必要 | **操作代码见下表** | -| re_src | num | 关注来源代码 | 必要 | 空间：11
视频：14
文章：115
活动页面：222 | -| csrf | str | CSRF Token(位于cookie) | Cookie方式必要 | | +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| ---------- | ---- | ------------------------- | --------------- | -------------------------------------------------------- | +| access_key | str | APP 登录 Token | APP 方式必要 | | +| fid | num | 目标用户mid | 必要 | | +| act | num | 操作代码 | 必要 | **操作代码见下表** | +| re_src | num | 关注来源代码 | 必要 | 空间：11
视频：14
文章：115
活动页面：222 | +| csrf | str | CSRF Token（位于 Cookie） | Cookie 方式必要 | | 操作代码`act`： @@ -1461,11 +1205,11 @@ curl -G 'https://api.bilibili.com/x/relation/blacks' \ ```shell curl 'https://api.bilibili.com/x/relation/modify' \ ---data-urlencode 'fid=14082' \ ---data-urlencode 'act=1' \ ---data-urlencode 're_src=11' \ ---data-urlencode 'csrf=xxx' \ --b 'SESSDATA=xxx' + --data-urlencode 'fid=14082' \ + --data-urlencode 'act=1' \ + --data-urlencode 're_src=11' \ + --data-urlencode 'csrf=xxx' \ + -b 'SESSDATA=xxx' ```
@@ -1481,25 +1225,25 @@ curl 'https://api.bilibili.com/x/relation/modify' \
-## 批量操作用户关系 +### 批量操作用户关系 > https://api.bilibili.com/x/relation/batch/modify *请求方式：POST* -认证方式：Cookie(SESSDATA)或APP +认证方式：Cookie（SESSDATA）或 APP 此接口只支持关注和拉黑操作 -**正文参数( application/x-www-form-urlencoded )：** +**正文参数（application/x-www-form-urlencoded）：** -| 参数名 | 类型 | 内容 | 必要性 | 备注 | -| ---------- | ---- | ---------------------- | -------------- | ---------------------------------------------- | -| access_key | str | APP登录Token | APP方式必要 | | -| fids | nums | 目标用户mid | 必要 | 每个之间用`,`间隔 | -| act | num | 操作代码 | 必要 | 同上
仅可为1或5，故只能进行批量关注和拉黑 | -| re_src | num | 关注来源代码 | 必要 | 同上 | -| csrf | str | CSRF Token(位于cookie) | Cookie方式必要 | | +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| ---------- | ---- | ------------------------- | --------------- | ------------------------------------------------- | +| access_key | str | APP 登录 Token | APP 方式必要 | | +| fids | nums | 目标用户 mid 列表 | 必要 | 每个之间用`,`间隔 | +| act | num | 操作代码 | 必要 | 同上
仅可为 1 或 5，故只能进行批量关注和拉黑 | +| re_src | num | 关注来源代码 | 必要 | 同上 | +| csrf | str | CSRF Token（位于 Cookie） | Cookie 方式必要 | | **json回复：** @@ -1514,17 +1258,17 @@ curl 'https://api.bilibili.com/x/relation/modify' \ `data`对象： -| 字段 | 类型 | 内容 | 备注 | -| ----------- | ----- | ------------- | ---- | -| failed_fids | array | 操作失败的mid | | +| 字段 | 类型 | 内容 | 备注 | +| ----------- | ----- | ------------------- | ---- | +| failed_fids | array | 操作失败的 mid 列表 | | `data`中的`failed_fids`数组： -| 项 | 类型 | 内容 | 备注 | -| ---- | ---- | ------------------ | ---- | -| 0 | num | 操作失败的mid 1 | | -| n | num | 操作失败的mid(n+1) | | -| …… | num | …… | …… | +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | --------------------- | ---- | +| 0 | num | 操作失败的 mid 1 | | +| n | num | 操作失败的 mid（n+1） | | +| …… | num | …… | …… | **示例：** @@ -1532,11 +1276,11 @@ curl 'https://api.bilibili.com/x/relation/modify' \ ```shell curl 'https://api.bilibili.com/x/relation/batch/modify' \ ---data-urlencode 'fid=1,2,3,4,5' \ ---data-urlencode 'act=1' \ ---data-urlencode 're_src=11' \ ---data-urlencode 'csrf=xxx' \ --b 'SESSDATA=xxx' + --data-urlencode 'fid=1,2,3,4,5' \ + --data-urlencode 'act=1' \ + --data-urlencode 're_src=11' \ + --data-urlencode 'csrf=xxx' \ + -b 'SESSDATA=xxx' ```
@@ -1555,20 +1299,40 @@ curl 'https://api.bilibili.com/x/relation/batch/modify' \
-## 查询用户与自己关系_仅查关注 +## 查询关系属性 + +### 关系属性对象 + +| 字段 | 类型 | 内容 | 备注 | +| --------- | --------------------------------------- | ------------ | -------------------------------------------------------- | +| mid | num | 目标用户 mid | | +| attribute | num | 关系属性 | 0：未关注
2：已关注
6：已互粉
128：已拉黑 | +| mtime | num | 关注对方时间 | 时间戳
未关注为 0 | +| tag | null默认分组
array存在至少一个分组 | 分组 id | | +| special | num | 特别关注标志 | 0：否
1：是 | + +`tag`数组： + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | --------------------- | ---- | +| 0 | num | 位于分组 1 的分组 | | +| n | num | 位于分组（n+1）的分组 | | +| …… | num | …… | …… | + +### 查询用户与自己关系（仅关注） > https://api.bilibili.com/x/relation *请求方式：GET* -认证方式：Cookie(SESSDATA)或APP +认证方式：Cookie（SESSDATA）或 APP **url参数：** -| 参数名 | 类型 | 内容 | 必要性 | 备注 | -| ---------- | ---- | ------------ | ----------- | ---- | -| access_key | str | APP登录Token | APP方式必要 | | -| fid | num | 目标用户mid | 必要 | | +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| ---------- | ---- | -------------- | ------------ | ---- | +| access_key | str | APP 登录 Token | APP 方式必要 | | +| fid | num | 目标用户 mid | 必要 | | **json回复：** @@ -1579,34 +1343,16 @@ curl 'https://api.bilibili.com/x/relation/batch/modify' \ | code | num | 返回值 | 0：成功
-101：账号未登录
-400：请求错误 | | message | str | 错误信息 | 默认为0 | | ttl | num | 1 | | -| data | obj | 信息本体 | | +| data | obj | 信息本体 | 详见 [关系属性对象](#关系属性对象) | -`data`对象： - -| 字段 | 类型 | 内容 | 备注 | -| --------- | ---------------------------------------- | ------------ | --------------------------------------- | -| mid | num | 目标用户mid | | -| attribute | num | 关注属性 | 0：未关注
2：已关注
6：已互粉
128：拉黑 | -| mtime | num | 关注对方时间 | 时间戳
未关注为0 | -| tag | null默认分组
array存在至少一个分组 | 分组id | | -| special | num | 特别关注标志 | 0：否
1：是 | - -`tag`数组： - -| 项 | 类型 | 内容 | 备注 | -| ---- | ---- | ----------------------- | ---- | -| 0 | num | 位于分组1的分组 | | -| n | num | 位于分组(n+1)的分组 | | -| …… | num | …… | …… | - -**示例：** +`data`对象：**示例：** 可得对于`mid=258150656`的用户，在`2018/10/28 0:51:41`时关注，且设为特别关注，并位于为`-10`分组中 ```shell curl -G 'https://api.bilibili.com/x/relation' \ ---data-urlencode 'fid=258150656' \ --b 'SESSDATA=xxx' + --data-urlencode 'fid=258150656' \ + -b 'SESSDATA=xxx' ```
@@ -1629,20 +1375,26 @@ curl -G 'https://api.bilibili.com/x/relation' \
-## 查询用户与自己关系_互相 +### 查询用户与自己关系（互相关系） -> https://api.bilibili.com/x/space/acc/relation +> https://api.bilibili.com/x/space/wbi/acc/relation *请求方式：GET* -认证方式：Cookie(SESSDATA)或APP +认证方式：Cookie（SESSDATA）或 APP + +鉴权方式：[Wbi 签名](../misc/sign/wbi.md) + +~~该接口的旧版 API ：https://api.bilibili.com/x/space/acc/relation~~（已废弃，不建议使用） **url参数：** -| 参数名 | 类型 | 内容 | 必要性 | 备注 | -| ---------- | ---- | ------------ | ----------- | ---- | -| access_key | str | APP登录Token | APP方式必要 | | -| mid | num | 目标用户mid | 必要 | | +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| ---------- | ---- | ------------ | ----------- | ------------------------------------ | +| access_key | str | APP登录Token | APP方式必要 | | +| mid | num | 目标用户mid | 必要 | | +| w_rid | str | Wbi 签名 | 必要 | 详见 [Wbi 签名](../misc/sign/wbi.md) | +| wts | num | 当前时间戳 | 必要 | 详见 [Wbi 签名](../misc/sign/wbi.md) | **json回复：** @@ -1657,47 +1409,23 @@ curl -G 'https://api.bilibili.com/x/relation' \ `data`对象： -| 字段 | 类型 | 内容 | 备注 | -| ----------- | ---- | ------------------------ | ---- | -| relation | obj | 目标用户对于本用户的属性 | | -| be_relation | obj | 本用户对于目标用户的属性 | | - -`data`中的`relation`对象： - -| 字段 | 类型 | 内容 | 备注 | -| --------- | ---------------------------------------- | ------------ | -------------- | -| mid | num | 对方用户mid | | -| attribute | num | 关注属性 | 0：未关注
1：悄悄关注
2：已关注
6：已互粉
128：拉黑 | -| mtime | num | 关注对方时间 | 互关后刷新时间 | -| tag | null默认分组
array存在至少一个分组 | 分组id | | -| special | num | 特别关注标志 | 0：否
1：是 | - -`data`中的`be_relation`对象： - -| 字段 | 类型 | 内容 | 备注 | -| --------- | ---------------------------------------- | ------------ | -------------- | -| mid | num | 自己的mid | | -| attribute | num | 关注属性 | 0：未关注
1：悄悄关注
2：已关注
6：已互粉
128：拉黑 | -| mtime | num | 成为粉丝时间 | 互关后刷新时间 | -| tag | null默认分组
array存在至少一个分组 | 分组id | | -| special | num | 特别关注标志 | 0：否
1：是 | - -`be_relation`与`relation`中的`tag`数组： - -| 项 | 类型 | 内容 | 备注 | -| ---- | ---- | --------------------- | ---- | -| 0 | num | 位于分组1的分组id | | -| n | num | 位于分组(n+1)的分组id | | -| …… | num | …… | …… | +| 字段 | 类型 | 内容 | 备注 | +| ----------- | ---- | -------------------------- | ---------------------------------- | +| relation | obj | 目标用户对于当前用户的关系 | 详见 [关系属性对象](#关系属性对象) | +| be_relation | obj | 当前用户对于目标用户的关系 | 详见 [关系属性对象](#关系属性对象) | **示例：** -可得对于`mid=15858903`的用户，在`2019/1/24 14:24:19`时关注了对方，且互相关注，自己将对方特别关注，并同时位于为`-10`和`194110`的分组中，对方也将自己设为特别关注，并同时位于为`-10`和`56502`的分组中(虽然我看不到) +可得对于`mid=15858903`的用户，在`2019/1/24 14:24:19`时关注了对方，且互相关注，自己将对方特别关注，并同时位于为`-10`和`194110`的分组中，对方也将自己设为特别关注，并同时位于为`-10`和`56502`的分组中（虽然我看不到） + +Wbi 签名的 `wts`、`w_rid`生成方式详见 [Wbi 签名](../misc/sign/wbi.md) 文档 ```shell curl -G 'https://api.bilibili.com/x/space/acc/relation' \ ---data-urlencode 'mid=15858903' \ --b 'SESSDATA=xxx' + --data-urlencode 'mid=15858903' \ + --data-urlencode 'wts=1686015899' \ + --data-urlencode 'w_rid=e10a3c566c9be80a7cebe7bcdf262588' \ + -b 'SESSDATA=xxx' ```
@@ -1705,46 +1433,51 @@ curl -G 'https://api.bilibili.com/x/space/acc/relation' \ ```json { - "code": 0, - "message": "0", - "ttl": 1, - "data": { - "relation": { - "mid": 15858903, - "attribute": 6, - "mtime": 1548311059, - "tag": [-10, 194110], - "special": 1, - "is_followed": false - }, - "be_relation": { - "mid": 293793435, - "attribute": 6, - "mtime": 1548311059, - "tag": [56502, -10], - "special": 1, - "is_followed": false - } - } + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "relation": { + "mid": 15858903, + "attribute": 6, + "mtime": 1548311059, + "tag": [ + -10, + 194110, + 248468 + ], + "special": 1 + }, + "be_relation": { + "mid": 293793435, + "attribute": 6, + "mtime": 1548311059, + "tag": [ + 56502, + -10 + ], + "special": 1 + } + } } ```
-## 批量查询用户与自己关系 +### 批量查询用户与自己关系 > https://api.bilibili.com/x/relation/relations *请求方式：GET* -认证方式：Cookie(SESSDATA)或APP +认证方式：Cookie（SESSDATA）或 APP **url参数：** | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ---------- | ---- | ------------ | ----------- | ------------------- | -| access_key | str | APP登录Token | APP方式必要 | | -| fids | nums | 目标用户mid | 必要 | 每个之间用`,`间隔 | +| access_key | str | APP 登录 Token | APP 方式必要 | | +| fids | nums | 目标用户 mid | 必要 | 每个之间用`,`间隔 | **json回复：** @@ -1759,28 +1492,10 @@ curl -G 'https://api.bilibili.com/x/space/acc/relation' \ `data`对象： -| 字段 | 类型 | 内容 | 备注 | -| --------- | ---- | ---------- | ---- | -| {用户mid} | obj | 关注的用户 | 下同 | -| …… | obj | …… | | - -`{用户mid}`对象： - -| 字段 | 类型 | 内容 | 备注 | -| --------- | --------------------------------------- | ------------ | ------------------------------------------------------------ | -| mid | num | 目标用户mid | | -| attribute | num | 关注属性 | 0：未关注
1：悄悄关注
2：已关注
6：已互粉
128：拉黑 | -| mtime | num | 关注对方时间 | 时间戳
未关注为0 | -| tag | null默认分组
array存在至少一个分组 | 分组id | | -| special | num | 特别关注标志 | 0：否
1：是 | - -`tag`数组： - -| 项 | 类型 | 内容 | 备注 | -| ---- | ---- | --------------------- | ---- | -| 0 | num | 位于分组1的分组id | | -| n | num | 位于分组(n+1)的分组id | | -| …… | num | …… | …… | +| 字段 | 类型 | 内容 | 备注 | +| --------- | ---- | ---------- | ---------------------------------- | +| {用户mid} | obj | 关注的用户 | 详见 [关系属性对象](#关系属性对象) | +| …… | obj | …… | 下同 | **示例：** @@ -1823,19 +1538,26 @@ curl -G 'https://api.bilibili.com/x/relation/relations' \ ## 关注分组相关 +分组 id 特殊值： + +| id | 含义 | +| ---- | -------- | +| 0 | 默认分组 | +| -10 | 特别关心 | + ### 查询关注分组列表 > https://api.bilibili.com/x/relation/tags *请求方式：GET* -认证方式：Cookie(SESSDATA)或APP +认证方式：Cookie（SESSDATA）或 APP **url参数：** -| 参数名 | 类型 | 内容 | 必要性 | 备注 | -| ---------- | ---- | ------------ | ----------- | ---- | -| access_key | str | APP登录Token | APP方式必要 | | +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| ---------- | ---- | -------------- | ------------ | ---- | +| access_key | str | APP 登录 Token | APP 方式必要 | | **json回复：** @@ -1844,26 +1566,26 @@ curl -G 'https://api.bilibili.com/x/relation/relations' \ | 字段 | 类型 | 内容 | 备注 | | ------- | ------ | -------- | ----------------------------- | | code | num | 返回值 | 0：成功
-101：账号未登录 | -| message | str | 错误信息 | 默认为0 | +| message | str | 错误信息 | 默认为 0 | | ttl | num | 1 | | | data | array | 分组列表 | | `data`数组： -| 项 | 类型 | 内容 | 备注 | -| ---- | ---- | ------------ | ---- | -| 0 | obj | 特别关注分组 | | -| 1 | obj | 默认分组 | | -| n | obj | 其他分组 | | -| …… | num | …… | …… | +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | ----------- | ---- | +| 1 | obj | 分组 1 | | +| n | obj | 分组（n+1） | | +| …… | num | …… | …… | 数组`data`中的对象： -| 字段 | 类型 | 内容 | 备注 | -| ----- | ---- | ---------- | ---------------------------------- | -| tagid | num | 分组id | 特别关注恒为-10
默认分组恒为0 | -| name | str | 分组名称 | | -| count | num | 分组成员数 | | +| 字段 | 类型 | 内容 | 备注 | +| ----- | ---- | ---------- | ---- | +| tagid | num | 分组 id | | +| name | str | 分组名称 | | +| count | num | 分组成员数 | | +| tip | str | 提示信息 | | **示例：** @@ -1871,7 +1593,7 @@ curl -G 'https://api.bilibili.com/x/relation/relations' \ ```shell curl 'https://api.bilibili.com/x/relation/tags' \ --b 'SESSDATA=xxx' + -b 'SESSDATA=xxx' ```
@@ -1882,19 +1604,31 @@ curl 'https://api.bilibili.com/x/relation/tags' \ "code": 0, "message": "0", "ttl": 1, - "data": [{ - "tagid": -10, - "name": "特别关注", - "count": 16 - }, { - "tagid": 0, - "name": "默认分组", - "count": 536 - },{ - "tagid": 194111, - "name": "我的同学", - "count": 16 - }, + "data": [ + { + "tagid": -10, + "name": "特别关注", + "count": 19, + "tip": "第一时间收到该分组下用户更新稿件的通知" + }, + { + "tagid": 0, + "name": "默认分组", + "count": 340, + "tip": "" + }, + { + "tagid": 194110, + "name": "基友们", + "count": 127, + "tip": "" + }, + { + "tagid": 194111, + "name": "我的同学", + "count": 22, + "tip": "" + }, ………… ] } @@ -1908,17 +1642,19 @@ curl 'https://api.bilibili.com/x/relation/tags' \ *请求方式：GET* -认证方式：Cookie(SESSDATA)或APP +认证方式：Cookie（SESSDATA）或 APP + +只可查询属于自己的分组 **url参数：** -| 参数名 | 类型 | 内容 | 必要性 | 备注 | -| ---------- | ---- | ------------ | ----------- | ------------------------------------------------------- | -| access_key | str | APP登录Token | APP方式必要 | | -| tagid | num | 分组id | 必要 | 特别关注恒为-10
默认分组恒为0 | -| order_type | str | 排序方式 | 非必要 | 按照关注顺序排列：留空
按照最常访问排列：attention | -| ps | num | 每页项数 | 非必要 | 默认为50 | -| pn | num | 页数 | 非必要 | 默认为1 | +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| ---------- | ---- | -------------- | ------------ | ------------------------------------------------------- | +| access_key | str | APP 登录 Token | APP 方式必要 | | +| tagid | num | 分组 id | 必要 | | +| order_type | str | 排序方式 | 非必要 | 按照关注顺序排列：留空
按照最常访问排列：attention | +| ps | num | 每页项数 | 非必要 | 默认为 50 | +| pn | num | 页数 | 非必要 | 默认为1 | **json回复：** @@ -1927,54 +1663,17 @@ curl 'https://api.bilibili.com/x/relation/tags' \ | 字段 | 类型 | 内容 | 备注 | | ------- | ------ | -------- | ------------------------------------------------------------ | | code | num | 返回值 | 0：成功
-101：账号未登录
-400：请求错误
22104：该分组不存在 | -| message | str | 错误信息 | 默认为0 | +| message | str | 错误信息 | 默认为 0 | | ttl | num | 1 | | | data | array | 成员列表 | | `data`数组： -| 项 | 类型 | 内容 | 备注 | -| ---- | ---- | ------------- | ---------------- | -| 0 | obj | 成员信息1 | | -| n | obj | 成员信息(n+1) | 按照添加顺序排序 | -| …… | obj | …… | …… | - -数组`data`中的对象： - -| 字段 | 类型 | 内容 | 备注 | -| --------------- | ---- | ----------- | ---- | -| mid | num | 用户mid | | -| uname | str | 用户昵称 | | -| face | str | 用户头像url | | -| sign | str | 用户签名 | | -| official_verify | obj | 认证信息 | | -| vip | obj | 会员信息 | | - -数组`data`中的对象中的`official_verify`对象： - -| 字段 | 类型 | 内容 | 备注 | -| ---- | ---- | ------------ | ------------------- | -| type | num | 用户认证类型 | -1：无
1：认证 | -| desc | str | 用户认证信息 | 无为空 | - -数组`data`中的对象中的`vip`对象： - -| 字段 | 类型 | 内容 | 备注 | -| ------------- | ---- | ------------ | ----------------------------------- | -| vipType | num | 大会员类型 | 0：无
1：月会员
2：年会员 | -| vipDueDate | num | 会员到期时间 | 毫秒 时间戳 | -| dueRemark | str | 空 | 作用尚不明确 | -| accessStatus | num | 0 | 作用尚不明确 | -| vipStatus | num | 大会员状态 | 0无
1有 | -| vipStatusWarn | str | 空 | 作用尚不明确 | -| themeType | num | 0 | 作用尚不明确 | -| label | obj | ？？？ | 作用尚不明确 | - -数组`data`中的对象中的`label`对象： - -| 字段 | 类型 | 内容 | 备注 | -| ---- | ---- | ---- | ------------ | -| path | str | 空 | 作用尚不明确 | +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | --------------- | -------------------------------- | +| 0 | obj | 成员信息 1 | 见 [关系列表对象](#关系列表对象) | +| n | obj | 成员信息（n+1） | 按照添加顺序排序 | +| …… | obj | …… | …… | **示例：** @@ -1982,11 +1681,11 @@ curl 'https://api.bilibili.com/x/relation/tags' \ ```shell curl -G 'https://api.bilibili.com/x/relation/tag' \ ---data-urlencode 'tagid=207542' \ ---data-urlencode 'order_type=' \ ---data-urlencode 'ps=2' \ ---data-urlencode 'pn=1' \ --b 'SESSDATA=xxx' + --data-urlencode 'tagid=207542' \ + --data-urlencode 'order_type=' \ + --data-urlencode 'ps=2' \ + --data-urlencode 'pn=1' \ + -b 'SESSDATA=xxx' ```
@@ -2051,14 +1750,14 @@ curl -G 'https://api.bilibili.com/x/relation/tag' \ *请求方式：GET* -认证方式：Cookie(SESSDATA)或APP +认证方式：Cookie（SESSDATA）或 APP **url参数：** -| 参数名 | 类型 | 内容 | 必要性 | 备注 | -| ---------- | ---- | ------------ | ----------- | ---- | -| access_key | str | APP登录Token | APP方式必要 | | -| fid | num | 目标用户mid | 必要 | | +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| ---------- | ---- | -------------- | ------------ | ---- | +| access_key | str | APP 登录 Token | APP 方式必要 | | +| fid | num | 目标用户 mid | 必要 | | **json回复：** @@ -2067,7 +1766,7 @@ curl -G 'https://api.bilibili.com/x/relation/tag' \ | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | ------------------------------------------------- | | code | num | 返回值 | 0：成功
-101：账号未登录
-400：请求错误 | -| message | str | 错误信息 | 默认为0 | +| message | str | 错误信息 | 默认为 0 | | ttl | num | 1 | | | data | obj | 信息本体 | | @@ -2075,9 +1774,8 @@ curl -G 'https://api.bilibili.com/x/relation/tag' \ | 字段 | 类型 | 内容 | 备注 | | ------------------- | ---- | --------- | ---- | -| {加入的分组id 1} | str | 分组1名称 | | -| {加入的分组id n} | str | 分组n名称 | | -| …… | str | …… | | +| {加入的分组 id} | str | 分组名称 | 若目标用户存在默认分组中，则不显示 | +| …… | str | …… | 下同 | **示例：** @@ -2085,8 +1783,8 @@ curl -G 'https://api.bilibili.com/x/relation/tag' \ ```shell curl -G 'https://api.bilibili.com/x/relation/tag/user' \ ---data-urlencode 'fid=319214221' \ --b 'SESSDATA=xxx' + --data-urlencode 'fid=319214221' \ + -b 'SESSDATA=xxx' ```
@@ -2106,19 +1804,19 @@ curl -G 'https://api.bilibili.com/x/relation/tag/user' \
-### 查询所有特别关注的mid +### 查询所有特别关注 mid > https://api.bilibili.com/x/relation/tag/special *请求方式：GET* -认证方式：Cookie(SESSDATA)或APP +认证方式：Cookie（SESSDATA）或 APP **url参数：** -| 参数名 | 类型 | 内容 | 必要性 | 备注 | -| ---------- | ---- | ------------ | ----------- | ---- | -| access_key | str | APP登录Token | APP方式必要 | | +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| ---------- | ---- | -------------- | ------------ | ---- | +| access_key | str | APP 登录 Token | APP 方式必要 | | **json回复：** @@ -2127,23 +1825,23 @@ curl -G 'https://api.bilibili.com/x/relation/tag/user' \ | 字段 | 类型 | 内容 | 备注 | | ------- | ----- | -------- | ----------------------------- | | code | num | 返回值 | 0：成功
-101：账号未登录 | -| message | str | 错误信息 | 默认为0 | +| message | str | 错误信息 | 默认为 0 | | ttl | num | 1 | | | data | array | 成员列表 | | `data`数组： -| 项 | 类型 | 内容 | 备注 | -| ---- | ---- | ------------ | ---- | -| 0 | num | 成员1mid | | -| n | num | 成员(n+1)mid | | -| …… | num | …… | …… | +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | -------------- | ---- | +| 0 | num | 成员 1 mid | | +| n | num | 成员（n+1）mid | | +| …… | num | …… | …… | **示例：** ```shell curl 'https://api.bilibili.com/x/relation/tag/special' \ --b 'SESSDATA=xxx' + -b 'SESSDATA=xxx' ```
@@ -2187,15 +1885,15 @@ curl 'https://api.bilibili.com/x/relation/tag/special' \ *请求方式：POST* -认证方式：Cookie(SESSDATA)或APP +认证方式：Cookie（SESSDATA）或 APP -**正文参数( application/x-www-form-urlencoded )：** +**正文参数（application/x-www-form-urlencoded）：** -| 参数名 | 类型 | 内容 | 必要性 | 备注 | -| ---------- | ---- | ---------------------- | -------------- | ---------- | -| access_key | str | APP登录Token | APP方式必要 | | -| tag | str | 分组名 | 必要 | 最长16字符 | -| csrf | str | CSRF Token(位于cookie) | Cookie方式必要 | | +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| ---------- | ---- | ------------------------- | --------------- | ------------- | +| access_key | str | APP 登录 Token | APP 方式必要 | | +| tag | str | 分组名 | 必要 | 最长 16 字符 | +| csrf | str | CSRF Token（位于 Cookie） | Cookie 方式必要 | | **json回复：** @@ -2204,15 +1902,15 @@ curl 'https://api.bilibili.com/x/relation/tag/special' \ | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | ------------------------------------------------------------ | | code | num | 返回值 | 0：成功
-111：csrf校验失败
-101：账号未登录
-400：请求错误
22106：该分组已经存在
22103：分组名过长 | -| message | str | 错误信息 | 默认为0 | +| message | str | 错误信息 | 默认为 0 | | ttl | num | 1 | | | data | obj | 信息本体 | | `data`对象： -| 字段 | 类型 | 内容 | 备注 | -| ----- | ---- | -------------- | ---- | -| tagid | num | 创建的分组的id | | +| 字段 | 类型 | 内容 | 备注 | +| ----- | ---- | --------------- | ---- | +| tagid | num | 创建的分组的 id | | **示例：** @@ -2220,9 +1918,9 @@ curl 'https://api.bilibili.com/x/relation/tag/special' \ ```shell curl 'https://api.bilibili.com/x/relation/tag/create' \ ---data-urlencode 'tag=测试' \ ---data-urlencode 'csrf=xxx' \ --b 'SESSDATA=xxx' + --data-urlencode 'tag=测试' \ + --data-urlencode 'csrf=xxx' \ + -b 'SESSDATA=xxx' ```
@@ -2247,16 +1945,16 @@ curl 'https://api.bilibili.com/x/relation/tag/create' \ *请求方式：POST* -认证方式：Cookie(SESSDATA)或APP +认证方式：Cookie（SESSDATA）或 APP -**正文参数( application/x-www-form-urlencoded )：** +**正文参数（application/x-www-form-urlencoded）：** -| 参数名 | 类型 | 内容 | 必要性 | 备注 | -| ---------- | ---- | ---------------------- | -------------- | ---------- | -| access_key | str | APP登录Token | APP方式必要 | | -| tagid | num | 分组id | 必要 | | -| name | str | 新名称 | 必要 | 最长16字符 | -| csrf | str | CSRF Token(位于cookie) | Cookie方式必要 | | +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| ---------- | ---- | ------------------------- | --------------- | ------------ | +| access_key | str | APP 登录 Token | APP 方式必要 | | +| tagid | num | 分组 id | 必要 | | +| name | str | 新名称 | 必要 | 最长 16 字符 | +| csrf | str | CSRF Token（位于 Cookie） | Cookie 方式必要 | | **json回复：** @@ -2265,7 +1963,7 @@ curl 'https://api.bilibili.com/x/relation/tag/create' \ | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | ------------------------------------------------------------ | | code | num | 返回值 | 0：成功
-111：csrf校验失败
-101：账号未登录
-400：请求错误
22103：分组名过长
22104：该分组不存在 | -| message | str | 错误信息 | 默认为0 | +| message | str | 错误信息 | 默认为 0 | | ttl | num | 1 | | **示例：** @@ -2274,10 +1972,10 @@ curl 'https://api.bilibili.com/x/relation/tag/create' \ ```shell curl 'https://api.bilibili.com/x/relation/tag/update' \ ---data-urlencode 'tagid=194112' \ ---data-urlencode 'name=膜法师' \ ---data-urlencode 'csrf=xxx' \ --b 'SESSDATA=xxx' + --data-urlencode 'tagid=194112' \ + --data-urlencode 'name=膜法师' \ + --data-urlencode 'csrf=xxx' \ + -b 'SESSDATA=xxx' ```
@@ -2301,15 +1999,15 @@ curl 'https://api.bilibili.com/x/relation/tag/update' \ *请求方式：POST* -认证方式：Cookie(SESSDATA)或APP +认证方式：Cookie（SESSDATA）或 APP -**正文参数( application/x-www-form-urlencoded )：** +**正文参数（application/x-www-form-urlencoded）：** -| 参数名 | 类型 | 内容 | 必要性 | 备注 | -| ---------- | ---- | ---------------------- | -------------- | ---- | -| access_key | str | APP登录Token | APP方式必要 | | -| tagid | num | 分组id | 必要 | | -| csrf | str | CSRF Token(位于cookie) | Cookie方式必要 | | +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| ---------- | ---- | ------------------------- | --------------- | ---- | +| access_key | str | APP 登录 Token | APP 方式必要 | | +| tagid | num | 分组 id | 必要 | | +| csrf | str | CSRF Token（位于 Cookie） | Cookie 方式必要 | | **json回复：** @@ -2318,7 +2016,7 @@ curl 'https://api.bilibili.com/x/relation/tag/update' \ | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | ------------------------------------------------------------ | | code | num | 返回值 | 0：成功
-111：csrf校验失败
-101：账号未登录
-400：请求错误 | -| message | str | 错误信息 | 默认为0 | +| message | str | 错误信息 | 默认为 0 | | ttl | num | 1 | | 示例： @@ -2327,9 +2025,9 @@ curl 'https://api.bilibili.com/x/relation/tag/update' \ ```shell curl 'https://api.bilibili.com/x/relation/tag/del' \ ---data-urlencode 'tagid=216699' \ ---data-urlencode 'csrf=xxx' \ --b 'SESSDATA=xxx' + --data-urlencode 'tagid=216699' \ + --data-urlencode 'csrf=xxx' \ + -b 'SESSDATA=xxx' ```
@@ -2353,18 +2051,18 @@ curl 'https://api.bilibili.com/x/relation/tag/del' \ *请求方式：POST* -认证方式：Cookie(SESSDATA)或APP +认证方式：Cookie（SESSDATA）或 APP -如需删除分组中的成员，请将`tagids`设为0，即移动至默认分组，而不是取关 +如需删除分组中的成员，请将`tagids`设为 0，即移动至默认分组，而不是取关 -**正文参数( application/x-www-form-urlencoded )：** +**正文参数（application/x-www-form-urlencoded）：** | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ---------- | ---- | ------------------------ | -------------- | ------------------- | -| access_key | str | APP登录Token | APP方式必要 | | -| fids | nums | 目标用户mid | 必要 | 每个之间用`,`间隔 | -| tagids | nums | 分组id | 必要 | 每个之间用`,`间隔 | -| csrf | str | CSRF Token(位于cookie) | Cookie方式必要 | | +| access_key | str | APP 登录 Token | APP 方式必要 | | +| fids | nums | 目标用户 mid 列表 | 必要 | 每个之间用`,`间隔 | +| tagids | nums | 分组 id 列表 | 必要 | 每个之间用`,`间隔 | +| csrf | str | CSRF Token（位于 Cookie） | Cookie 方式必要 | | **json回复：** @@ -2373,7 +2071,7 @@ curl 'https://api.bilibili.com/x/relation/tag/del' \ | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | ------------------------------------------------------------ | | code | num | 返回值 | 0：成功
-111：csrf校验失败
-101：账号未登录
-400：请求错误
22104：无权限
22105：未关注 | -| message | str | 错误信息 | 默认为0 | +| message | str | 错误信息 | 默认为 0 | | ttl | num | 1 | | **示例：** @@ -2382,10 +2080,10 @@ curl 'https://api.bilibili.com/x/relation/tag/del' \ ```shell curl 'https://api.bilibili.com/x/relation/tags/addUsers' \ ---data-urlencode 'fids=205631797' \ ---data-urlencode 'tagids=-10,207542' \ ---data-urlencode 'csrf=xxx' \ --b 'SESSDATA=xxx' + --data-urlencode 'fids=205631797' \ + --data-urlencode 'tagids=-10,207542' \ + --data-urlencode 'csrf=xxx' \ + -b 'SESSDATA=xxx' ```
@@ -2407,16 +2105,16 @@ curl 'https://api.bilibili.com/x/relation/tags/addUsers' \ *请求方式：POST* -认证方式：Cookie(SESSDATA)或APP +认证方式：Cookie（SESSDATA）或 APP -**正文参数( application/x-www-form-urlencoded )：** +**正文参数（application/x-www-form-urlencoded）：** | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ---------- | ---- | ------------------------ | -------------- | ------------------- | -| access_key | str | APP登录Token | APP方式必要 | | -| fids | nums | 待复制的用户mid | 必要 | 每个之间用`,`间隔 | -| tagids | nums | 目标分组id | 必要 | 每个之间用`,`间隔 | -| csrf | str | CSRF Token(位于cookie) | Cookie方式必要 | | +| access_key | str | APP 登录 Token | APP 方式必要 | | +| fids | nums | 待复制的用户 mid 列表 | 必要 | 每个之间用`,`间隔 | +| tagids | nums | 目标分组 id 列表 | 必要 | 每个之间用`,`间隔 | +| csrf | str | CSRF Token（位于 Cookie） | Cookie 方式必要 | | **json回复：** @@ -2425,7 +2123,7 @@ curl 'https://api.bilibili.com/x/relation/tags/addUsers' \ | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | ------------------------------------------------------------ | | code | num | 返回值 | 0：成功
-111：csrf校验失败
-101：账号未登录
-400：请求错误
22104：无权限
22105：未关注 | -| message | str | 错误信息 | 默认为0 | +| message | str | 错误信息 | 默认为 0 | | ttl | num | 1 | | **示例：** @@ -2434,10 +2132,10 @@ curl 'https://api.bilibili.com/x/relation/tags/addUsers' \ ```shell curl 'https://api.bilibili.com/x/relation/tags/copyUsers' \ ---data-urlencode 'fids=4856007,326499679' \ ---data-urlencode 'tagids=231305' \ ---data-urlencode 'csrf=xxx' \ --b 'SESSDATA=xxx' + --data-urlencode 'fids=4856007,326499679' \ + --data-urlencode 'tagids=231305' \ + --data-urlencode 'csrf=xxx' \ + -b 'SESSDATA=xxx' ```
@@ -2459,17 +2157,17 @@ curl 'https://api.bilibili.com/x/relation/tags/copyUsers' \ *请求方式：POST* -认证方式：Cookie(SESSDATA)或APP +认证方式：Cookie（SESSDATA）或 APP -**正文参数( application/x-www-form-urlencoded )：** +**正文参数（application/x-www-form-urlencoded）：** | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------------ | ---- | ------------------------ | -------------- | ------------------- | -| access_key | str | APP登录Token | APP方式必要 | | -| beforeTagids | nums | 原分组id | 必要 | 每个之间用`,`间隔 | -| afterTagids | nums | 新分组id | 必要 | 每个之间用`,`间隔 | -| fids | nums | 待移动的用户mid | 必要 | 每个之间用`,`间隔 | -| csrf | str | CSRF Token(位于cookie) | Cookie方式必要 | | +| access_key | str | APP 登录 Token | APP 方式必要 | | +| beforeTagids | nums | 原分组 id 列表 | 必要 | 每个之间用`,`间隔 | +| afterTagids | nums | 新分组 id 列表 | 必要 | 每个之间用`,`间隔 | +| fids | nums | 待移动的用户 mid 列表 | 必要 | 每个之间用`,`间隔 | +| csrf | str | CSRF Token（位于 Cookie） | Cookie 方式必要 | | **json回复：** @@ -2478,7 +2176,7 @@ curl 'https://api.bilibili.com/x/relation/tags/copyUsers' \ | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | ------------------------------------------------------------ | | code | num | 返回值 | 0：成功
-111：csrf校验失败
-101：账号未登录
-400：请求错误
22104：无权限
22105：未关注 | -| message | str | 错误信息 | 默认为0 | +| message | str | 错误信息 | 默认为 0 | | ttl | num | 1 | | **示例：** @@ -2487,11 +2185,11 @@ curl 'https://api.bilibili.com/x/relation/tags/copyUsers' \ ```shell curl 'https://api.bilibili.com/x/relation/tags/moveUsers' \ ---data-urlencode 'beforeTagids=207542' \ ---data-urlencode 'afterTagids=23130' \ ---data-urlencode 'fids=321173469,327086920' \ ---data-urlencode 'csrf=xxx' \ --b 'SESSDATA=xxx' + --data-urlencode 'beforeTagids=207542' \ + --data-urlencode 'afterTagids=23130' \ + --data-urlencode 'fids=321173469,327086920' \ + --data-urlencode 'csrf=xxx' \ + -b 'SESSDATA=xxx' ```