From 608479ae8d2dd23133907b55ce122ab5a185551f Mon Sep 17 00:00:00 2001
From: SocialSisterYi <45892418+SocialSisterYi@users.noreply.github.com>
Date: Mon, 27 Jul 2020 23:49:37 +0800
Subject: [PATCH] =?UTF-8?q?=E4=BF=AE=E6=94=B9=E5=8F=91=E9=80=81=E7=A7=81?=
=?UTF-8?q?=E4=BF=A1?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
message/private_msg.md | 110 +++++++++++++++++++++--------------------
1 file changed, 56 insertions(+), 54 deletions(-)
diff --git a/message/private_msg.md b/message/private_msg.md
index d13238e..efecb3b 100644
--- a/message/private_msg.md
+++ b/message/private_msg.md
@@ -18,16 +18,16 @@
| ------- | ---- | -------- | --------------------------- |
| code | num | 返回值 | 0：成功
-6：账号未登录 |
| message | str | 错误信息 | 默认为ok |
-| ttl | num | 1 | 作用尚不明确 |
+| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data` 对象：
-| 字段 | 类型 | 内容 | 备注 |
-| --------------- | ---- | -------------------- | ------------ |
-| unfollow_unread | num | 未关注用户未读私信数 | |
-| follow_unread | num | 已关注用户未读私信数 | |
-| _gt_ | num | 0 | 作用尚不明确 |
+| 字段 | 类型 | 内容 | 备注 |
+| --------------- | ---- | -------------------- | ---- |
+| unfollow_unread | num | 未关注用户未读私信数 | |
+| follow_unread | num | 已关注用户未读私信数 | |
+| _gt_ | num | 0 | |
**示例：**
@@ -51,9 +51,7 @@ curl 'http://api.vc.bilibili.com/session_svr/v1/session_svr/single_unread'\
}
```
-
-
-## 发送私信
+## 发送私信（web端）
> http://api.vc.bilibili.com/web_im/v1/web_im/send_msg
@@ -61,42 +59,48 @@ curl 'http://api.vc.bilibili.com/session_svr/v1/session_svr/single_unread'\
认证方式：Cookie（SESSDATA）
-**正文参数（application/x-www-form-urlencoded）**
+**正文参数（application/x-www-form-urlencoded）：**
-| 参数名 | 类型 | 内容 | 必要性 | 备注 |
-| ------------------ | ---------- | --------- | ------ | -------------------------------------- |
-| msg[sender_uid] | num | 发送者uid | 必要 | |
-| msg[receiver_id] | num | 接收者uid | 必要 | |
-| msg[receiver_type] | num | 1 | 必要 | |
-| msg[msg_type] | num | | 必要 | 1:发送文字
2:发送图片
5:撤回消息 |
-| msg[msg_status] | num | 0 | 非必要 | |
-| msg[content] | obj \| num | 私信内容 | 必要 | 撤回消息时为num |
-| csrf_token | str | | 必要 | 登录后的bili_jct |
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------------------ | ------------------------------------ | ------------------------ | ------ | -------------------------------------- |
+| msg[sender_uid] | num | 发送者UID | 必要 | |
+| msg[receiver_id] | num | 接收者UID | 必要 | |
+| msg[receiver_type] | num | 1 | 必要 | 固定为1 |
+| msg[msg_type] | num | 消息类型 | 必要 | 1:发送文字
2:发送图片
5:撤回消息 |
+| msg[msg_status] | num | 0 | 非必要 | |
+| msg[content] | 发送文字时：str
撤回消息时：num | 消息内容 | 必要 | **详见下表** |
+| csrf_token | str | CSRF Token（位于cookie） | 必要 | |
-`msg[content]`对象（发送文字）：
+`msg[content]`消息内容：
+
+当发送文字时（`msg[msg_type]=1`）：
+
+该参数为json序列字串
+
+根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ---- |
| content | str | 私信内容 | |
+当发送图片时（`msg[msg_type]=2`）：
+该参数为json序列字串
-`msg[content]`对象（发送图片）：
+根对象：
-| 字段 | 类型 | 内容 | 必要性 | 备注 |
-| -------- | ---- | ---------- | ------ | :--------------------------- |
-| url | str | 图片的url | 必要 | 可以先上传第三方图床 |
-| width | num | 图片的宽 | 非必要 | 单位：像素 |
-| height | num | 图片的高 | 非必要 | 单位：像素 |
-| type | str | 图片的类型 | 非必要 | 例如：jpeg |
-| original | num | 1 | 非必要 | **作用未知** |
-| size | num | 文件大小 | 非必要 | 单位：千字节
__向上取整__ |
-
-
-
-
+| 字段 | 类型 | 内容 | 备注 |
+| -------- | ---- | -------- | :-------------------------------------------- |
+| url | str | 图片url | 默认为B站相簿图片上传通道
也可用三方图床 |
+| width | num | 图片的宽 | 单位：像素（非必要） |
+| height | num | 图片的高 | 单位：像素（非必要） |
+| type | str | 图片格式 | （非必要） |
+| original | num | 1 | **作用未知**（非必要） |
+| size | num | 文件大小 | 单位：千字节（非必要）
__向上取整__ |
+当撤回消息时（`msg[msg_type]=5`）：
+该参数为数值，为目标消息的` msg_key `
**json回复：**
@@ -117,22 +121,21 @@ curl 'http://api.vc.bilibili.com/session_svr/v1/session_svr/single_unread'\
**示例：**
-给B站用户`-1`发一条文字私信：
+给目标用户`UID=1`发一条文字私信：
> up主你好，
>
-> 催更
+> 催更[doge]
```shell
-正文参数：
- msg[sender_uid] = 你的uid
- msg[receiver_id] = -1
- msg[receiver_type] = 1
- msg[msg_type] = 1
- msg[content] = {"content": "up主你好，\n催更[doge]"}
- csrf_token = 登录后的bili_jct
-cookies:
- SESSDATA = 登录后的SESSDATA
+curl 'http://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[content]={"content":"up主你好，\n催更[doge]"}'\
+--data-urlencode 'csrf_token=xxx'\
+-b 'SESSDATA=xxx'
```
```json
@@ -147,20 +150,19 @@ cookies:
}
```
-给B站用户`-1`发一条图片私信：
+给目标用户`UID=1`发一条图片私信：
> 
```shell
-正文参数：
- msg[sender_uid] = 你的uid
- msg[receiver_id] = -1
- msg[receiver_type] = 1
- msg[msg_type] = 2
- msg[content] = {"url": "https://i1.hdslb.com/bfs/face/aebb2639a0d47f2ce1fec0631f412eaf53d4a0be.jpg"}
- csrf_token = 登录后的bili_jct
-cookies:
- SESSDATA = 登录后的SESSDATA
+curl 'http://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[content]={"url":https://i1.hdslb.com/bfs/face/aebb2639a0d47f2ce1fec0631f412eaf53d4a0be.jpg}'\
+--data-urlencode 'csrf_token=xxx'\
+-b 'SESSDATA=xxx'
```
```json