Update (#137)

e

Author: yyyytawa

src/api/v1/msg.md

@@ -117,6 +117,75 @@ message send_message {
 
 :::
 
+## 编辑消息
+
+POST /v1/msg/edit-message
+
+::: warning
+云湖会限制一些编辑,例如说你不能把文本消息编辑为语音消息等.  
+:::
+
+请求头:  
+
+|名称|必须|备注|
+|-----|-----|-----|
+|token|是|消息发送者的Token|
+
+请求体:  
+
+```ProtoBuf
+msg_id: "123456" // 要编辑的消息ID
+chat_id: "big" // 消息所属聊天对象的ID
+chat_type: 2 // 消息所属聊天对象的类型,1-用户 2-群组 3-机器人
+content {
+  text: "123" // 文本
+  // 剩下的建议看proto文件
+}
+content_type: 1 // 要编辑为的消息类型,1-文本 3-markdown 8-html
+quote_msg_id: "11451419180" // 引用的消息ID
+```
+
+::: details ProtoBuf数据结构
+
+```proto
+// 编辑消息
+message edit_message_send {
+    string msg_id = 2;
+    string chat_id = 3;
+    int32 chat_type = 4;
+    Content content = 5;
+    message Content {
+        string text = 1; // 文本
+        string buttons = 2; // 按钮
+        string quote_msg_text = 8; // 引用消息文字
+    }
+    uint64 content_type = 6; // 信息类别，1-文本，3-markdown，8-html
+    string quote_msg_id = 8; // 引用信息ID
+}
+```
+
+:::
+
+响应体:  
+
+```ProtoBuf
+status {
+  number: 114514
+  code: 1
+  msg: "success"
+}
+```
+
+::: details ProtoBuf数据结构
+
+```proto
+message edit_message {
+    Status status = 1;
+}
+```
+
+:::
+
 ## 通过消息序列列出消息
 
 POST /v1/msg/list-message-by-seq  

src/api/wss/chat-ws-go.jwzhd.com.md

@@ -80,7 +80,7 @@ message heartbeat_ack_info {
 
 ```ProtoBuf
 info {
-  seq: "1234567abcd" // 请求表示码
+  seq: "1234567abcd" // 请求标识码
   cmd: "push_message" // 推送消息
 }
 
@@ -213,7 +213,7 @@ message push_message {
 
 ```ProtoBuf
 info {
-  seq: "1234567abcd" // 请求表示码
+  seq: "1234567abcd" // 请求标识码
   cmd: "file_send_message" // 推送超级文件分享
 }
 
@@ -224,7 +224,7 @@ data {
       user_id: "123" // 接收者用户ID
       temp_code: 1 // 未知
       send_type: "candidate" // 分享类别区分文本
-      data: "{}" // 经过转意后的json格式发送数据
+      data: "{}" // 经过转意义的json格式发送数据
       send_deviceId: "123123123123" // 发送者设备唯一标识符
     }
 }
@@ -253,11 +253,75 @@ message file_send_message {
       string user_id = 2; // 接收者用户ID
       uint64 temp_code = 3; // 未知
       string send_type = 4; // 分享类别区分文本
-      string data = 5; // 经过转意后的json格式发送数据
+      string data = 5; // 经过转义后的json格式发送数据
       string send_deviceId = 6; // 发送者设备唯一标识符
     }
   }
 }
 ```
 
 :::
+
+## 编辑消息接收
+
+返回数据:  
+
+```ProtoBuf
+info {
+  seq: "123123123123123123123" // 请求标识码
+  cmd: "edit_message" // 消息编辑推送
+}
+
+data {
+  cmd: "type.googleapis.com/proto.PushMessage" // 操作类型?
+  msg {
+    "msg_id": "123123123123" // 信息ID
+    "chat_id": "123" // 信息对象ID
+    "content": {
+      “text": "测试信息文本" // 信息文本
+      "buttons": "测试信息文本" // 按钮信息文本数据
+      "quote_msg_text": "测试引用信息文本" // 引用信息文本
+    }
+    "content_type": 1 // 信息类别，1-文本，3-markdown，8-html
+    "quote_msg_id": "123123123123" // 引用信息ID
+  }
+}
+```
+
+::: details ProtoBuf数据结构
+
+```proto
+message INFO {
+    string seq = 1; // 请求标识码
+    string cmd = 2; // 操作类型
+}
+
+message Msg {
+    string msg_id = 1;
+    string recv_id = 3; // 接收者ID,但是不知道为啥到编辑这里就和4一样了
+    string chat_id = 4; // 会话的ID
+    Content content = 6; // 消息内容
+    uint64 content_type = 7;
+    string quote_msg_id = 11; // 引用消息ID
+    uint64 edit_time = 14; // 编辑时间
+            
+    message Content {
+        string text = 1; // 消息内容
+        string buttons = 2; // 按钮
+        string quote_msg_text = 8; // 引用消息文字
+    }
+}
+
+// ws接收编辑消息
+message edit_message {
+    INFO info = 1;
+    Data data = 2;
+    
+    message Data {
+        string cmd = 1;
+        Msg msg = 2;
+    }
+}
+```
+
+:::