Skip to main content

结束并删除会话

千问办公企业旗舰版开发者文档:结束并删除会话。

认证方式见APP开发者文档 → 认证接入。
  • 模块:会话服务(session)
  • 接口:DELETE/api/openapi/app/v1/sessions/{session_id}

请求参数

参数位置类型必填说明
session_idpathstring是创建会话接口返回的会话 ID。

响应

HTTP说明
200请求成功
default错误响应。按 code 判断具体错误,不能仅依赖 HTTP 状态码,多种错误可能共用状态码。
媒体类型:application/json。

响应200 DeleteSessionResponse

字段类型必填约束契约说明
end_reasonstring是调用方删除时固定为 completed调用方主动删除时固定为 completed;平台结束会话时可能出现其他原因。
session_idstring是—已结束的会话 ID。
statusstring是固定为 terminated固定为 terminated。会话已永久结束,不可撤销或复用原 ID 恢复。

使用说明

创建会话绑定当前IAM用户;资源读取与变更按用户归属校验。写入发生超时或响应丢失时,不应假定服务端未接纳并盲目重复请求。