千问办公企业旗舰版开发者文档:结束并删除会话。
认证方式见APP开发者文档 → 认证接入。
媒体类型:
创建会话绑定当前IAM用户;资源读取与变更按用户归属校验。写入发生超时或响应丢失时,不应假定服务端未接纳并盲目重复请求。
- 模块:会话服务(session)
- 接口:DELETE
/api/openapi/app/v1/sessions/{session_id}
请求参数
| 参数 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| session_id | path | string | 是 | 创建会话接口返回的会话 ID。 |
响应
| HTTP | 说明 |
|---|---|
| 200 | 请求成功 |
| default | 错误响应。按 code 判断具体错误,不能仅依赖 HTTP 状态码,多种错误可能共用状态码。 |
application/json。
响应200 DeleteSessionResponse
| 字段 | 类型 | 必填 | 约束 | 契约说明 |
|---|---|---|---|---|
| end_reason | string | 是 | 调用方删除时固定为 completed | 调用方主动删除时固定为 completed;平台结束会话时可能出现其他原因。 |
| session_id | string | 是 | — | 已结束的会话 ID。 |
| status | string | 是 | 固定为 terminated | 固定为 terminated。会话已永久结束,不可撤销或复用原 ID 恢复。 |