diff --git a/docs/develop/api-v2/dev-prepare/error-trace/openapi.md b/docs/develop/api-v2/dev-prepare/error-trace/openapi.md index 162f0108..f6c7786b 100644 --- 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 index d3d23e81..1d2b1d87 100644 --- 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 index b37f49e5..c5a529eb 100644 --- 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时返回 |