删除会话

DELETE 
/v1/sessions/:session_id

删除发起调用的终端用户的一个会话；此后它不再出现在列表或读取结果中。语音会话在通话仍连接时不能删除。如果清理会话的存储数据失败，什么都不会被删除（503）；请重试该请求。

请求

响应

204

成功响应

401

鉴权失败：凭证缺失、格式错误、已过期或已作废。

• invalid_token — 访问令牌无效。
• project_disabled — 此项目未启用。
• token_expired — 访问令牌已过期。
• user_disabled — 此用户未启用。

404

请求的资源不存在，或对调用方不可见。

• session_not_found — 找不到会话

409

请求与资源的当前状态冲突。

• call_in_progress — 有进行中的通话正在使用这个会话；请先结束通话再删除。

422

请求中的某个值未通过校验；details 数组会列出每个出错的字段。

• validation_failed — 请求内容未通过校验。

429

要么是请求太多（Retry-After 响应头会说明何时重试），要么是计费账户的积分已用完（不带 Retry-After——加上积分才能继续）；用 code 字段区分这两种情况。

• rate_limited — 请求太频繁，请放慢速度。

500

服务端发生了意外错误。

• internal — 发生了意外错误。

503

服务暂时不可用；请稍等片刻后重试。

• service_unavailable — 服务暂时不可用，请稍后重试。