import{_ as p,c as d,a as e,b as s,d as a,e as l,w as o,r,o as c}from"./app-Dgsdh8A6.js";const i={};function D(u,n){const t=r("RouteLink");return c(),d("div",null,[n[95]||(n[95]=e('

私信

对象与常量说明

会话对象

字段类型内容备注
talker_idnum聊天对象的idsession_type1 时表示用户 mid,为 2 时表示粉丝团 id
session_typenum聊天对象的类型1:用户
2:粉丝团
at_seqnonum最近一次未读at自己的消息的序列号在粉丝团会话中有效,若没有未读的 at 自己的消息则为 0
top_tsnum置顶该会话的时间微秒级时间戳;若未置顶该会话则为 0;用于判断是否置顶了会话
group_namestr粉丝团名称在粉丝团会话中有效,其他会话中为空字符串
group_coverstr粉丝团头像在粉丝团会话中有效,其他会话中为空字符串
is_follownum是否关注了对方在用户会话中有效,系统会话中为 1, 其他会话中为 0
is_dndnum是否对会话设置了免打扰
ack_seqnonum最近一次已读的消息序列号用于快速跳转到首条未读的消息
ack_tsnum最近一次已读时间微秒级时间戳
session_tsnum会话时间微秒级时间戳
unread_countnum未读消息数
last_msg有效时:obj
无效时:null
最近的一条消息详见私信主体对象
group_typenum粉丝团类型在粉丝团时有效
0:应援团
2:官方群(如:ID 为 10 的粉丝团)
can_foldnum会话是否可被折叠入未关注人消息在用户会话中有效
statusnum会话状态详细信息有待补充
max_seqnonum最近一条消息的序列号
new_push_msgnum是否有新推送的消息
settingnum推送设置0:接收推送
1:不接收推送
2:(?)
is_guardiannum自己是否为对方的骑士(?)在用户会话中有效
0:否
2:是(?)
is_interceptnum会话是否被拦截
is_trustnum是否信任此会话若为 1,则表示此会话之前被拦截过,但用户选择信任本会话
system_msg_typenum系统会话类型0:非系统会话
1:主播小助手
5:系统通知(?)
7:UP主小助手
8:客服消息
9:支付小助手
account_infoobj会话信息仅在系统会话中出现
live_statusnum用户是否正在直播在用户会话中有效,其他会话中为 0
biz_msg_unread_countnum未读通知消息数
user_labelnull(?)作用尚不明确

account_info对象:

字段类型内容备注
namestr会话名称
pic_urlstr会话头像

私信主体对象

',7)),s("p",null,[n[1]||(n[1]=a("注:私信主体对象≠")),l(t,{to:"/docs/message/private_msg_content.html"},{default:o(()=>n[0]||(n[0]=[a("私信内容对象")])),_:1,__:[0]})]),s("table",null,[n[24]||(n[24]=s("thead",null,[s("tr",null,[s("th",null,"字段"),s("th",null,"类型"),s("th",null,"内容"),s("th",null,"备注")])],-1)),s("tbody",null,[n[12]||(n[12]=s("tr",null,[s("td",null,"sender_uid"),s("td",null,"num"),s("td",null,"发送者mid"),s("td")],-1)),n[13]||(n[13]=s("tr",null,[s("td",null,"receiver_type"),s("td",null,"num"),s("td",null,"接收者类型"),s("td",null,[a("1:用户"),s("br"),a("2:粉丝团")])],-1)),n[14]||(n[14]=s("tr",null,[s("td",null,"receiver_id"),s("td",null,"num"),s("td",null,"接收者id"),s("td",null,[s("code",null,"receiver_type"),a(" 为 "),s("code",null,"1"),a(" 时表示用户 mid,为 "),s("code",null,"2"),a(" 时表示粉丝团 id")])],-1)),s("tr",null,[n[4]||(n[4]=s("td",null,"msg_type",-1)),n[5]||(n[5]=s("td",null,"num",-1)),n[6]||(n[6]=s("td",null,"消息类型",-1)),s("td",null,[n[3]||(n[3]=a("详见")),l(t,{to:"/docs/message/private_msg_content.html"},{default:o(()=>n[2]||(n[2]=[a("私信消息类型、内容说明")])),_:1,__:[2]})])]),s("tr",null,[n[9]||(n[9]=s("td",null,"content",-1)),n[10]||(n[10]=s("td",null,"str",-1)),n[11]||(n[11]=s("td",null,"消息内容",-1)),s("td",null,[l(t,{to:"/docs/message/private_msg_content.html"},{default:o(()=>n[7]||(n[7]=[a("私信内容对象")])),_:1,__:[7]}),n[8]||(n[8]=s("strong",null,"经过 JSON 序列化后的文本",-1))])]),n[15]||(n[15]=s("tr",null,[s("td",null,"msg_seqno"),s("td",null,"num"),s("td",null,"消息序列号"),s("td",null,"按照时间顺序从小到大")],-1)),n[16]||(n[16]=s("tr",null,[s("td",null,"timestamp"),s("td",null,"num"),s("td",null,"消息发送时间"),s("td",null,"秒级时间戳")],-1)),n[17]||(n[17]=s("tr",null,[s("td",null,"at_uids"),s("td",null,[a("有效时:array"),s("br"),a("无效时:null")]),s("td",null,"at的成员mid"),s("td",null,[a("在粉丝团时有效;此项为 "),s("code",null,"null"),a(" 或 "),s("code",null,"[0]"),a(" 均表示没有 at 成员")])],-1)),n[18]||(n[18]=s("tr",null,[s("td",null,"msg_key"),s("td",null,"num"),s("td",null,"消息唯一id"),s("td",null,"部分库在解析JSON对象中的大数时存在数值的精度丢失问题,因此在处理此字段时可能会出现问题,建议使用修复了这一问题的库(如将大数转换成文本)")],-1)),n[19]||(n[19]=s("tr",null,[s("td",null,"msg_status"),s("td",null,"num"),s("td",null,"消息状态"),s("td",null,[a("0:正常"),s("br"),a("1:被撤回(接口仍能返回被撤回的私信内容)"),s("br"),a("2:被系统撤回(如:消息被举报;私信将不会显示在前端,B站接口也不会返回被系统撤回的私信的信息)"),s("br"),a("50:图片已失效(私信内容为一张提示“图片出现问题”的图片)")])],-1)),n[20]||(n[20]=s("tr",null,[s("td",null,"sys_cancel"),s("td",null,"bool"),s("td",null,"是否为系统撤回"),s("td",null,[a("仅当 "),s("code",null,"msg_type"),a(" 为 "),s("code",null,"5"),a(" 且此项值为 "),s("code",null,"true"),a(" 时有此项;若此项值为 "),s("code",null,"true"),a(",表示目标消息是被系统撤回的,此时前端将不显示该私信且没有提示")])],-1)),n[21]||(n[21]=s("tr",null,[s("td",null,"notify_code"),s("td",null,"str"),s("td",null,"通知代码"),s("td",null,[a("发送通知时使用,以下划线 "),s("code",null,"_"),a(" 分割,第 1 项表示主业务 id,第 2 项表示子业务 id;若这条私信非通知则为空文本;详细信息有待补充")])],-1)),n[22]||(n[22]=s("tr",null,[s("td",null,"new_face_version"),s("td",null,"num"),s("td",null,"表情包版本"),s("td",null,[a("为 "),s("code",null,"0"),a(" 或无此项表示旧版表情包,此时 B 站会自动转换成新版表情包,例如 "),s("code",null,"[doge]"),a(" -> "),s("code",null,"[tv_doge]"),a(";"),s("code",null,"1"),a(" 为新版")])],-1)),n[23]||(n[23]=s("tr",null,[s("td",null,"msg_source"),s("td",null,"num"),s("td",null,"消息来源"),s("td",null,[a("见"),s("a",{href:"#%E6%B6%88%E6%81%AF%E6%9D%A5%E6%BA%90%E5%88%97%E8%A1%A8msg_source"},"消息来源列表")])],-1))])]),n[96]||(n[96]=e('

私信主体对象中的at_uids数组:

类型内容备注
0num用户1成员mid
nnum用户(n+1)
……num…………

消息来源列表(msg_source

',3)),s("table",null,[n[49]||(n[49]=s("thead",null,[s("tr",null,[s("th",null,"代码"),s("th",null,"含义"),s("th",null,"备注")])],-1)),s("tbody",null,[n[32]||(n[32]=s("tr",null,[s("td",null,"0"),s("td",null,"未知来源"),s("td",null,"在以前发送的部分私信的来源代码")],-1)),n[33]||(n[33]=s("tr",null,[s("td",null,"1"),s("td",null,"iOS"),s("td")],-1)),n[34]||(n[34]=s("tr",null,[s("td",null,"2"),s("td",null,"Android"),s("td")],-1)),n[35]||(n[35]=s("tr",null,[s("td",null,"3"),s("td",null,"H5"),s("td")],-1)),n[36]||(n[36]=s("tr",null,[s("td",null,"4"),s("td",null,"PC客户端"),s("td")],-1)),n[37]||(n[37]=s("tr",null,[s("td",null,"5"),s("td",null,"官方推送消息"),s("td",null,"包括:官方向大多数用户自动发送的私信(如:UP主小助手的推广)等")],-1)),n[38]||(n[38]=s("tr",null,[s("td",null,"6"),s("td",null,"推送/通知消息"),s("td",null,"包括:特别关注时稿件的自动推送、因成为契约者而自动发送的私信、包月充电回馈私信、官方发送的特定于自己的消息(如:UP主小助手的稿件审核状态通知)等")],-1)),n[39]||(n[39]=s("tr",null,[s("td",null,"7"),s("td",null,"Web"),s("td")],-1)),n[40]||(n[40]=s("tr",null,[s("td",null,"8"),s("td",null,"自动回复 - 被关注回复"),s("td",null,"B站前端会显示“此条消息为自动回复”")],-1)),n[41]||(n[41]=s("tr",null,[s("td",null,"9"),s("td",null,"自动回复 - 收到消息回复"),s("td",null,"B站前端会显示“此条消息为自动回复”")],-1)),n[42]||(n[42]=s("tr",null,[s("td",null,"10"),s("td",null,"自动回复 - 关键词回复"),s("td",null,"B站前端会显示“此条消息为自动回复”")],-1)),n[43]||(n[43]=s("tr",null,[s("td",null,"11"),s("td",null,"自动回复 - 大航海上船回复"),s("td",null,"B站前端会显示“此条消息为自动回复”")],-1)),s("tr",null,[n[30]||(n[30]=s("td",null,"12",-1)),n[31]||(n[31]=s("td",null,"自动推送 - UP 主赠言",-1)),s("td",null,[n[26]||(n[26]=a("在以前稿件推送消息与其附带的 UP 主赠言是 2 条不同的私信(其中 UP 主赠言的消息来源代码为 12),现在 UP 主赠言已并入为")),l(t,{to:"/docs/message/private_msg_content.html#%E8%A7%86%E9%A2%91%E6%8E%A8%E9%80%81%E6%B6%88%E6%81%AFmsg_type11"},{default:o(()=>n[25]||(n[25]=[a("稿件自动推送消息")])),_:1,__:[25]}),n[27]||(n[27]=a("的一部分(")),n[28]||(n[28]=s("code",null,"attach_msg",-1)),n[29]||(n[29]=a(")"))])]),n[44]||(n[44]=s("tr",null,[s("td",null,"13"),s("td",null,"粉丝团系统提示"),s("td",null,"如:粉丝团中的提示信息“欢迎xxx入群”")],-1)),n[45]||(n[45]=s("tr",null,[s("td",null,"16"),s("td",null,"系统"),s("td",null,[a("目前仅在 "),s("code",null,"msg_type"),a(" 为 "),s("code",null,"51"),a(" 时使用该代码")])],-1)),n[46]||(n[46]=s("tr",null,[s("td",null,"17"),s("td",null,"互相关注"),s("td",null,"互相关注时自动发送的私信“我们已互相关注,开始聊天吧~”")],-1)),n[47]||(n[47]=s("tr",null,[s("td",null,"18"),s("td",null,"系统提示"),s("td",null,[a("目前仅在 "),s("code",null,"msg_type"),a(" 为 "),s("code",null,"18"),a(" 时使用该代码,如:“对方主动回复或关注你前,最多发送1条消息”")])],-1)),n[48]||(n[48]=s("tr",null,[s("td",null,"19"),s("td",null,"AI"),s("td",null,[a("如:给"),s("a",{href:"https://space.bilibili.com/1400565964/",target:"_blank",rel:"noopener noreferrer"},"搜索AI助手测试版"),a("发送私信时对方的自动回复")])],-1))])]),n[97]||(n[97]=e(`

会话相关

获取未读私信数

https://api.vc.bilibili.com/session_svr/v1/session_svr/single_unread

请求方式:GET

认证方式:Cookie(SESSDATA)

注: 该接口默认每 2 分钟请求一次;该接口不会返回未读粉丝团私信数

URL参数:

参数名类型内容必要性备注
unread_typenum未读类型非必要0:所有
1:仅已关注
2:仅未关注
3:仅被拦截 (须同时设置参数 show_dustbin=1)
默认为 0
show_unfollow_listnum是否返回未关注人推送消息数非必要0:否
1:是
show_dustbinnum是否返回被拦截私信数非必要0:否
1:是
buildnum客户端内部版本号非必要默认为 0
mobi_appstr平台标识非必要可为 web

json回复:

根对象:

字段类型内容备注
codenum返回值0:成功
-101:账号未登录
msgstr错误信息默认为0
messagestr错误信息默认为0
ttlnum1
dataobj信息本体

data 对象:

字段类型内容备注
unfollow_unreadnum未读未关注用户私信数
follow_unreadnum未读已关注用户私信数
unfollow_push_msgnum未读未关注用户推送消息数
dustbin_push_msgnum未读被拦截的推送消息数
dustbin_unreadnum未读被拦截的私信数
biz_msg_unfollow_unreadnum未读未关注用户通知数
biz_msg_follow_unreadnum未读已关注用户通知数
custom_unreadnum未读客服消息数

示例:

以下信息代表未读未关注用户私信数为 1 条,未读已关注用户私信数为 6

curl -G 'https://api.vc.bilibili.com/session_svr/v1/session_svr/single_unread' \\
  --data-urlencode 'unread_type=0' \\
  --data-urlencode 'show_unfollow_list=1' \\
  --data-urlencode 'show_dustbin=1' \\
  --data-urlencode 'build=0' \\
  --data-urlencode 'mobi_app=web' \\
  -b 'SESSDATA=xxx'
查看响应示例:
{
  "code": 0,
  "msg": "0",
  "message": "0",
  "ttl": 1,
  "data": {
    "unfollow_unread": 1,
    "follow_unread": 6,
    "unfollow_push_msg": 0,
    "dustbin_push_msg": 0,
    "dustbin_unread": 0,
    "biz_msg_unfollow_unread": 0,
    "biz_msg_follow_unread": 0,
    "custom_unread": 0
  }
}

获取未读粉丝团私信数

https://api.vc.bilibili.com/session_svr/v1/session_svr/my_group_unread

请求方式:GET

认证方式:Cookie(SESSDATA)

url参数:

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

json回复:

根对象:

字段类型内容备注
codenum返回值0:成功
-101:账号未登录
msgstr错误信息默认为0
messagestr错误信息默认为0
ttlnum1
dataobj信息本体

data 对象:

字段类型内容备注
unread_countnum未读粉丝团私信数

示例:

以下信息代表未读粉丝团私信数为 497

curl -G 'https://api.vc.bilibili.com/session_svr/v1/session_svr/my_group_unread' \\
  --data-urlencode 'build=0' \\
  --data-urlencode 'mobi_app=web' \\
  -b 'SESSDATA=xxx'
查看响应示例:
{
  "code": 0,
  "msg": "0",
  "message": "0",
  "ttl": 1,
  "data": {
    "unread_count": 497
  }
}

获取指定类型会话列表

https://api.vc.bilibili.com/session_svr/v1/session_svr/get_sessions

请求方式:GET

认证方式:Cookie(SESSDATA)

url参数:

参数名类型内容必要性备注
session_typenum会话类型必要1:用户与系统
2:未关注人
3:粉丝团
4:所有
5:被拦截
6:花火商单
7:所有系统消息
8:陌生人(与 “未关注人” 不同,不包含官方消息)
9:关注的人与系统
group_foldnum是否折叠粉丝团消息非必要0:否
1:是
unfollow_foldnum是否折叠未关注人消息非必要0:否
1:是
sort_rulenum排序方式非必要仅当 session_type 不为 47 时有效
1、2:按会话时间逆向排序
3:按已读时间逆向排序
其他:用户与系统按会话时间逆向排序,粉丝团按加入时间正向排序
begin_tsnum起始时间非必要微秒级时间戳
end_tsnum终止时间非必要微秒级时间戳
sizenum返回的会话数非必要默认为 20,最大为 100
buildnum客户端内部版本号非必要默认为 0
mobi_appstr平台标识非必要可为 web

json回复:

根对象:

字段类型内容备注
codenum返回值0:成功
-101:账号未登录
-400:请求错误
2:非法参数
msgstr错误信息默认为0
messagestr错误信息默认为0
ttlnum1
dataobj数据本体

data对象:

字段类型内容备注
session_list有会话时:array
无会话时:null
会话列表
has_morenum是否有更多会话
anti_distrub_cleaningbool是否开启了“一键防骚扰”功能
is_address_list_emptynum0作用尚不明确
system_msgobj系统会话列表仅当存在系统会话时有此项
show_levelbool是否在会话列表中显示用户等级目前恒为 true

data对象中的session_list数组:

类型内容备注
0obj会话1详见会话对象
nobj会话(n+1)
……obj…………

data对象中的system_msg对象:

字段类型内容备注
{系统会话类型代码}num系统会话id详见会话对象中对 system_msg_type 字段的说明

示例:

获取所有类型的会话列表:

curl -G 'https://api.vc.bilibili.com/session_svr/v1/session_svr/get_sessions' \\
  --data-urlencode 'session_type=4' \\
  --data-urlencode 'group_fold=0' \\
  --data-urlencode 'unfollow_fold=0' \\
  --data-urlencode 'sort_rule=2' \\
  --data-urlencode 'size=3' \\
  --data-urlencode 'build=0' \\
  --data-urlencode 'mobi_app=web' \\
  -b 'SESSDATA=xxx'
查看响应示例:
{
  "code": 0,
  "msg": "0",
  "message": "0",
  "ttl": 1,
  "data": {
    "session_list": [
      {
        "talker_id": 844424930131966,
        "session_type": 1,
        "at_seqno": 0,
        "top_ts": 0,
        "group_name": "",
        "group_cover": "",
        "is_follow": 1,
        "is_dnd": 0,
        "ack_seqno": 1238729956474887,
        "ack_ts": 1709536924979884,
        "session_ts": 1712305278098351,
        "unread_count": 4,
        "last_msg": {
          "sender_uid": 844424930131966,
          "receiver_type": 1,
          "receiver_id": 425503913,
          "msg_type": 10,
          "content": "{\\"title\\":\\"流量奖励到账通知\\",\\"text\\":\\"恭喜您已获得2000流量曝光奖励,快来投稿使用吧。\\",\\"jump_text\\":\\"\\",\\"jump_uri\\":\\"\\",\\"modules\\":null,\\"jump_text_2\\":\\"\\",\\"jump_uri_2\\":\\"\\",\\"jump_text_3\\":\\"\\",\\"jump_uri_3\\":\\"\\",\\"notifier\\":null,\\"jump_uri_config\\":{\\"all_uri\\":\\"https://member.bilibili.com/york/flow-reward?navhide=1\\\\u0026from=msgrecall\\",\\"text\\":\\"\\"},\\"jump_uri_2_config\\":{\\"text\\":\\"\\"},\\"jump_uri_3_config\\":{\\"text\\":\\"\\"},\\"biz_content\\":null}",
          "msg_seqno": 1285290404823041,
          "timestamp": 1712305278,
          "at_uids": null,
          "msg_key": 7354295169819585966,
          "msg_status": 0,
          "notify_code": "2091_253",
          "new_face_version": 1,
          "msg_source": 6
        },
        "group_type": 0,
        "can_fold": 0,
        "status": 0,
        "max_seqno": 1285290404823041,
        "new_push_msg": 1,
        "setting": 0,
        "is_guardian": 0,
        "is_intercept": 0,
        "is_trust": 0,
        "system_msg_type": 7,
        "account_info": {
          "name": "UP主小助手",
          "pic_url": "https://message.biliimg.com/bfs/im/489a63efadfb202366c2f88853d2217b5ddc7a13.png"
        },
        "live_status": 0,
        "biz_msg_unread_count": 0,
        "user_label": null
      },
      {
        "talker_id": 293793435,
        "session_type": 1,
        "at_seqno": 0,
        "top_ts": 0,
        "group_name": "",
        "group_cover": "",
        "is_follow": 1,
        "is_dnd": 0,
        "ack_seqno": 1236306587877408,
        "ack_ts": 1709536984481314,
        "session_ts": 1709385615744065,
        "unread_count": 0,
        "last_msg": {
          "sender_uid": 293793435,
          "receiver_type": 1,
          "receiver_id": 425503913,
          "msg_type": 11,
          "content": "{\\"title\\":\\"OHHHHHH家人们,我分数终于破w了!紫框了这下确实不好意思说自己是只打红谱的萌新了\\",\\"times\\":14,\\"cover\\":\\"http://i0.hdslb.com/bfs/archive/8821c03ab27a0bcf2bf32af814e758ab17a1e27e.png\\",\\"rid\\":1951316064,\\"type_\\":8,\\"desc\\":\\"OHHHHHH家人们,我分数终于破w了!紫框了这下确实不好意思说自己是只打红谱的萌新了\\",\\"bvid\\":\\"BV1zC411p7JN\\",\\"view\\":452,\\"danmaku\\":0,\\"pub_date\\":1709385603,\\"attach_msg\\":null}",
          "msg_seqno": 1236306587877408,
          "timestamp": 1709385615,
          "at_uids": null,
          "msg_key": 7341755312943193481,
          "msg_status": 0,
          "notify_code": "",
          "new_face_version": 1,
          "msg_source": 6
        },
        "group_type": 0,
        "can_fold": 0,
        "status": 0,
        "max_seqno": 1236306587877408,
        "new_push_msg": 0,
        "setting": 0,
        "is_guardian": 0,
        "is_intercept": 0,
        "is_trust": 0,
        "system_msg_type": 0,
        "live_status": 0,
        "biz_msg_unread_count": 0,
        "user_label": null
      },
      {
        "talker_id": 221082140,
        "session_type": 2,
        "at_seqno": 0,
        "top_ts": 0,
        "group_name": "社会易姐QwQ的应援团",
        "group_cover": "http://i0.hdslb.com/bfs/face/aebb2639a0d47f2ce1fec0631f412eaf53d4a0be.jpg",
        "is_follow": 0,
        "is_dnd": 0,
        "ack_seqno": 20,
        "ack_ts": 1695011620552332,
        "session_ts": 1693626568439784,
        "unread_count": 0,
        "last_msg": {
          "sender_uid": 0,
          "receiver_type": 2,
          "receiver_id": 221082140,
          "msg_type": 306,
          "content": "{\\"group_id\\":221082140,\\"content\\":\\"欢迎罗板栗入群\\"}",
          "msg_seqno": 20,
          "timestamp": 1693626568,
          "at_uids": null,
          "msg_key": 7274070721607234847,
          "msg_status": 0,
          "notify_code": "",
          "msg_source": 13
        },
        "group_type": 0,
        "can_fold": 0,
        "status": 0,
        "max_seqno": 20,
        "new_push_msg": 0,
        "setting": 0,
        "is_guardian": 0,
        "is_intercept": 0,
        "is_trust": 0,
        "system_msg_type": 0,
        "live_status": 0,
        "biz_msg_unread_count": 0,
        "user_label": null
      }
    ],
    "has_more": 1,
    "anti_disturb_cleaning": false,
    "is_address_list_empty": 0,
    "system_msg": {
      "1": 844424930131967,
      "7": 844424930131966,
      "9": 844424930131965
    },
    "show_level": true
  }
}

获取新会话列表

https://api.vc.bilibili.com/session_svr/v1/session_svr/new_sessions

请求方式:GET

认证方式:Cookie(SESSDATA)

获取指定时间之后的新会话列表

注:该接口默认每 20 秒请求一次

url参数:

参数名类型内容必要性备注
begin_tsnum起始时间非必要微秒级时间戳
sizenum返回的会话数非必要默认为 20,最大为 100
buildnum客户端内部版本号非必要默认为 0
mobi_appstr平台标识非必要可为 web

json回复:

根对象:

字段类型内容备注
codenum返回值0:成功
-101:账号未登录
-400:请求错误
msgstr错误信息默认为0
messagestr错误信息默认为0
ttlnum1
dataobj数据本体

data对象:

字段类型内容备注
session_list有会话时:array
无会话时:null
会话列表按发送时间顺序逆向排序
has_morenum是否有更多会话
anti_distrub_cleaningbool是否开启了“一键防骚扰”功能
is_address_list_emptynum0作用尚不明确
show_levelbool是否在会话列表中显示用户等级目前恒为 false

data对象中的session_list数组:

类型内容备注
0obj会话1详见会话对象
nobj会话(n+1)
……obj…………

示例:

获取begin_ts=1712420213519391之后的新会话列表:

curl -G 'https://api.vc.bilibili.com/session_svr/v1/session_svr/new_sessions' \\
  --data-urlencode 'begin_ts=1712420213519391' \\
  --data-urlencode 'size=3' \\
  --data-urlencode 'build=0' \\
  --data-urlencode 'mobi_app=web' \\
  -b 'SESSDATA=xxx'
查看响应示例:
{
  "code": 0,
  "msg": "0",
  "message": "0",
  "ttl": 1,
  "data": {
    "session_list": [
      {
        "talker_id": 844424930131966,
        "session_type": 1,
        "at_seqno": 0,
        "top_ts": 0,
        "group_name": "",
        "group_cover": "",
        "is_follow": 1,
        "is_dnd": 0,
        "ack_seqno": 1238729956474887,
        "ack_ts": 1709536924979884,
        "session_ts": 1712305278098351,
        "unread_count": 4,
        "last_msg": {
          "sender_uid": 844424930131966,
          "receiver_type": 1,
          "receiver_id": 425503913,
          "msg_type": 10,
          "content": "{\\"title\\":\\"流量奖励到账通知\\",\\"text\\":\\"恭喜您已获得2000流量曝光奖励,快来投稿使用吧。\\",\\"jump_text\\":\\"\\",\\"jump_uri\\":\\"\\",\\"modules\\":null,\\"jump_text_2\\":\\"\\",\\"jump_uri_2\\":\\"\\",\\"jump_text_3\\":\\"\\",\\"jump_uri_3\\":\\"\\",\\"notifier\\":null,\\"jump_uri_config\\":{\\"all_uri\\":\\"https://member.bilibili.com/york/flow-reward?navhide=1\\\\u0026from=msgrecall\\",\\"text\\":\\"\\"},\\"jump_uri_2_config\\":{\\"text\\":\\"\\"},\\"jump_uri_3_config\\":{\\"text\\":\\"\\"},\\"biz_content\\":null}",
          "msg_seqno": 1285290404823041,
          "timestamp": 1712305278,
          "at_uids": null,
          "msg_key": 7354295169819585966,
          "msg_status": 0,
          "notify_code": "2091_253",
          "new_face_version": 1,
          "msg_source": 6
        },
        "group_type": 0,
        "can_fold": 0,
        "status": 0,
        "max_seqno": 1285290404823041,
        "new_push_msg": 1,
        "setting": 0,
        "is_guardian": 0,
        "is_intercept": 0,
        "is_trust": 0,
        "system_msg_type": 7,
        "account_info": {
          "name": "UP主小助手",
          "pic_url": "https://message.biliimg.com/bfs/im/489a63efadfb202366c2f88853d2217b5ddc7a13.png"
        },
        "live_status": 0,
        "biz_msg_unread_count": 0,
        "user_label": null
      },
      {
        "talker_id": 293793435,
        "session_type": 1,
        "at_seqno": 0,
        "top_ts": 0,
        "group_name": "",
        "group_cover": "",
        "is_follow": 1,
        "is_dnd": 0,
        "ack_seqno": 1236306587877408,
        "ack_ts": 1709536984481314,
        "session_ts": 1709385615744065,
        "unread_count": 0,
        "last_msg": {
          "sender_uid": 293793435,
          "receiver_type": 1,
          "receiver_id": 425503913,
          "msg_type": 11,
          "content": "{\\"title\\":\\"OHHHHHH家人们,我分数终于破w了!紫框了这下确实不好意思说自己是只打红谱的萌新了\\",\\"times\\":14,\\"cover\\":\\"http://i0.hdslb.com/bfs/archive/8821c03ab27a0bcf2bf32af814e758ab17a1e27e.png\\",\\"rid\\":1951316064,\\"type_\\":8,\\"desc\\":\\"OHHHHHH家人们,我分数终于破w了!紫框了这下确实不好意思说自己是只打红谱的萌新了\\",\\"bvid\\":\\"BV1zC411p7JN\\",\\"view\\":452,\\"danmaku\\":0,\\"pub_date\\":1709385603,\\"attach_msg\\":null}",
          "msg_seqno": 1236306587877408,
          "timestamp": 1709385615,
          "at_uids": null,
          "msg_key": 7341755312943193481,
          "msg_status": 0,
          "notify_code": "",
          "new_face_version": 1,
          "msg_source": 6
        },
        "group_type": 0,
        "can_fold": 0,
        "status": 0,
        "max_seqno": 1236306587877408,
        "new_push_msg": 0,
        "setting": 0,
        "is_guardian": 0,
        "is_intercept": 0,
        "is_trust": 0,
        "system_msg_type": 0,
        "live_status": 0,
        "biz_msg_unread_count": 0,
        "user_label": null
      },
      {
        "talker_id": 221082140,
        "session_type": 2,
        "at_seqno": 0,
        "top_ts": 0,
        "group_name": "社会易姐QwQ的应援团",
        "group_cover": "http://i0.hdslb.com/bfs/face/aebb2639a0d47f2ce1fec0631f412eaf53d4a0be.jpg",
        "is_follow": 0,
        "is_dnd": 0,
        "ack_seqno": 20,
        "ack_ts": 1695011620552332,
        "session_ts": 1693626568439784,
        "unread_count": 0,
        "last_msg": {
          "sender_uid": 0,
          "receiver_type": 2,
          "receiver_id": 221082140,
          "msg_type": 306,
          "content": "{\\"group_id\\":221082140,\\"content\\":\\"欢迎罗板栗入群\\"}",
          "msg_seqno": 20,
          "timestamp": 1693626568,
          "at_uids": null,
          "msg_key": 7274070721607234847,
          "msg_status": 0,
          "notify_code": "",
          "msg_source": 13
        },
        "group_type": 0,
        "can_fold": 0,
        "status": 0,
        "max_seqno": 20,
        "new_push_msg": 0,
        "setting": 0,
        "is_guardian": 0,
        "is_intercept": 0,
        "is_trust": 0,
        "system_msg_type": 0,
        "live_status": 0,
        "biz_msg_unread_count": 0,
        "user_label": null
      }
    ],
    "has_more": 0,
    "anti_disturb_cleaning": false,
    "is_address_list_empty": 0,
    "show_level": false
  }
}

获取会话详细信息

https://api.vc.bilibili.com/session_svr/v1/session_svr/session_detail

请求方式:GET

认证方式:Cookie(SESSDATA)

若从未与该会话聊过天,则返回 1000004 入口节点已存在 错误

url参数:

参数名类型内容必要性备注
talker_idnum聊天对象的id必要session_type1 时表示用户 mid,为 2 时表示粉丝团 id
session_typenum聊天对象的类型必要1:用户
2:粉丝团
buildnum客户端内部版本号非必要默认为 0
mobi_appstr平台标识非必要可为 web

json回复:

根对象:

字段类型内容备注
codenum返回值0:成功
-101:账号未登录
-400:请求错误
1000004:入口节点已存在
msgstr错误信息默认为0
messagestr错误信息默认为0
ttlnum1
data有效时:obj
无效时:null
数据本体详见会话对象

示例:

获取会话talker_id=293793435&session_type=1的详细信息:

curl -G 'https://api.vc.bilibili.com/session_svr/v1/session_svr/session_detail' \\
  --data-urlencode 'talker_id=293793435' \\
  --data-urlencode 'session_type=1' \\
  --data-urlencode 'build=0' \\
  --data-urlencode 'mobi_app=web' \\
  -b 'SESSDATA=xxx'
查看响应示例:
{
  "code": 0,
  "msg": "0",
  "message": "0",
  "ttl": 1,
  "data": {
    "talker_id": 293793435,
    "session_type": 1,
    "at_seqno": 0,
    "top_ts": 0,
    "group_name": "",
    "group_cover": "",
    "is_follow": 1,
    "is_dnd": 0,
    "ack_seqno": 1236306587877408,
    "ack_ts": 1709536984481314,
    "session_ts": 1709385615744065,
    "unread_count": 0,
    "last_msg": {
      "sender_uid": 293793435,
      "receiver_type": 1,
      "receiver_id": 425503913,
      "msg_type": 11,
      "content": "{\\"title\\":\\"OHHHHHH家人们,我分数终于破w了!紫框了这下确实不好意思说自己是只打红谱的萌新了\\",\\"times\\":14,\\"cover\\":\\"http://i0.hdslb.com/bfs/archive/8821c03ab27a0bcf2bf32af814e758ab17a1e27e.png\\",\\"rid\\":1951316064,\\"type_\\":8,\\"desc\\":\\"OHHHHHH家人们,我分数终于破w了!紫框了这下确实不好意思说自己是只打红谱的萌新了\\",\\"bvid\\":\\"BV1zC411p7JN\\",\\"view\\":452,\\"danmaku\\":0,\\"pub_date\\":1709385603,\\"attach_msg\\":null}",
      "msg_seqno": 1236306587877408,
      "timestamp": 1709385615,
      "at_uids": null,
      "msg_key": 7341755312943193481,
      "msg_status": 0,
      "notify_code": "",
      "new_face_version": 1,
      "msg_source": 6
    },
    "group_type": 0,
    "can_fold": 0,
    "status": 0,
    "max_seqno": 1236306587877408,
    "new_push_msg": 0,
    "setting": 0,
    "is_guardian": 0,
    "is_intercept": 0,
    "is_trust": 0,
    "system_msg_type": 0,
    "live_status": 0,
    "biz_msg_unread_count": 0,
    "user_label": null
  }
}

获取会话限制状态

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

请求方式:GET

认证方式:Cookie(SESSDATA)

仅支持用户会话

url参数:

参数名类型内容必要性备注
uidnum聊天对象mid必要
typenum1必要

json回复:

根对象:

字段类型内容备注
codenum返回值0:成功
2:非法参数
-101:账号未登录
-400:请求错误
msgstr错误信息默认为0
messagestr错误信息默认为0
ttlnum1
dataobj数据本体

data对象:

字段类型内容备注
is_limitnum用户是否被封禁
report_limitnum自己是否被限制举报该会话常见于自己被封禁时出现该情况

示例:

获取uid=123的限制状态:

curl -G 'https://api.vc.bilibili.com/link_setting/v1/link_setting/is_limit' \\
  --data-urlencode 'uid=123' \\
  --data-urlencode 'type=1' \\
  -b 'SESSDATA=xxx'
查看响应示例:
{
  "code": 0,
  "msg": "0",
  "message": "0",
  "ttl": 1,
  "data": {
    "is_limit": 0,
    "report_limit": 0
  }
}

获取会话免打扰状态

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

请求方式:GET

认证方式:Cookie(SESSDATA)

url参数:

参数名类型内容必要性备注
own_uidnum自己的mid必要
uidsnum用户mid非必要仅支持填入 1 个 mid
group_idsnum粉丝团id非必要仅支持填入 1 个 id
buildnum客户端内部版本号非必要默认为 0
mobi_appstr平台标识非必要可为 web

json回复:

根对象:

字段类型内容备注
codenum返回值0:成功
2:非法参数
-101:账号未登录
-400:请求错误
msgstr错误信息默认为0
messagestr错误信息默认为0
ttlnum1
dataobj数据本体

data对象:

字段类型内容备注
uid_settingsarray用户免打扰状态仅当请求参数 uids 存在时有此项
group_settingsarray粉丝团免打扰状态仅当请求参数 group_ids 存在时有此项

data对象中的uid_settingsgroup_settings数组:

类型内容备注
0obj会话免打扰状态仅有1项

uid_settingsgroup_settings数组中的对象:

字段类型内容备注
idnum用户mid或粉丝团id
settingnum免打扰状态0:关闭免打扰
1:开启免打扰

示例:

获取会话uids=2group_ids=221082140的免打扰状态:

curl -G 'https://api.vc.bilibili.com/link_setting/v1/link_setting/get_msg_dnd' \\
  --data-urlencode 'own_uid=425503913' \\
  --data-urlencode 'uids=2' \\
  --data-urlencode 'group_ids=221082140' \\
  --data-urlencode 'build=0' \\
  --data-urlencode 'mobi_app=web' \\
  -b 'SESSDATA=xxx'
查看响应示例:
{
  "code": 0,
  "msg": "0",
  "message": "0",
  "ttl": 1,
  "data": {
    "uid_settings": [{
      "id": 2,
      "setting": 0
    }],
    "group_settings": [{
      "id": 221082140,
      "setting": 0
    }]
  }
}

获取会话推送设置

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

请求方式:GET

认证方式:Cookie(SESSDATA)

仅支持用户会话

url参数:

参数名类型内容必要性备注
talker_uidnum聊天对象mid必要
buildnum客户端内部版本号非必要默认为 0
mobi_appstr平台标识非必要可为 web

json回复:

根对象:

字段类型内容备注
codenum返回值0:成功
2:非法参数
-101:账号未登录
-400:请求错误
msgstr错误信息默认为0
messagestr错误信息默认为0
ttlnum1
dataobj数据本体

data对象:

字段类型内容备注
follow_statusnum对方对于自己的关注属性0:未关注
1:悄悄关注(现已下线)
2:已关注
6:已互粉
128:已拉黑
specialnum自己是否特别关注了对方
push_settingnum推送设置0:接收推送
1:不接收推送
show_push_settingnum是否显示推送设置

示例:

获取talker_uid=123的推送设置:

curl -G 'https://api.vc.bilibili.com/link_setting/v1/link_setting/get_session_ss' \\
  --data-urlencode 'talker_uid=123' \\
  --data-urlencode 'build=0' \\
  --data-urlencode 'mobi_app=web' \\
  -b 'SESSDATA=xxx'
查看响应示例:
{
  "code": 0,
  "msg": "0",
  "message": "0",
  "ttl": 1,
  "data": {
    "follow_status": 6,
    "special": 1,
    "push_setting": 0,
    "show_push_setting": 1
  }
}

设置会话为已读

https://api.vc.bilibili.com/session_svr/v1/session_svr/update_ack

请求方式:POST

认证方式:Cookie(SESSDATA)

将指定会话中的指定消息及以前的消息设置为已读

正文参数(application/x-www-form-urlencoded):

参数名类型内容必要性备注
talker_idnum聊天对象的id必要session_type1 时表示用户 mid,为 2 时表示粉丝团 id
session_typenum聊天对象的类型必要1:用户
2:粉丝团
ack_seqnonum设置为已读的消息序列号非必要留空表示最新的消息
csrf_tokenstrCSRF Token(位于cookie)必要
csrfstrCSRF Token(位于cookie)必要
buildnum客户端内部版本号非必要默认为 0
mobi_appstr平台标识非必要可为 web

json回复:

根对象:

字段类型内容备注
codenum返回值0:成功
-101:账号未登录
-400:请求错误
msgstr错误信息成功时为0
messagestr错误信息成功时为0
ttlnum默认为1
data有效时:obj
无效时:不存在该项
信息本体空对象

示例:

talker_id=293793435session_type=1ack_seqno=1236306587877408消息及之前的消息设置为已读

curl 'https://api.vc.bilibili.com/session_svr/v1/session_svr/update_ack' \\
  --data-urlencode 'talker_id=293793435' \\
  --data-urlencode 'session_type=1' \\
  --data-urlencode 'ack_seqno=1236306587877408' \\
  --data-urlencode 'csrf=xxx' \\
  --data-urlencode 'csrf_token=xxx' \\
  -b 'SESSDATA=xxx'
查看响应示例:
{
  "code": 0,
  "msg": "0",
  "message": "0",
  "ttl": 1,
  "data": {}
}

移除指定会话

https://api.vc.bilibili.com/session_svr/v1/session_svr/remove_session

请求方式:POST

认证方式:Cookie(SESSDATA)

将指定会话从会话列表中移除,不会删除聊天记录

正文参数(application/x-www-form-urlencoded):

参数名类型内容必要性备注
talker_idnum聊天对象的id必要session_type1 时表示用户 mid,为 2 时表示粉丝团 id
session_typenum聊天对象的类型必要1:用户
2:粉丝团
csrf_tokenstrCSRF Token(位于cookie)必要
csrfstrCSRF Token(位于cookie)必要
buildnum客户端内部版本号非必要默认为 0
mobi_appstr平台标识非必要可为 web

json回复:

根对象:

字段类型内容备注
codenum返回值0:成功
-101:账号未登录
-400:请求错误
msgstr错误信息成功时为0
messagestr错误信息成功时为0
ttlnum默认为1
data有效时:obj
无效时:不存在该项
信息本体空对象

示例:

移除会话talker_id=2&session_type=1

curl 'https://api.vc.bilibili.com/session_svr/v1/session_svr/remove_session' \\
  --data-urlencode 'talker_id=2' \\
  --data-urlencode 'session_type=1' \\
  --data-urlencode 'csrf=xxx' \\
  --data-urlencode 'csrf_token=xxx' \\
  -b 'SESSDATA=xxx'
查看响应示例:
{
  "code": 0,
  "msg": "0",
  "message": "0",
  "ttl": 1,
  "data": {}
}

修改会话置顶状态

https://api.vc.bilibili.com/session_svr/v1/session_svr/set_top

请求方式:POST

认证方式:Cookie(SESSDATA)

正文参数(application/x-www-form-urlencoded):

参数名类型内容必要性备注
talker_idnum聊天对象的id必要session_type1 时表示用户 mid,为 2 时表示粉丝团 id
session_typenum聊天对象的类型必要1:用户
2:粉丝团
op_typenum操作类型必要0:置顶
1:取消置顶
csrf_tokenstrCSRF Token(位于cookie)必要
csrfstrCSRF Token(位于cookie)必要
buildnum客户端内部版本号非必要默认为 0
mobi_appstr平台标识非必要可为 web

json回复:

根对象:

字段类型内容备注
codenum返回值0:成功
-101:账号未登录
-400:请求错误
msgstr错误信息成功时为0
messagestr错误信息成功时为0
ttlnum默认为1
data有效时:obj
无效时:不存在该项
信息本体空对象

示例:

置顶会话talker_id=293793435&session_type=1

curl 'https://api.vc.bilibili.com/session_svr/v1/session_svr/set_top' \\
  --data-urlencode 'talker_id=293793435' \\
  --data-urlencode 'session_type=1' \\
  --data-urlencode 'op_type=0' \\
  --data-urlencode 'csrf=xxx' \\
  --data-urlencode 'csrf_token=xxx' \\
  -b 'SESSDATA=xxx'
查看响应示例:
{
  "code": 0,
  "msg": "0",
  "message": "0",
  "ttl": 1,
  "data": {}
}

修改会话免打扰状态

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

请求方式:POST

认证方式:Cookie(SESSDATA)

正文参数(application/x-www-form-urlencoded):

参数名类型内容必要性备注
uidnum自己的mid非必要
settingnum免打扰设置必要0:取消免打扰
1:开启免打扰
dnd_uidnum用户mid必要(可选)当聊天对象为用户时有效
dnd_group_idnum粉丝团id必要(可选)当聊天对象为粉丝团时有效
csrf_tokenstrCSRF Token(位于cookie)必要
csrfstrCSRF Token(位于cookie)必要
buildnum客户端内部版本号非必要默认为 0
mobi_appstr平台标识非必要可为 web

json回复:

根对象:

字段类型内容备注
codenum返回值0:成功
-101:账号未登录
-400:请求错误
msgstr错误信息成功时为0
messagestr错误信息成功时为0
ttlnum默认为1
data有效时:obj
无效时:不存在该项
信息本体空对象

示例:

对会话dnd_uid=2开启免打扰

curl 'https://api.vc.bilibili.com/link_setting/v1/link_setting/set_msg_dnd' \\
  --data-urlencode 'uid=425503913' \\
  --data-urlencode 'setting=1' \\
  --data-urlencode 'dnd_uid=2' \\
  --data-urlencode 'csrf=xxx' \\
  --data-urlencode 'csrf_token=xxx' \\
  -b 'SESSDATA=xxx'
查看响应示例:
{
  "code": 0,
  "msg": "0",
  "message": "0",
  "ttl": 1,
  "data": {}
}

修改会话推送设置

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

请求方式:POST

认证方式:Cookie(SESSDATA)

仅支持用户会话

正文参数(application/x-www-form-urlencoded):

参数名类型内容必要性备注
talker_uidnum聊天对象mid必要
settingnum推送设置必要0:接收推送
1:不接收推送
csrf_tokenstrCSRF Token(位于cookie)必要
csrfstrCSRF Token(位于cookie)必要
buildnum客户端内部版本号非必要默认为 0
mobi_appstr平台标识非必要可为 web

json回复:

根对象:

字段类型内容备注
codenum返回值0:成功
-101:账号未登录
-400:请求错误
msgstr错误信息成功时为0
messagestr错误信息成功时为0
ttlnum默认为1
data有效时:obj
无效时:不存在该项
信息本体空对象

示例:

修改talker_uid=2的推送设置为不接收推送

curl 'https://api.vc.bilibili.com/link_setting/v1/link_setting/set_push_ss' \\
  --data-urlencode 'talker_uid=2' \\
  --data-urlencode 'setting=1' \\
  --data-urlencode 'csrf=xxx' \\
  --data-urlencode 'csrf_token=xxx' \\
  -b 'SESSDATA=xxx'
查看响应示例:
{
  "code": 0,
  "msg": "0",
  "message": "0",
  "ttl": 1,
  "data": {}
}

修改会话拦截状态

https://api.vc.bilibili.com/session_svr/v1/session_svr/update_intercept

请求方式:POST

认证方式:Cookie(SESSDATA)

仅支持用户会话

正文参数(application/x-www-form-urlencoded):

参数名类型内容必要性备注
talker_idnum聊天对象mid必要
statusnum拦截状态必要0:取消拦截
1:设置拦截
csrf_tokenstrCSRF Token(位于cookie)必要
csrfstrCSRF Token(位于cookie)必要
buildnum客户端内部版本号非必要默认为 0
mobi_appstr平台标识非必要可为 web

json回复:

根对象:

字段类型内容备注
codenum返回值0:成功
-101:账号未登录
-400:请求错误
msgstr错误信息成功时为0
messagestr错误信息成功时为0
ttlnum默认为1
data有效时:obj
无效时:不存在该项
信息本体空对象

示例:

对会话talker_id=2取消拦截状态

curl 'https://api.vc.bilibili.com/session_svr/v1/session_svr/update_intercept' \\
  --data-urlencode 'talker_id=2' \\
  --data-urlencode 'status=0' \\
  --data-urlencode 'csrf=xxx' \\
  --data-urlencode 'csrf_token=xxx' \\
  -b 'SESSDATA=xxx'
查看响应示例:
{
  "code": 0,
  "msg": "0",
  "message": "0",
  "ttl": 1,
  "data": {}
}

设置所有拦截会话为已读

https://api.vc.bilibili.com/session_svr/v1/session_svr/batch_update_dustbin_ack

请求方式:POST

认证方式:Cookie(SESSDATA)

正文参数(application/x-www-form-urlencoded):

参数名类型内容必要性备注
csrf_tokenstrCSRF Token(位于cookie)必要
csrfstrCSRF Token(位于cookie)必要
buildnum客户端内部版本号非必要默认为 0
mobi_appstr平台标识非必要可为 web

json回复:

根对象:

字段类型内容备注
codenum返回值0:成功
-101:账号未登录
-400:请求错误
msgstr错误信息成功时为0
messagestr错误信息成功时为0
ttlnum默认为1
data有效时:obj
无效时:不存在该项
信息本体空对象

示例:

curl 'https://api.vc.bilibili.com/session_svr/v1/session_svr/batch_update_dustbin_ack' \\
  --data-urlencode 'csrf=xxx' \\
  --data-urlencode 'csrf_token=xxx' \\
  -b 'SESSDATA=xxx'
查看响应示例:
{
  "code": 0,
  "msg": "0",
  "message": "0",
  "ttl": 1,
  "data": {}
}

移除所有拦截会话

https://api.vc.bilibili.com/session_svr/v1/session_svr/batch_rm_dustbin

请求方式:POST

认证方式:Cookie(SESSDATA)

正文参数(application/x-www-form-urlencoded):

参数名类型内容必要性备注
csrf_tokenstrCSRF Token(位于cookie)必要
csrfstrCSRF Token(位于cookie)必要
buildnum客户端内部版本号非必要默认为 0
mobi_appstr平台标识非必要可为 web

json回复:

根对象:

字段类型内容备注
codenum返回值0:成功
-101:账号未登录
-400:请求错误
msgstr错误信息成功时为0
messagestr错误信息成功时为0
ttlnum默认为1
data有效时:obj
无效时:不存在该项
信息本体空对象

示例:

curl 'https://api.vc.bilibili.com/session_svr/v1/session_svr/batch_rm_dustbin' \\
  --data-urlencode 'csrf=xxx' \\
  --data-urlencode 'csrf_token=xxx' \\
  -b 'SESSDATA=xxx'
查看响应示例:
{
  "code": 0,
  "msg": "0",
  "message": "0",
  "ttl": 1,
  "data": {}
}

私信消息相关

查询私信消息记录

https://api.vc.bilibili.com/svr_sync/v1/svr_sync/fetch_session_msgs

请求方式:GET

认证方式:Cookie(SESSDATA)

仅调用该接口不会设置会话为已读,详见设置会话为已读

此接口有设计缺陷,可以获取已经撤回(msg_status1)的私信内容

url参数:

参数名类型内容必要性备注
talker_idnum聊天对象的id必要session_type1 时表示用户 mid,为 2 时表示粉丝团 id
session_typenum聊天对象的类型必要1:用户
2:粉丝团
sizenum返回消息数量非必要默认为 0,最大为 2000
当本参数为 0 或不存在时,只返回系统提示
begin_seqnonum开始的序列号非必要提供本参数时返回以本序列号开始(不包括本序列号)的消息
end_seqnonum结束的序列号非必要提供本参数时返回以本序列号结束(不包括本序列号)的消息
sender_device_idnum发送者设备非必要默认为 1
buildnum客户端内部版本号非必要默认为 0
mobi_appstr平台标识非必要可为 web 等;若本参数值为 web,则返回新版表情包

json回复:

根对象:

字段类型内容备注
codenum返回值0:成功
2:非法参数
-101:账号未登录
-400:请求错误
700013:已解散QAQ,无法执行此操作
700014:你已不在此同萌中QAQ,无法执行此操作
msgstr错误信息默认为0
messagestr错误信息默认为0
ttlnum1
dataobj数据本体

data对象:

字段类型内容备注
messages有私信时:array
无私信时:null
私信列表按发送时间顺序逆向排序
has_morenum是否有更多私信
min_seqnonum所有消息中最小的序列号(最早)若无私信则为 18446744073709551615
max_seqnonum所有消息中最大的序列号(最晚)若无私信则为 0
e_infosarray聊天表情列表若私信列表中无表情则无此项

data对象中的messages数组:

类型内容备注
0obj私信1详见私信主体对象
nobj私信(n+1)
……obj…………

data对象中的e_infos数组:

类型内容备注
0obj表情1
nobj表情(n+1)
……obj…………

data对象中的e_infos数组中的对象:

字段类型内容备注
textstr表情名称包括左右两侧的中括号,如[tv_doge]
uristr表情链接
sizenum表情尺寸1:小
2:大
gif_urlstr表情GIF链接仅部分表情存在此项,如小电视表情

示例:

获取与目标用户mid=123的私信记录:

curl -G 'https://api.vc.bilibili.com/svr_sync/v1/svr_sync/fetch_session_msgs' \\
  --data-urlencode 'talker_id=123' \\
  --data-urlencode 'session_type=1' \\
  --data-urlencode 'size=20' \\
  --data-urlencode 'sender_device_id=1' \\
  --data-urlencode 'build=0' \\
  --data-urlencode 'mobi_app=web' \\
  -b 'SESSDATA=xxx'
查看响应示例:
{
  "code": 0,
  "msg": "0",
  "message": "0",
  "ttl": 1,
  "data": {
    "messages": [
      {
        "sender_uid": 2239814,
        "receiver_type": 1,
        "receiver_id": 123,
        "msg_type": 1,
        "content": "{\\"content\\":\\"[口罩]\\"}",
        "msg_seqno": 309675413389322,
        "timestamp": 1654154093,
        "at_uids": [
          0
        ],
        "msg_key": 7104537732714964358,
        "msg_status": 0,
        "notify_code": "",
        "new_face_version": 1,
        "msg_source": 2
      },
      {
        "sender_uid": 2239814,
        "receiver_type": 1,
        "receiver_id": 123,
        "msg_type": 5,
        "content": "{\\"content\\":\\"1\\"}",
        "msg_seqno": 308302399586307,
        "timestamp": 1654072255,
        "at_uids": [
          0
        ],
        "msg_key": 7104186240789226795,
        "msg_status": 0,
        "notify_code": "",
        "msg_source": 7

      },
    ],
    "has_more": 0,
    "min_seqno": 308188515844097,
    "max_seqno": 309675413389322,
    "e_infos": [
      {
        "text": "[口罩]",
        "url": "http://i0.hdslb.com/bfs/emote/3ad2f66b151496d2a5fb0a8ea75f32265d778dd3.png",
        "size": 1
      }
    ]
  }
}

获取多个视频、番剧、专栏的信息

https://api.vc.bilibili.com/x/im/feed/infoweb

请求方式:GET

认证方式:Cookie(SESSDATA)

可用于获取私信中分享或推送的多个视频、番剧、专栏的信息

url参数:

参数名类型内容必要性备注
aidsnums视频AV号列表必要 (可选)aidsep_idsarticle_ids 中须至少存在一个参数,每个成员间用 , 分隔,最多 50 个成员
ep_idsnums番剧epid列表必要 (可选)aidsep_idsarticle_ids 中须至少存在一个参数,每个成员间用 , 分隔,最多 50 个成员
article_idsnums专栏CV号列表必要 (可选)aidsep_idsarticle_ids 中须至少存在一个参数,每个成员间用 , 分隔,无成员限制
buildnum客户端内部版本号非必要默认为 0
mobi_appstr平台标识必要可为 web

json回复:

根对象:

字段类型内容备注
codenum返回值0:成功
-101:账号未登录
-400:请求错误
messagestr错误信息默认为0
ttlnum1
dataobj数据本体

data对象:

字段类型内容备注
archivearray视频信息列表仅在指定了 aids 参数时存在此项
articlearray专栏信息列表仅在指定了 article_ids 参数时存在此项
pgcarray番剧信息列表仅在指定了 ep_ids 参数时存在此项

archivearticlepgc数组:

类型内容备注
0obj信息1
nobj信息(n+1)
……obj…………

archive数组中的对象:

字段类型内容备注
bvidstr视频BV号
aidnum视频AV号
titlestr视频标题若视频失效则为 内容已失效
picstr视频封面若视频失效则为空文本
paramstr提供的参数即 AV 号的文本形式
uristr跳转urlbilibili://video/{视频AV号}
gotostrav
durationnum视频时长以秒为单位,若视频失效则为 0
up_namestr视频UP主昵称
viewnum视频播放量
danmakunum视频弹幕数
statusnum视频状态0:正常
-1:已失效
is_startednum1作用尚不明确

article数组中的对象:

字段类型内容备注
idnum专栏CV号
titlestr专栏标题若专栏失效则为 内容已失效
summarystr专栏内容概要若专栏失效则为空文本
template_idnum(?)作用尚不明确
up_namestr专栏UP主昵称若专栏失效则为空文本
image_urlsarray专栏封面列表若专栏失效则为空数组
view_numnum专栏观看数若专栏失效则为 0
like_numnum专栏点赞数若专栏失效则为 0
reply_numnum专栏评论数若专栏失效则为 0
statusnum专栏状态0:正常
-1:已失效

image_urls数组:

类型内容备注
0str封面1
nstr封面(n+1)
……str…………

pgc数组中的对象:

字段类型内容备注
ep_idnum番剧epid
coverstr番剧封面url
titlestr番剧分享标题《{番剧名}》 第{n}话 {单集标题}《{番剧名}》 {备注}
durationnum番剧时长以秒为单位
viewnum番剧播放量
danmakunum番剧弹幕数
urlstr跳转urlhttps://www.bilibili.com/bangumi/play/ep{番剧epid}

示例:

获取aids=170001&ep_ids=780019&article_ids=1的信息

curl -G 'https://api.vc.bilibili.com/x/im/feed/infoweb' \\
  --data-urlencode 'aids=170001' \\
  --data-urlencode 'ep_ids=780019' \\
  --data-urlencode 'article_ids=1' \\
  --data-urlencode 'build=0' \\
  --data-urlencode 'mobi_app=web' \\
  -b 'SESSDATA=xxx'
查看响应示例:
{
  "code": 0,
  "message": "0",
  "ttl": 1,
  "data": {
    "archive": [
      {
        "bvid": "BV17x411w7KC",
        "aid": 170001,
        "title": "【MV】保加利亚妖王AZIS视频合辑",
        "pic": "http://i2.hdslb.com/bfs/archive/1ada8c32a9d168e4b2ee3e010f24789ba3353785.jpg",
        "param": "170001",
        "uri": "bilibili://video/170001?player_height=288&player_rotate=0&player_width=512",
        "goto": "av",
        "duration": 2412,
        "up_name": "冰封.虾子",
        "view": 44809333,
        "danmaku": 913266,
        "status": 0,
        "is_started": 1
      }
    ],
    "article": [
      {
        "id": 1,
        "title": "未知的光",
        "summary": "天空像是倾倒出的墨水,黑得静谧而深邃。黎明还远,光亮全无。夜不能寐。披衣,起床。茶香的弥漫,一盏灯的相伴。夜,你是我久别重逢的朋友,那一刹那的相见,带给了我久违的安思。如果不是梦魇的皮闹,我本不该投入",
        "template_id": 4,
        "up_name": "健行见远渐忘",
        "image_urls": [
          "https://i0.hdslb.com/bfs/article/d2eedf1fd338bceca10099e2f7b33fa9017c859b.jpg"
        ],
        "view_num": 1608818,
        "like_num": 32247,
        "reply_num": 14143,
        "status": 0
      }
    ],
    "pgc": [
      {
        "ep_id": 780019,
        "cover": "http://i0.hdslb.com/bfs/archive/ee28c04d15fb133a9c70c502fabfbdc7e5051ffe.png",
        "title": "《铃芽之旅》 新海诚集大成之作",
        "duration": 7283,
        "view": 22088209,
        "danmaku": 93069,
        "url": "https://www.bilibili.com/bangumi/play/ep780019"
      }
    ]
  }
}

发送私信(web端)

https://api.vc.bilibili.com/web_im/v1/web_im/send_msg

请求方式:POST

认证方式:Cookie(SESSDATA)

`,295)),s("p",null,[n[51]||(n[51]=a("鉴权方式:")),l(t,{to:"/docs/misc/sign/wbi.html"},{default:o(()=>n[50]||(n[50]=[a("Wbi 签名")])),_:1,__:[50]})]),n[98]||(n[98]=e("

仅支持发送 msg[msg_type]125 的私信

调用该接口会将该会话设置为已读

URL参数:

",3)),s("table",null,[n[67]||(n[67]=s("thead",null,[s("tr",null,[s("th",null,"参数名"),s("th",null,"类型"),s("th",null,"内容"),s("th",null,"必要性"),s("th",null,"备注")])],-1)),s("tbody",null,[n[64]||(n[64]=s("tr",null,[s("td",null,"w_sender_uid"),s("td",null,"num"),s("td",null,"发送者mid"),s("td",null,"非必要"),s("td",null,[a("同正文参数 "),s("code",null,"msg[sender_uid]")])],-1)),n[65]||(n[65]=s("tr",null,[s("td",null,"w_receiver_id"),s("td",null,"num"),s("td",null,"接收者id"),s("td",null,"非必要"),s("td",null,[a("同正文参数 "),s("code",null,"msg[receiver_id]")])],-1)),n[66]||(n[66]=s("tr",null,[s("td",null,"w_dev_id"),s("td",null,"str"),s("td",null,"设备id"),s("td",null,"非必要"),s("td",null,[a("同正文参数 "),s("code",null,"msg[dev_id]")])],-1)),s("tr",null,[n[54]||(n[54]=s("td",null,"w_rid",-1)),n[55]||(n[55]=s("td",null,"str",-1)),n[56]||(n[56]=s("td",null,"Wbi 签名",-1)),n[57]||(n[57]=s("td",null,"非必要",-1)),s("td",null,[n[53]||(n[53]=a("参见 ")),l(t,{to:"/docs/misc/sign/wbi.html"},{default:o(()=>n[52]||(n[52]=[a("Wbi 签名")])),_:1,__:[52]})])]),s("tr",null,[n[60]||(n[60]=s("td",null,"wts",-1)),n[61]||(n[61]=s("td",null,"str",-1)),n[62]||(n[62]=s("td",null,"UNIX 秒级时间戳",-1)),n[63]||(n[63]=s("td",null,"非必要",-1)),s("td",null,[n[59]||(n[59]=a("参见 ")),l(t,{to:"/docs/misc/sign/wbi.html"},{default:o(()=>n[58]||(n[58]=[a("Wbi 签名")])),_:1,__:[58]})])])])]),n[99]||(n[99]=s("p",null,[s("strong",null,"正文参数(application/x-www-form-urlencoded):")],-1)),s("table",null,[n[94]||(n[94]=s("thead",null,[s("tr",null,[s("th",null,"参数名"),s("th",null,"类型"),s("th",null,"内容"),s("th",null,"必要性"),s("th",null,"备注")])],-1)),s("tbody",null,[n[83]||(n[83]=s("tr",null,[s("td",null,"msg[sender_uid]"),s("td",null,"num"),s("td",null,"发送者mid"),s("td",null,"必要"),s("td",null,"必须为自己的 mid")],-1)),n[84]||(n[84]=s("tr",null,[s("td",null,"msg[receiver_id]"),s("td",null,"num"),s("td",null,"接收者id"),s("td",null,"必要"),s("td",null,[s("code",null,"msg[receiver_type]"),a(" 为 "),s("code",null,"1"),a(" 时表示用户 mid,为 "),s("code",null,"2"),a(" 时表示粉丝团 id")])],-1)),n[85]||(n[85]=s("tr",null,[s("td",null,"msg[receiver_type]"),s("td",null,"num"),s("td",null,"接收者类型"),s("td",null,"必要"),s("td",null,[a("1:用户"),s("br"),a("2:粉丝团")])],-1)),s("tr",null,[n[72]||(n[72]=s("td",null,"msg[msg_type]",-1)),n[73]||(n[73]=s("td",null,"num",-1)),n[74]||(n[74]=s("td",null,"消息类型",-1)),n[75]||(n[75]=s("td",null,"必要",-1)),s("td",null,[n[69]||(n[69]=a("详见")),l(t,{to:"/docs/message/private_msg_content.html"},{default:o(()=>n[68]||(n[68]=[a("私信消息类型、内容说明")])),_:1,__:[68]}),n[70]||(n[70]=s("br",null,null,-1)),n[71]||(n[71]=s("strong",null,[a("此接口仅支持传入 "),s("code",null,"1"),a("、"),s("code",null,"2"),a(" 或 "),s("code",null,"5")],-1))])]),n[86]||(n[86]=s("tr",null,[s("td",null,"msg[msg_status]"),s("td",null,"num"),s("td",null,"消息状态"),s("td",null,"非必要"),s("td",null,[a("恒为 "),s("code",null,"0")])],-1)),n[87]||(n[87]=s("tr",null,[s("td",null,"msg[dev_id]"),s("td",null,"str"),s("td",null,"设备id"),s("td",null,"必要"),s("td",null,[a("实质上即 UUID(版本 4),"),s("strong",null,"生成方式见下")])],-1)),n[88]||(n[88]=s("tr",null,[s("td",null,"msg[timestamp]"),s("td",null,"num"),s("td",null,"当前时间戳(秒)"),s("td",null,"必要"),s("td")],-1)),n[89]||(n[89]=s("tr",null,[s("td",null,"msg[new_face_version]"),s("td",null,"num"),s("td",null,"表情包版本"),s("td",null,"非必要"),s("td",null,[a("提供 "),s("code",null,"0"),a(" 或者未提供本参数表示旧版表情包,此时 B 站会自动转换成新版表情包,例如 "),s("code",null,"[doge]"),a(" -> "),s("code",null,"[tv_doge]"),a(";"),s("code",null,"1"),a(" 为新版")])],-1)),s("tr",null,[n[79]||(n[79]=s("td",null,"msg[content]",-1)),n[80]||(n[80]=s("td",null,"str",-1)),n[81]||(n[81]=s("td",null,"消息内容",-1)),n[82]||(n[82]=s("td",null,"必要",-1)),s("td",null,[n[77]||(n[77]=a("详见")),l(t,{to:"/docs/message/private_msg_content.html"},{default:o(()=>n[76]||(n[76]=[a("私信消息类型、内容说明")])),_:1,__:[76]}),n[78]||(n[78]=a(",接受最多2000字节的内容"))])]),n[90]||(n[90]=s("tr",null,[s("td",null,"csrf_token"),s("td",null,"str"),s("td",null,"CSRF Token(位于cookie)"),s("td",null,"必要"),s("td")],-1)),n[91]||(n[91]=s("tr",null,[s("td",null,"csrf"),s("td",null,"str"),s("td",null,"CSRF Token(位于cookie)"),s("td",null,"必要"),s("td")],-1)),n[92]||(n[92]=s("tr",null,[s("td",null,"build"),s("td",null,"num"),s("td",null,"客户端内部版本号"),s("td",null,"非必要"),s("td",null,[a("默认为 "),s("code",null,"0")])],-1)),n[93]||(n[93]=s("tr",null,[s("td",null,"mobi_app"),s("td",null,"str"),s("td",null,"平台标识"),s("td",null,"非必要"),s("td",null,[a("可为 "),s("code",null,"web"),a(" 等")])],-1))])]),n[100]||(n[100]=e(`

dev_id 的生成:

dev_id 实质上就是 UUID(版本 4)

查看生成 UUID 的代码

Python

import uuid

dev_id = str(uuid.uuid4())

JavaScript

以下代码适用于较新版的 JS 引擎(Chrome≥92,Firefox≥95,Safari≥15.4,Node.js≥19.0.0):

const dev_id = crypto.randomUUID();

以下为通用代码(来自 andywang425/BLTH):

const dev_id = "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (function (name) {
  const randomInt = 16 * Math.random() | 0;
  return ("x" === name ? randomInt : 3 & randomInt | 8).toString(16).toUpperCase();
}));

Java

import java.util.UUID;

public class Main {
  private String getDevId() {
    UUID uuid = UUID.randomUUID();
    return uuid.toString();
  }
}

json回复:

根对象:

字段类型内容备注
codenum返回值0:成功
-3:系统错误
-101:账号未登录
-400:请求错误
10005:msgkey不存在
21007:消息过长,无法发送
21015:为了维护社区的良好秩序,只有绑定手机号的账号才能发送消息
21020:你发送消息频率过快,请稍后再发~
21026:不能给自己发送消息哦~
21028:由于系统升级,暂无法发送,敬请谅解
21035:该类消息暂时无法发送
21037:图片格式不合法,不要调戏接口啦
21041:消息已超期,不能撤回了哦
21042:消息已经撤回了哦
21046:你发消息的频率太高了,请在24小时后再发吧~
21047:对方主动回复或关注你前,最多发送1条消息~
25003:因对方隐私设置,暂无法给他发送聊天消息
25005:你已拉黑了对方,请先将对方移出黑名单后才能聊天
700013:已解散QAQ,无法执行此操作
700014:你已不在此同萌中QAQ,无法执行此操作
messagestr错误信息成功时为0
ttlnum默认为1
data有效时:obj
无效时:null
信息本体

data对象:

字段类型内容备注
msg_keynum消息唯一id
e_infosarray表情列表仅当请求参数 msg[msg_type]1,且私信内容中有表情时有此项
msg_contentstr发送的私信内容一般同请求参数 msg[content] 的值,仅当请求参数 msg[msg_type]1 时有此项
key_hit_infosobj触发的提示仅当请求参数 msg[msg_type]1msg[receiver_type]1 时有此项

e_infos数组:

类型内容备注
0obj表情1
nobj表情(n+1)
……obj…………

e_infos数组中的对象:

字段类型内容备注
textstr表情名称包括左右两侧的中括号,如 [tv_doge]
uristr表情链接
sizenum表情尺寸1:小
2:大
gif_urlstr表情GIF链接仅部分表情存在此项,如小电视表情

key_hit_infos对象:

字段类型内容备注
toaststr提示信息文字当触发了提示时有此项
rule_idnum触发的规则id当触发了提示时有此项,详细信息有待补充
high_textarray高亮的文本当触发了提示时有此项

high_text数组:

类型内容备注
0obj高亮文本1详细信息有待补充
nobj高亮文本(n+1)
……obj…………

示例:

给目标用户mid=1发一条文字私信:

up主你好,
催更[doge]

curl 'https://api.vc.bilibili.com/web_im/v1/web_im/send_msg' \\
  --data-urlencode 'msg[sender_uid]=293793435' \\
  --data-urlencode 'msg[receiver_id]=1' \\
  --data-urlencode 'msg[receiver_type]=1' \\
  --data-urlencode 'msg[msg_type]=1' \\
  --data-urlencode 'msg[msg_status]=0' \\
  --data-urlencode 'msg[dev_id]=372778FD-E359-461D-86A3-EA2BCC6FF52A' \\
  --data-urlencode 'msg[timestamp]=1626181379' \\
  --data-urlencode 'msg[new_face_version]=1' \\
  --data-urlencode 'msg[content]={"content":"up主你好,\\n催更[doge]"}' \\
  --data-urlencode 'csrf=xxx' \\
  --data-urlencode 'csrf_token=xxx' \\
  -b 'SESSDATA=xxx'
查看响应示例:
{
  "code": 0,
  "message": "0",
  "ttl": 1,
  "data": {
    "msg_key": 6984393491767669026,
    "e_infos": [
      {
        "text": "[doge]",
        "url": "https://i0.hdslb.com/bfs/emote/3087d273a78ccaff4bb1e9972e2ba2a7583c9f11.png",
        "size": 1
      }
    ],
    "msg_content": "{\\"content\\":\\"up主你好,\\\\n催更[doge]\\"}",
    "key_hit_infos": {}
  }
}

给目标用户mid=1发一条图片私信:

curl 'https://api.vc.bilibili.com/web_im/v1/web_im/send_msg' \\
  --data-urlencode 'msg[sender_uid]=293793435' \\
  --data-urlencode 'msg[receiver_id]=1' \\
  --data-urlencode 'msg[receiver_type]=1' \\
  --data-urlencode 'msg[msg_type]=2' \\
  --data-urlencode 'msg[msg_status]=0' \\
  --data-urlencode 'msg[dev_id]=372778FD-E359-461D-86A3-EA2BCC6FF52A' \\
  --data-urlencode 'msg[timestamp]=1626181379' \\
  --data-urlencode 'msg[content]={"url":"https://i1.hdslb.com/bfs/face/aebb2639a0d47f2ce1fec0631f412eaf53d4a0be.jpg","height":300,"width":300,"imageType":"jpeg","original":1,"size":54.144}' \\
  --data-urlencode 'csrf=xxx' \\
  --data-urlencode 'csrf_token=xxx' \\
  -b 'SESSDATA=xxx'
查看响应示例:
{
  "code": 0,
  "message": "0",
  "data": {
    "msg_key": 6852570013146024354
  }
}

给目标用户mid=1发送会触发提示的私信:

支付宝

curl 'https://api.vc.bilibili.com/web_im/v1/web_im/send_msg' \\
  --data-urlencode 'msg[sender_uid]=293793435' \\
  --data-urlencode 'msg[receiver_id]=1' \\
  --data-urlencode 'msg[receiver_type]=1' \\
  --data-urlencode 'msg[msg_type]=1' \\
  --data-urlencode 'msg[msg_status]=0' \\
  --data-urlencode 'msg[dev_id]=372778FD-E359-461D-86A3-EA2BCC6FF52A' \\
  --data-urlencode 'msg[timestamp]=1626181379' \\
  --data-urlencode 'msg[content]={"content":"支付宝"}' \\
  --data-urlencode 'csrf=xxx' \\
  --data-urlencode 'csrf_token=xxx' \\
  -b 'SESSDATA=xxx'
查看响应示例:
{
  "code": 0,
  "message": "0",
  "ttl": 1,
  "data": {
    "msg_key": 6984393491767669026,
    "msg_content": "{\\"content\\":\\"支付宝\\"}",
    "key_hit_infos": {
      "toast": "【温馨提示】为保障消费者权益,根据平台规则,如创作者在与消费者沟通中进行发布要求非法转账、欺诈转账等违规行为,平台有权对此进行处罚,感谢您的理解。",
      "rule_id": 2,
      "high_text": [{}]
    }
  }
}
`,31))])}const m=p(i,[["render",D]]),C=JSON.parse('{"path":"/docs/message/private_msg.html","title":"私信","lang":"zh-CN","frontmatter":{},"git":{"updatedTime":1747326482000,"contributors":[{"name":"SocialSisterYi","username":"SocialSisterYi","email":"1440239038@qq.com","commits":3,"url":"https://github.com/SocialSisterYi"},{"name":"Liyan Zhao","username":"","email":"return_2@qq.com","commits":2},{"name":"hd80606b","username":"hd80606b","email":"42578272+hd80606b@users.noreply.github.com","commits":1,"url":"https://github.com/hd80606b"},{"name":"wuziqian211","username":"wuziqian211","email":"65224318+wuziqian211@users.noreply.github.com","commits":37,"url":"https://github.com/wuziqian211"},{"name":"SessionHu","username":"SessionHu","email":"102411014+SessionHu@users.noreply.github.com","commits":3,"url":"https://github.com/SessionHu"},{"name":"Kataick","username":"Kataick","email":"24969684+Kataick@users.noreply.github.com","commits":4,"url":"https://github.com/Kataick"}],"changelog":[{"hash":"af1fdba3985599286c68764d74cfbf2d5816f346","time":1747326482000,"email":"65224318+wuziqian211@users.noreply.github.com","author":"晨叶梦春","message":"fix(private_msg): missing end tags & wrong request method"},{"hash":"75d599714e2d943bcf9c38a23612ad69bea888aa","time":1747074561000,"email":"65224318+wuziqian211@users.noreply.github.com","author":"晨叶梦春","message":"feat(relation): add re_src details"},{"hash":"c0120224eba47d278242f0fd073064e2821c6d53","time":1746940688000,"email":"65224318+wuziqian211@users.noreply.github.com","author":"晨叶梦春","message":"fix(private_msg): add missing text"},{"hash":"f3a09eeb6569628197f1fe3733359c325e86b784","time":1746909760000,"email":"65224318+wuziqian211@users.noreply.github.com","author":"晨叶梦春","message":"fix(private_msg): some mistakes"},{"hash":"1c5a07002b71263c31c6e9c1a4b011becaaf3e89","time":1746908906000,"email":"65224318+wuziqian211@users.noreply.github.com","author":"晨叶梦春","message":"feat(private_msg): get msg dnd & intercept"},{"hash":"8d316f4cd030f1ac8b8b8d1d7dcee0d65273afd7","time":1746549796000,"email":"65224318+wuziqian211@users.noreply.github.com","author":"晨叶梦春","message":"feat(message): add details"},{"hash":"20ebf795b0bd9b7132881bd0d6a81a38980d270f","time":1746392284000,"email":"65224318+wuziqian211@users.noreply.github.com","author":"晨叶梦春","message":"style(private_msg): add session & message category"},{"hash":"9c2214be5e60f3ae18f883190aacd4aa9fb9356b","time":1746378218000,"email":"65224318+wuziqian211@users.noreply.github.com","author":"晨叶梦春","message":"style(private_msg): add spaces in request example"},{"hash":"b196d49bb11ad250ce85a2546f4407b6c28903c7","time":1746375979000,"email":"65224318+wuziqian211@users.noreply.github.com","author":"晨叶梦春","message":"fix(private_msg): escape characters"},{"hash":"591dcf4d9f4b6c4ca8ff3390ae71b4a25df86afa","time":1746374328000,"email":"65224318+wuziqian211@users.noreply.github.com","author":"晨叶梦春","message":"style: wrap URLs with angle brackets"},{"hash":"35510b7a088cadead2a2e6455de262e6c4c9e657","time":1746207548000,"email":"65224318+wuziqian211@users.noreply.github.com","author":"晨叶梦春","message":"feat: add details & replace spaces"},{"hash":"5c303a22e48ad1d9e3e534e46a60fcb244605631","time":1744896352000,"email":"65224318+wuziqian211@users.noreply.github.com","author":"晨叶梦春","message":"Update private_msg.md"},{"hash":"d4f2dad7fd2b0252e4956af062826dacc02225b1","time":1744731994000,"email":"65224318+wuziqian211@users.noreply.github.com","author":"晨叶梦春","message":"update"},{"hash":"93b4a09aa0cb45e1d856198d10f660365ea684be","time":1744726185000,"email":"65224318+wuziqian211@users.noreply.github.com","author":"晨叶梦春","message":"update"},{"hash":"0f804d9752776fe1e847069d618bddbb0e53fbc0","time":1744645562000,"email":"24969684+Kataick@users.noreply.github.com","author":"Kataick","message":"删除多余的间隔符"},{"hash":"52f0d2b3799807d95851da3f30610ac1ee7f9f88","time":1744645483000,"email":"24969684+Kataick@users.noreply.github.com","author":"Kataick","message":"update"},{"hash":"b65aaf93127d738a123d041a45910dd3afae6993","time":1744641564000,"email":"24969684+Kataick@users.noreply.github.com","author":"Kataick","message":"@Kataick docs(message): 更新发送私信文档(wbi)"},{"hash":"2ca9272972d82f56037b5c5c73f55878741712ca","time":1732342344000,"email":"24969684+Kataick@users.noreply.github.com","author":"Kataick","message":"docs(message): 更新查询私信消息记录文档"},{"hash":"41d73f1a20d856ffc5468243fbf17e5a35dc1a92","time":1726838526000,"email":"65224318+wuziqian211@users.noreply.github.com","author":"晨叶梦春","message":"feat: 添加消息中心接口相关说明 (#983)"},{"hash":"1e24c6b1889160c4c35c01416aa4239501accf5f","time":1726759053000,"email":"102411014+SessionHu@users.noreply.github.com","author":"Session小胡","message":"调整部分接口描述与错误修复 (#1088)","coAuthors":[{"name":"社会易姐QwQ","email":"45892418+SocialSisterYi@users.noreply.github.com"}]},{"hash":"a329eff0ee24d285cf7a0034c5fedf989dc266e7","time":1726496841000,"email":"65224318+wuziqian211@users.noreply.github.com","author":"wuziqian211","message":"update docs"},{"hash":"60a0c5d1a2f44fe61335da04571305fa7727a968","time":1724238159000,"email":"102411014+SessionHu@users.noreply.github.com","author":"Session小胡","message":"feat: 各种接口补充与错误修正 (#1066)"},{"hash":"81527857daaa1a14f14fe5605eda5ba2933678f2","time":1722354136000,"email":"65224318+wuziqian211@users.noreply.github.com","author":"wuziqian211","message":"update docs"},{"hash":"9fd100707228109005ae33f0832b280174e7f6b7","time":1722244125000,"email":"65224318+wuziqian211@users.noreply.github.com","author":"wuziqian211","message":"update docs"},{"hash":"6e033f7fa04945a4e7629703831a11735d522f75","time":1722170715000,"email":"65224318+wuziqian211@users.noreply.github.com","author":"wuziqian211","message":"update docs"},{"hash":"750dd6a924cbeff0c87e9db36d48f4c9fdd3e571","time":1721471929000,"email":"102411014+SessionHu@users.noreply.github.com","author":"Session小胡","message":"feat: 更新部分接口 (#1056)"},{"hash":"44003bc689d678b3e3ebc0686add8383c0616830","time":1719426806000,"email":"65224318+wuziqian211@users.noreply.github.com","author":"wuziqian211","message":"update docs"},{"hash":"7d9b466bc429f45ddfb36bb6b21b1a52802ad1a2","time":1719165232000,"email":"65224318+wuziqian211@users.noreply.github.com","author":"wuziqian211","message":"Update private_msg.md"},{"hash":"ba78a787e6a7129e1238acff9e188c8b998926b9","time":1718651482000,"email":"65224318+wuziqian211@users.noreply.github.com","author":"wuziqian211","message":"fix: typo"},{"hash":"9b8059001bd0e3be38e2a3058a94e7787d9cc1cd","time":1718650703000,"email":"65224318+wuziqian211@users.noreply.github.com","author":"wuziqian211","message":"update docs"},{"hash":"86ef2ee8a4e946b53960c608b3e03c26fc496394","time":1718024147000,"email":"65224318+wuziqian211@users.noreply.github.com","author":"wuziqian211","message":"feat: #1033"},{"hash":"2c9960f18898ca93408b1ed3b11a66338e453569","time":1716911224000,"email":"65224318+wuziqian211@users.noreply.github.com","author":"wuziqian211","message":"update docs"},{"hash":"d50666c092a25671383e2e6b2825658aabe27f48","time":1714762974000,"email":"65224318+wuziqian211@users.noreply.github.com","author":"wuziqian211","message":"fix: typo"},{"hash":"58c76504cacaa0bf2d4c0501944a027d3631aca5","time":1714762809000,"email":"65224318+wuziqian211@users.noreply.github.com","author":"wuziqian211","message":"Update private_msg.md"},{"hash":"6521e3fea37a348230426c36499fc083d7887a21","time":1714761544000,"email":"65224318+wuziqian211@users.noreply.github.com","author":"wuziqian211","message":"Update CONTRIBUTING.md"},{"hash":"b27143a56cd488d2289961bbae3236a0eba5cba9","time":1713719101000,"email":"65224318+wuziqian211@users.noreply.github.com","author":"wuziqian211","message":"添加 #1008 相关说明"},{"hash":"81de2eb2bae66dbeec4daa496c7ad33361057a7d","time":1712421790000,"email":"65224318+wuziqian211@users.noreply.github.com","author":"wuziqian211","message":"更新 private_msg.md"},{"hash":"fc60fd44a5fbadb7608e9fbbc3534a98de175cc2","time":1712420932000,"email":"65224318+wuziqian211@users.noreply.github.com","author":"wuziqian211","message":"update docs"},{"hash":"8539abd12f9171d7912922a2cff4ea9eae12213d","time":1711905279000,"email":"65224318+wuziqian211@users.noreply.github.com","author":"wuziqian211","message":"add more docs"},{"hash":"b8da0e5b18258c79ac69088552a4aa86a4dead2f","time":1710531172000,"email":"65224318+wuziqian211@users.noreply.github.com","author":"wuziqian211","message":"update"},{"hash":"e6072a6a6978fa5e6b0aa3f8dc9833ef07432ae8","time":1710436321000,"email":"65224318+wuziqian211@users.noreply.github.com","author":"wuziqian211","message":"update"},{"hash":"b6fb3b5efd122c3e81a556426935a979364cad01","time":1710355871000,"email":"65224318+wuziqian211@users.noreply.github.com","author":"wuziqian211","message":"update"},{"hash":"b3d6d18f823a6c3342cdba837bd422a3e69596f9","time":1710349951000,"email":"65224318+wuziqian211@users.noreply.github.com","author":"wuziqian211","message":"update docs"},{"hash":"d04d4193be98bdf8c91addc6ef807385ac09831c","time":1710270147000,"email":"65224318+wuziqian211@users.noreply.github.com","author":"wuziqian211","message":"update"},{"hash":"d0f6de0b4fde3d3cfed49b0a5c5bb423de140ab6","time":1705054124000,"email":"42578272+hd80606b@users.noreply.github.com","author":"hd80606b","message":"新增私信消息记录参数,新增青少年模式接口 (#935)"},{"hash":"38cec8413a374602d2e30986848e436b8733cf2c","time":1695980479000,"email":"return65535@qq.com","author":"Liyan Zhao","message":"Update new_face_version (#825)"},{"hash":"5a4761ee696a38387da15bbc52ccaa9f9c2ef3d2","time":1694773724000,"email":"return_2@qq.com","author":"Liyan Zhao","message":"add description for seqno (#814)"},{"hash":"f6760f4be38d5b592d396b211e48c666286524de","time":1677124138000,"email":"1440239038@qq.com","author":"SocialSisterYi","message":"🔨remove header index"},{"hash":"7d89ece2ac46425810647c4ac92acf5f3721cb68","time":1676998806000,"email":"1440239038@qq.com","author":"SocialSisterYi","message":"🚀调整项目结构"}]},"filePathRelative":"docs/message/private_msg.md"}');export{m as comp,C as data};