Merge pull request SocialSisterYi#32 from thefatwhale/master

添加了 发送私信部分

message/private_msg.md

@@ -21,7 +21,7 @@
 | ttl     | num  | 1        | 作用尚不明确                |
 | data    | obj  | 信息本体 |                             |
 
-data 对象：
+`data` 对象：
 
 | 字段            | 类型 | 内容                 | 备注         |
 | --------------- | ---- | -------------------- | ------------ |
@@ -51,3 +51,127 @@ curl 'http://api.vc.bilibili.com/session_svr/v1/session_svr/single_unread'\
 }
 ```
 
+
+
+## 发送私信
+
+> http://api.vc.bilibili.com/web_im/v1/web_im/send_msg
+
+*请求方式：POST*
+
+认证方式：Cookie（SESSDATA）
+
+**正文参数（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:发送文字<br>2:发送图片<br>5:撤回消息 |
+| msg[msg_status]    | num        | 0         | 非必要 |                                        |
+| msg[content]       | obj \| num | 私信内容  | 必要   | 撤回消息时为num                        |
+| csrf_token         | str        |           | 必要   | 登录后的bili_jct                       |
+
+`msg[content]`对象（发送文字）：
+
+| 字段    | 类型 | 内容     | 备注 |
+| ------- | ---- | -------- | ---- |
+| content | str  | 私信内容 |      |
+
+
+
+`msg[content]`对象（发送图片）：
+
+| 字段     | 类型 | 内容       | 必要性 | 备注                         |
+| -------- | ---- | ---------- | ------ | :--------------------------- |
+| url      | str  | 图片的url  | 必要   | 可以先上传第三方图床         |
+| width    | num  | 图片的宽   | 非必要 | 单位：像素                   |
+| height   | num  | 图片的高   | 非必要 | 单位：像素                   |
+| type     | str  | 图片的类型 | 非必要 | 例如：jpeg                   |
+| original | num  | 1          | 非必要 | **作用未知**                 |
+| size     | num  | 文件大小   | 非必要 | 单位：千字节<br>__向上取整__ |
+
+
+
+<!--`msg[content]`撤回消息：msg_key-->
+
+
+
+**json回复：**
+
+根对象：
+| 字段    | 类型 | 内容     | 备注        |
+| ------- | ---- | -------- | ----------- |
+| code    | num  | 返回值   | 0：成功<br> |
+| message | str  | 错误信息 | 默认为ok    |
+| msg     | str  | 错误信息 | 默认为ok    |
+| data    | obj  | 主体     | 出错时为空  |
+
+`data`对象：
+
+| 字段    | 类型 | 内容 | 备注         |
+| ------- | ---- | ---- | ------------ |
+| msg_key | num  |      | 作用尚不明确 |
+| \_gt\_  | num  | 0    | 作用尚不明确 |
+
+**示例：**
+
+给B站用户`-1`发一条文字私信：
+
+> up主你好，
+>
+> 催更![doge](https://s1.ax1x.com/2020/07/23/ULJEfU.png)
+
+```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
+```
+
+```json
+{
+    "code":0,
+    "msg":"ok",
+    "message":"ok",
+    "data":{
+        "msg_key":6852559688104417870,
+	"_gt_":0
+    }
+}
+```
+
+给B站用户`-1`发一条图片私信：
+
+> <img src="https://i1.hdslb.com/bfs/face/aebb2639a0d47f2ce1fec0631f412eaf53d4a0be.jpg" style="zoom:50%;" >
+
+```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
+```
+
+```json
+{
+    "code":0,
+    "msg":"ok",
+    "message":"ok",
+    "data":{
+        "msg_key":6852570013146024354,
+        "_gt_":0
+    }
+}
+```
+