跳转到内容
Local API环境管理

删除环境(移入回收站) ​

版本概览
DELETE
/api/v1/browsers/{envId}

将当前用户、当前团队下的指定环境移入回收站。运行中的环境返回 40920。请求体可省略;delete_cache 默认 false,为 true 时会先删除本机环境缓存再移入回收站。恢复或彻底删除请使用环境回收站接口,或调用 /browsers/{envId}/permanent。

请求参数

Authorization Bearer Token

在请求头 Authorization 中使用 Bearer Token 传入 API Key。

Authorization: Bearer <api-key>

Path 参数

1
字段说明
string必填
浏览器环境唯一标识
示例值"env_01JABCDEF1234567890"
minLength: 1

Body 参数

application/jsonBrowserDeleteRequest
字段说明
boolean
是否同时删除本机环境缓存;默认 false,与客户端删除开关默认关闭一致
默认值false
示例

根据数据模型生成,非实际请求结果。

{
  "delete_cache": false
}

请求示例代码

JavaScript / TypeScript 使用 Node.js 18+ 内置 fetch;PHP 需启用 cURL 扩展;Go 需 1.16+;Java 需 JDK 11+。运行前请替换 Token 和示例参数值。

curl -X DELETE -H 'Authorization: Bearer <TOKEN>' -H 'Content-Type: application/json' -d '{
  "delete_cache": false
}' 'http://local.zhongyibrowser.com:39025/api/v1/browsers/env_01JABCDEF1234567890'

返回响应

成功时 code = 0,失败时 code > 0。选择状态码查看对应字段和示例,展开对象可查看嵌套字段;可选字段可能不返回。

环境已移入回收站

Body

application/jsonBrowserDeleteSuccessResponse
字段说明
number必填
业务状态码;成功固定为 0
枚举值
string必填
业务状态信息;成功固定为 success
枚举值
object必填
接口业务数据

不允许额外字段。

示例

根据数据模型生成,非实际请求结果。

{
  "code": 0,
  "message": "success",
  "data": {
    "env_id": "env_01JABCDEF1234567890",
    "status": "recycled",
    "delete_cache": true
  }
}

查看全部业务错误码与 HTTP 状态码

中屹浏览器 Local API 文档