feature: 添加群/c2c的openapi

tencent-connect · Mar 18, 2024 · e603b92 · e603b92
1 parent 73aa8ee
commit e603b92
Show file tree

Hide file tree

Showing 3 changed files with 75 additions and 0 deletions.
diff --git a/docs/develop/api-v2/dev-prepare/error-trace/openapi.md b/docs/develop/api-v2/dev-prepare/error-trace/openapi.md
@@ -171,6 +171,11 @@
 | 306004          | no permission to delete message 没有撤回此消息的权限                                                            |
 | 306005          | retract message error 消息撤回失败(可重试)                                                                     |
 | 306006          | fail to get channel 获取子频道失败(可重试)                                                                      |
+| 306007          | 非当前群的消息                                                                                              |
+| 306008          | 非当前机器人发送的消息                                                                                              |
+| 306009          | 非与当前用户发送的消息                                                                                              |
+| 306010          | 内部错误                                                                                              |
+| 306011          | 超出可撤回消息时间                                                                                              |
 | 501000~501999   | 公告错误                                                                                                  |
 | 501001          | 参数校验失败                                                                                                |
 | 501002          | 创建子频道公告失败(可重试)                                                                                        |

diff --git a/docs/develop/api-v2/server-inter/message/send-receive/reset.md b/docs/develop/api-v2/server-inter/message/send-receive/reset.md
@@ -8,6 +8,74 @@
 
 [暂不对外开放]，管理员身份可撤回的加多消息 -->
 
+## 单聊
+
+### 接口
+
+```http
+DELETE /v2/users/{openid}/messages/{message_id}
+```
+
+### 功能描述
+
+用于撤回机器人发送给当前用户 `openid` 的消息 `message_id`，发送超出2分钟的消息不可撤回
+
+### Content-Type
+
+```http
+application/json
+```
+
+### 返回
+
+成功返回 HTTP 状态码 `200`。
+
+### 错误码
+
+详见[错误码](../../../dev-prepare/error-trace/openapi.md)。
+
+### 示例
+
+请求数据包
+
+```http
+DELETE /v2/users/123456/messages/112233
+```
+
+## 群聊
+
+### 接口
+
+```http
+DELETE /v2/groups/{group_openid}/messages/{message_id}
+```
+
+### 功能描述
+
+用于撤回机器人发送在当前群 `group_openid` 的消息 `message_id`，发送超出2分钟的消息不可撤回
+
+### Content-Type
+
+```http
+application/json
+```
+
+### 返回
+
+成功返回 HTTP 状态码 `200`。
+
+### 错误码
+
+详见[错误码](../../../dev-prepare/error-trace/openapi.md)。
+
+### 示例
+
+请求数据包
+
+```http
+DELETE /v2/groups/123456/messages/112233
+```
+
 ## 文字子频道
 
 ### 接口

diff --git a/docs/develop/api-v2/server-inter/message/send-receive/rich-media.md b/docs/develop/api-v2/server-inter/message/send-receive/rich-media.md
@@ -54,6 +54,7 @@
 | file_uuid | string | 文件 ID |
 | file_info | string | 文件信息，用于发消息接口的 media 字段使用 |
 | ttl | int | 有效期，表示剩余多少秒到期，到期后 file_info 失效，当等于 0 时，表示可长期使用 |
+| id | string | 发送消息的唯一ID，当srv_send_msg设置为true时返回 |
 
 - **错误码**
 
@@ -103,6 +104,7 @@
 | file_uuid | string | 文件 ID |
 | file_info | string | 文件信息，用于发消息接口的 media 字段使用 |
 | ttl | int | 有效期，表示剩余多少秒到期，到期后 file_info 失效，当等于 0 时，表示可长期使用 |
+| id | string | 发送消息的唯一ID，当srv_send_msg设置为true时返回 |
 
 <!-- - **错误码** -->