跳转到正文

删除会话中的消息 ​

删除指定会话中的消息记录。

请求信息

请求 URI

DELETE https://lg.jimitu.top/api/open/sessions/{session_id}/messages

请求头参数

请求头必填说明
Authorization是Bearer {API Key},接口鉴权,所有请求均需携带
Content-Type否仅 POST/PUT 携带 JSON 请求体时需要,值为 application/json

请求路径参数

参数类型必填说明
session_idinteger是会话 ID

请求查询参数

参数类型必填说明
user_idstring是外部用户 ID,必须是会话所属用户

请求示例

curl -X DELETE "https://lg.jimitu.top/api/open/sessions/{session_id}/messages?user_id=<user_id>" \
  -H "Authorization: Bearer <your_api_key>"

响应信息

响应体示例

{
  "success": true,
  "data": {
    "deleted_session_id": 1001,
    "deleted_count": 42
  }
}

响应参数

字段类型说明
deleted_session_idinteger所属会话 ID
deleted_countinteger已删除消息条数

错误码

错误码

error_code状态码说明
SESSION_NOT_FOUND404会话不存在或无权访问
INVALID_QUERY_PARAMETER400请求参数错误

文档中心 · docs.jimitu.top