bilibili-API-collect/docs/message/settings.md
晨叶梦春 0ba4aef40a
feat(message/settings): add get sys setting
Signed-off-by: 晨叶梦春 <65224318+wuziqian211@users.noreply.github.com>
2025-05-05 03:40:17 +08:00

9.4 KiB
Raw Blame History

消息设置

获取系统设置

https://api.vc.bilibili.com/link_setting/v1/link_setting/get_sys_setting

请求方式GET

认证方式CookieSESSDATA

此接口中的设置一般不能由用户随意更改

url参数

参数名 类型 内容 必要性 备注
build num 客户端内部版本号 非必要 默认为 0
mobi_app str 平台标识 非必要 可为 web

json回复

根对象:

字段 类型 内容 备注
code num 返回值 0成功
-101账号未登录
msg str 错误信息 默认为0
message str 错误信息 默认为0
ttl num 1
data obj 信息本体

data 对象:

字段 类型 内容 备注
is_create_group_available num 是否可创建粉丝团 粉丝数达到 1000 后开启
is_auto_reply_available num 是否可使用自动回复功能 粉丝数达到 1000 后开启
vc_hint_title str 稿件自动推送小灰条内容 我为什么会收到此类消息
vc_hint_title_button str 稿件自动推送小灰条旁的按钮内容 了解更多
vc_hint_detail str 稿件自动推送详细信息小灰条内容 您【特别关注】的UP主更新视频或专栏后会第一时间在私信推送给您。如有需要可点击右上角设置关闭推送。
vc_hint_detail_button str 关闭稿件自动推送按钮内容 关闭推送
auto_reply_html str 自动回复H5页面url https://message.bilibili.com/h5/app/auto-reply
is_receive_unfollow_wl num 是否显示限制接收未关注人消息功能
is_voyage num 是否在自动回复页面显示 “大航海自动回复” 按钮 仅部分用户开启
is_auto_reply_recommend_available num 是否在自动回复中的 “被关注回复” 页面显示 “被关注后,向关注我的人推送我的往期作品” 复选框 仅部分用户开启
is_discuss_style_im_page num 作用尚不明确
discuss_unread_style_im_page num 作用尚不明确
old_up_assistant_door obj 原 “UP主小助手” 入口相关信息
is_new_up_assistant_effective num 新 “UP主小助手” 是否启用
is_archive_gray bool 是否不显示 “私信存档” 按钮
session_cfg obj 特定私信会话配置信息
migrate_session_api bool 作用尚不明确
game_msg obj 作用尚不明确;仅当请求参数 mobi_app 不为 web 时有其中的项目
auto_reply_msg_desc str 指示消息为自动回复消息的提示内容 此条消息为自动回复
huahuo_group_icon_new str 浅色模式下的花火图标url
huahuo_group_icon_dark_new str 深色模式下的花火图标url
im_disabled_input_hint str 某UP主禁用私信功能时的提示内容 请到UP主空间发起咨询

data 中的 old_up_assistant_door 对象:

字段 类型 内容 备注
show_old_up_door num 是否显示原 “UP主小助手” 入口 目前恒为 0
title str 原 “UP主小助手” 入口标题 目前为空文本
sub_title str 原 “UP主小助手” 入口子标题 目前为空文本

data 中的 session_cfg 对象:

字段 类型 内容 备注
{用户mid} obj 该会话的配置信息

session_cfg 中的 {用户mid} 对象:

字段 类型 内容 备注
hidden_emote_btn bool 是否隐藏表情按钮
hidden_pic_btn bool 是否隐藏发送图片按钮
max_height num 最大高度(?) 作用尚不明确
hint_text str 私信输入框的提示内容 你想问什么问题呢?
hidden_top_hint str 作用尚不明确
is_gpt_account bool 是否为AI会话

data 中的 game_msg 对象:

字段 类型 内容 备注
show_install bool true 作用尚不明确;仅当请求参数 mobi_app 不为 web 时有此项

示例:

curl 'https://api.vc.bilibili.com/link_setting/v1/link_setting/get_sys_setting' \
  -b 'SESSDATA=xxx'
查看响应示例:
{
  "code": 0,
  "msg": "0",
  "message": "0",
  "ttl": 1,
  "data": {
    "is_create_group_available": 1,
    "is_auto_reply_available": 1,
    "vc_hint_title": "我为什么会收到此类消息",
    "vc_hint_title_button": "了解更多",
    "vc_hint_detail": "您【特别关注】的UP主更新视频或专栏后会第一时间在私信推送给您。如有需要可点击右上角设置关闭推送。",
    "vc_hint_detail_button": "关闭推送",
    "auto_reply_html": "https://message.bilibili.com/h5/app/auto-reply",
    "is_receive_unfollow_wl": 0,
    "is_voyage": 1,
    "is_auto_reply_recommend_available": 0,
    "is_discuss_style_im_page": 0,
    "discuss_unread_style_im_page": 0,
    "old_up_assistant_door": {
      "show_old_up_door": 0,
      "title": "",
      "sub_title": ""
    },
    "is_new_up_assistant_effective": 1,
    "is_archive_gray": true,
    "session_cfg": {
      "100000000000001": {
        "hidden_emote_btn": true,
        "hidden_pic_btn": true,
        "max_height": 62,
        "hint_text": "你想问什么问题呢?",
        "hidden_top_hint": true,
        "is_gpt_account": true
      },
      "100000000000002": {
        "hidden_emote_btn": true,
        "hidden_pic_btn": true,
        "max_height": 62,
        "hint_text": "你想问什么问题呢?",
        "hidden_top_hint": true,
        "is_gpt_account": true
      },
      "1400565964": {
        "hidden_emote_btn": true,
        "hidden_pic_btn": true,
        "max_height": 62,
        "hint_text": "你想问什么问题呢?",
        "hidden_top_hint": true,
        "is_gpt_account": true
      }
    },
    "migrate_session_api": false,
    "game_msg": {
      "show_install": true
    },
    "auto_reply_msg_desc": "此条消息为自动回复",
    "huahuo_group_icon_new": "http://i0.hdslb.com/bfs/kfptfe/floor/e2e3829e514ebccab1705636b0354ec89446a4b5.png",
    "huahuo_group_icon_dark_new": "http://i0.hdslb.com/bfs/kfptfe/floor/d09bc8c0716a15938ec427db5fa962733703f3ce.png",
    "im_disabled_input_hint": "请到UP主空间发起咨询"
  }
}