From f1c53f92f429ad519e5eb8bafcf95885fad0588c Mon Sep 17 00:00:00 2001 From: wuziqian211 <65224318+wuziqian211@users.noreply.github.com> Date: Thu, 28 Mar 2024 23:21:30 +0800 Subject: [PATCH] update --- docs/message/msg.md | 2 + docs/message/private_msg_content.md | 66 ++++++++++++++++++++++------- docs/user/info.md | 26 +++++------- 3 files changed, 64 insertions(+), 30 deletions(-) diff --git a/docs/message/msg.md b/docs/message/msg.md index fa46f23..018b5c6 100644 --- a/docs/message/msg.md +++ b/docs/message/msg.md @@ -8,6 +8,8 @@ 认证方式：Cookie（SESSDATA） +本接口不会返回未读的私信数，要获取未读的私信数请查看[未读私信数](private_msg.md#未读私信数)相关说明 + **json回复：** 根对象： diff --git a/docs/message/private_msg_content.md b/docs/message/private_msg_content.md index fb7640f..fb33b9e 100644 --- a/docs/message/private_msg_content.md +++ b/docs/message/private_msg_content.md @@ -1,6 +1,10 @@ # 私信消息类型、内容说明 -## 文字消息（`msg_type=1`） +## 通用消息类型 + +以下消息类型适用于大多数会话 + +### 文字消息（`msg_type=1`） 在发送私信时，请确保下面的对象合法且 `content` 项的值为非空文本，否则会提示 `请求错误` @@ -20,7 +24,7 @@ } ``` -## 图片消息（`msg_type=2`） +### 图片消息（`msg_type=2`） 在发送私信时，请确保下面的对象合法且 `url` 项的值为 B 站的图床 url，否则会报 21037 `图片格式不合法，不要调戏接口啦` 错误 @@ -50,11 +54,11 @@ } ``` -## 撤回消息（`msg_type=5`） +### 撤回消息（`msg_type=5`） 内容为目标私信的 `msg_key` -请确保目标私信存在、在撤回有效期里，且与发送的私信在同一会话内；成功发送此私信后，目标私信的 `msg_status` 会变成 `1` +请确保目标私信存在、在撤回有效期（120 秒）里，且与发送的私信在同一会话内；成功发送此私信后，目标私信的 `msg_status` 会变成 `1` **示例：** @@ -68,7 +72,7 @@ ## 自定义表情消息（`msg_type=6`） -对象结构基本同 [图片消息](#图片消息msg_type2) +结构同[图片消息](#图片消息msg_type2) ## 分享消息（`msg_type=7`） @@ -100,11 +104,37 @@ } ``` -## 小程序消息（`msg_type=9`） +### 小程序消息（`msg_type=9`） -待补充 +根对象： -## 通知消息（`msg_type=10`） +| 字段 | 类型 | 内容 | 备注 | +| ----------- | ---- | ------------ | ------------------------- | +| avatar | str | 小程序图标 | | +| cover | str | 小程序封面 | | +| id | str | 小程序id | | +| jump_uri | str | 小程序链接 | | +| label_cover | str | 标签图标 | | +| label_name | str | 标签文字内容 | | +| name | str | 小程序名称 | | +| title | str | 小程序标题 | | + +**示例：** + +```json +{ + "avatar": "http://i0.hdslb.com/bfs/mall/mall/7b/dd/7bdd072290de017593791b52e937ca29.png", + "cover": "http://i0.hdslb.com/bfs/mall/mall/7b/dd/7bdd072290de017593791b52e937ca29.png", + "id": "bili91e3e7e93af281f9", + "jump_uri": "https://mall.bilibili.com/miniapp/bili91e3e7e93af281f9/pages/main?___timestamp=1689526821040&_biliFrom=about_bili_message&share_medium=android&share_source=bili_message&bbid=XU8CE838022AF6625C64B2153A3EF1E571AFF&ts=1689526821048", + "label_cover": "https://i0.hdslb.com/bfs/mall/mall/ae/0e/ae0ee4a857df5e307e1d04b5d420cb5b.png", + "label_name": "小程序", + "name": "主站测试专用小程序", + "title": "主站测试专用小程序" +} +``` + +### 通知消息（`msg_type=10`） 此类型消息仅可接收，不可直接发送 @@ -172,9 +202,9 @@ } ``` -## 视频推送消息（`msg_type=11`） +### 视频推送消息（`msg_type=11`） -此类型消息仅可接收，不可直接发送 +此类型消息仅可接收，不可直接发送；有小概率会出现即使视频存在，也只会出现 `rid`、`type` 和 `attach_msg` 三项的现象 根对象： @@ -210,9 +240,9 @@ } ``` -## 专栏推送消息（`msg_type=12`） +### 专栏推送消息（`msg_type=12`） -此类型消息仅可接收，不可直接发送 +此类型消息仅可接收，不可直接发送；有小概率会出现即使专栏存在，也只会出现 `rid`、`type` 和 `attach_msg` 三项的现象 根对象： @@ -251,7 +281,7 @@ ``` -## 图片卡片消息（`msg_type=13`） +### 图片卡片消息（`msg_type=13`） 此类型消息仅可接收，不可直接发送 @@ -273,7 +303,7 @@ } ``` -## 被关注时的自动推送消息（`msg_type=16`） +### 被关注时的自动推送消息（`msg_type=16`） **示例：** @@ -318,7 +348,7 @@ } ``` -## 系统提示消息（`msg_type=18`） +### 系统提示消息（`msg_type=18`） 此类型消息仅可接收，不可直接发送 @@ -351,3 +381,9 @@ "content": "[{\"text\":\"对方主动回复或关注你前，最多发送1条消息\",\"color_day\":\"#9499A0\",\"color_nig\":\"#9499A0\"}]" } ``` + +## 粉丝团消息类型 + +以下消息类型仅常见于粉丝团中的系统消息（`receiver_type` 为 `2` 且 `sender_uid` 为 `0`） + + diff --git a/docs/user/info.md b/docs/user/info.md index 50db526..e5ac8db 100644 --- a/docs/user/info.md +++ b/docs/user/info.md @@ -943,8 +943,8 @@ curl -G 'https://api.bilibili.com/x/space/myinfo' \ **url参数：** -| 参数名 | 类型 | 内容 | 必要性 | 备注 | -| ------ | ---- | ----------------- | ------ | --------------------------------- | +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| ------ | ---- | ----------------- | ------ | ------------------- | | uids | nums | 目标用户的UID列表 | 必要 | 每个成员间用`,`分隔 | **json回复：** @@ -954,8 +954,8 @@ curl -G 'https://api.bilibili.com/x/space/myinfo' \ | 字段 | 类型 | 内容 | 备注 | | ------- | ----- | -------- | --------------------------- | | code | num | 返回值 | 0：成功
-400：请求错误 | -| msg | str | 错误信息 | 默认为空 | -| message | str | 错误信息 | 默认为空 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | | data | array | 信息本体 | 用户信息随机排序 | `data`数组： @@ -972,7 +972,6 @@ curl -G 'https://api.bilibili.com/x/space/myinfo' \ | ------- | ---- | ------------ | -------------------- | | mid | num | mid | | | name | str | 昵称 | | -| sex | str | 性别 | 男/女/保密 | | face | str | 头像链接 | | | sign | str | 签名 | | | rank | num | 用户权限等级 | | @@ -995,34 +994,31 @@ curl -G 'https://api.vc.bilibili.com/account/v1/user/cards' \ ```json { "code": 0, - "msg": "", "message": "", + "ttl": 1, "data": [{ "mid": 1, "name": "bishi", - "sex": "男", - "face": "https://i1.hdslb.com/bfs/face/34c5b30a990c7ce4a809626d8153fa7895ec7b63.gif", + "face": "http://i1.hdslb.com/bfs/face/34c5b30a990c7ce4a809626d8153fa7895ec7b63.gif", "sign": "", "rank": 10000, - "level": 4, + "level": 6, "silence": 0 }, { "mid": 2, "name": "碧诗", - "sex": "男", - "face": "https://i2.hdslb.com/bfs/face/ef0457addb24141e15dfac6fbf45293ccf1e32ab.jpg", - "sign": "https://kami.im 直男过气网红 # av362830 “We Are Star Dust”", + "face": "http://i2.hdslb.com/bfs/face/ef0457addb24141e15dfac6fbf45293ccf1e32ab.jpg", + "sign": "https://kami.im 直男过气网红 # We Are Star Dust", "rank": 20000, "level": 6, "silence": 0 }, { "mid": 3, "name": "囧囧倉", - "sex": "男", - "face": "https://i0.hdslb.com/bfs/face/d4de6a84557eea8f18510a3f61115d96832aa071.jpg", + "face": "http://i0.hdslb.com/bfs/face/d4de6a84557eea8f18510a3f61115d96832aa071.jpg", "sign": "富强、民主、文明、和谐、自由、平等、公正、法治、爱国、敬业、诚信、友善。", "rank": 10000, - "level": 5, + "level": 6, "silence": 0 }] }