删除会话及其全部消息
返回已删除会话 ID 与消息条数。
请求信息
请求 URI
DELETE https://lg.jimitu.top/api/open/sessions/{session_id}请求头参数
| Header | 必填 | 说明 |
|---|---|---|
Authorization | 是 | Bearer {API Key}，接口鉴权，所有请求均需携带 |
Content-Type | 否 | 仅 POST/PUT 携带 JSON 请求体时需要，值为 application/json |
请求路径参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| session_id | integer | 是 | 会话 ID |
请求查询参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| user_id | string | 是 | 外部用户 ID，必须是会话所属用户 |
请求示例
curl -X DELETE "https://lg.jimitu.top/api/open/sessions/{session_id}?user_id=<user_id>" \
-H "Authorization: Bearer <your_api_key>"响应信息
响应体示例
{
"success": true,
"data": {
"deleted_session_id": 1001,
"deleted_count": 42
}
}响应参数
| 字段 | 类型 | 说明 |
|---|---|---|
| deleted_session_id | integer | 已删除会话 ID |
| deleted_count | integer | 已删除消息条数 |
错误码
错误码
| error_code | HTTP | 说明 |
|---|---|---|
SESSION_NOT_FOUND | 404 | 会话不存在或无权访问 |
INVALID_QUERY_PARAMETER | 400 | 查询参数格式错误 |
注意
服务端同时校验 API Key 授权的角色模板和会话所属 user_id；无权删除其他令牌或其他外部用户的会话。