业务错误码与 HTTP 错误码
成功响应的 code = 0，失败响应的 code > 0。HTTP 状态码与业务 code 是两个不同的值。同一个业务码可能对应多种错误，请结合接口、message 和当前状态判断。
业务错误码总表
| code | 错误信息与含义 |
|---|---|
| 40003 | 缺少 Host 请求头 |
| 40004 | Host 域名不在允许列表中 |
| 40005 | Host 端口不被允许 |
| 40006 | Origin 格式不合法 |
| 40007 | Origin 域名不在允许列表中 |
| 40008 | Origin 端口不被允许 |
| 40010 | 环境路径参数不合法 |
| 40011 | 启动环境参数不合法或缺少 env_id |
| 40012 | 关闭环境参数不合法或缺少 env_id |
| 40013 | 环境列表查询参数不合法 |
| 40014 | 批量启动环境参数不合法 |
| 40015 | 批量关闭环境参数不合法 |
| 40016 | 重启环境参数不合法或缺少 env_id |
| 40017 | 关闭所有环境的参数不合法 |
| 40018 | 批量重启环境参数不合法 |
| 40019 | 创建环境参数不合法 |
| 40020 | 更新环境或查询分组列表的参数不合法 |
| 40021 | 分组路径参数不合法 |
| 40022 | 创建分组参数不合法 |
| 40023 | 更新分组参数不合法 |
| 40024 | 移动环境到分组的参数不合法 |
| 40025 | 删除或批量删除环境的参数不合法 |
| 40026 | 彻底删除环境的参数不合法 |
| 40030 | 代理列表查询参数不合法 |
| 40031 | 代理路径参数不合法 |
| 40032 | 创建代理参数不合法 |
| 40033 | 代理主机或 IP 协议不合法 |
| 40034 | 更新代理参数不合法 |
| 40035 | 检测代理参数不合法 |
| 40036 | 代理绑定环境的参数不合法 |
| 40040 | 扩展列表查询参数不合法 |
| 40041 | 扩展路径参数不合法 |
| 40042 | 扩展绑定环境的参数不合法 |
| 40050 | 回收站列表查询参数不合法 |
| 40051 | 恢复回收站环境的参数不合法 |
| 40052 | 删除回收站环境的参数不合法 |
| 40060 | 内核查询或路径参数不合法 |
| 40061 | 指纹选项或字体列表查询参数不合法 |
| 40062 | 随机 WebGL 查询参数不合法 |
| 40063 | 随机字体查询参数不合法 |
| 40070 | 账号列表查询参数不合法 |
| 40071 | 账号路径参数不合法 |
| 40072 | 创建账号参数不合法 |
| 40073 | 更新账号参数不合法，包括切换账号类型时缺少 platform_id |
| 40074 | 账号平台列表查询参数不合法 |
| 40075 | 创建账号平台的参数不合法 |
| 40101 | 缺少 API Key，或 Authorization 未使用 Bearer 格式 |
| 40102 | Bearer 后的 API Key 为空 |
| 40103 | API Key 不正确 |
| 40104 | 后端登录会话不可用或已失效 |
| 40105 | 后端拒绝访问，当前账号没有相应权限 |
| 40301 | 当前操作没有权限 |
| 40400 | 请求的 API 路径或方法不存在 |
| 40401 | 环境不存在或当前用户、团队不可访问 |
| 40402 | 分组不存在 |
| 40403 | 代理不存在 |
| 40404 | 扩展不存在 |
| 40405 | 回收站中未找到指定环境 |
| 40406 | 未找到指定内核选项 |
| 40407 | 未找到指定操作系统选项 |
| 40408 | 账号不存在 |
| 40409 | 账号平台不存在 |
| 40901 | 环境超出套餐使用范围 |
| 40902 | 浏览器内核不支持当前系统平台 |
| 40903 | 环境未运行，无法执行重启等操作 |
| 40904 | 操作受限：环境使用 pipe 调试传输时需先关闭并通过 Local API 启动才能获取外部 WebSocket 地址，默认分组则不允许删除 |
| 40905 | 默认分组不允许修改 |
| 40907 | 分组中仍包含环境，无法删除 |
| 40911 | 分组已存在 |
| 40912 | 不允许修改代理模式 |
| 40913 | 托管代理不允许编辑 |
| 40914 | 托管代理不允许删除 |
| 40915 | 恢复环境将超过套餐环境数限制 |
| 40916 | 回收站环境仍在运行，无法清理 |
| 40917 | 自定义账号平台已存在 |
| 40918 | 创建环境将超过套餐环境数限制 |
| 40919 | 同一环境每个平台只能绑定一个账号 |
| 40920 | 环境仍在运行，无法删除或清理缓存 |
| 42201 | 无法从代理提取地址获得有效 IP 和端口 |
| 42202 | 浏览器内核、操作系统与 User-Agent 组合不兼容 |
| 42203 | 代理配置不可用 |
| 42204 | 账号配置不可用 |
| 50001 | Local API 内部错误或运行状态不可用 |
| 50002 | 运行中环境的外部调试地址不可用 |
| 50003 | 启动或重启环境失败 |
| 50004 | 运行中环境的分组信息不可用 |
| 50005 | 环境未能停止 |
| 50201 | 获取环境列表或详情失败、返回数据不合法，或超过处理上限 |
| 50202 | 获取支持的浏览器内核失败 |
| 50203 | 环境启动准备失败、后端拒绝启动或返回数据不合法 |
| 50204 | 在浏览器中打开 URL 失败 |
| 50205 | 创建环境失败或创建结果不合法 |
| 50206 | 更新环境失败或更新结果不合法 |
| 50207 | 删除环境或将环境移入回收站失败 |
| 50208 | 彻底删除环境失败 |
| 50209 | 获取环境完整配置失败或返回数据不合法 |
| 50210 | 分组操作或相关环境查询失败、返回数据不合法，或分组列表超过处理上限 |
| 50211 | 创建分组失败或无法读取创建结果 |
| 50212 | 更新分组失败 |
| 50213 | 删除分组失败 |
| 50214 | 移动环境到分组失败 |
| 50215 | 默认分组不可用 |
| 50220 | 获取代理失败、返回数据不合法，或代理列表超过处理上限 |
| 50221 | 创建代理失败 |
| 50222 | 更新代理失败 |
| 50223 | 删除代理失败 |
| 50224 | 检测代理、刷新代理地址或更新代理检测状态失败 |
| 50225 | 更新代理绑定的环境失败 |
| 50230 | 获取扩展失败、返回数据不合法，或扩展列表超过处理上限 |
| 50231 | 更新扩展绑定的环境失败或无法读取更新结果 |
| 50240 | 获取回收站失败、返回数据不合法，或列表超过处理上限 |
| 50241 | 恢复回收站环境失败 |
| 50242 | 彻底删除回收站环境失败 |
| 50243 | 清空回收站或获取待清空环境列表失败 |
| 50250 | 获取指纹选项失败或返回的内核、系统、User-Agent 选项不合法 |
| 50251 | 获取随机 WebGL 失败或返回数据不合法 |
| 50252 | 获取字体列表失败或返回数据不合法 |
| 50253 | 获取随机字体失败或返回数据不合法 |
| 50260 | 获取账号失败或返回数据不合法 |
| 50261 | 创建账号失败 |
| 50262 | 更新账号失败 |
| 50263 | 删除账号失败 |
| 50264 | 读取账号详情或创建、更新后的账号详情失败 |
| 50265 | 获取账号平台失败或返回数据不合法 |
| 50266 | 创建账号平台失败或返回数据不合法 |
| 50301 | 主客户端窗口不可用 |
| 50302 | 本机浏览器设置不可用或不合法 |
| 50303 | 本机尚未安装所需浏览器内核 |
| 50304 | 本机尚未安装所需浏览器扩展 |
| 50305 | 环境缓存正在清理或内部本地服务不可用，当前操作暂不可用 |
| 50306 | 删除环境缓存失败 |
| 50307 | 当前系统平台不支持此指纹选项或环境配置操作 |
错误响应结构
| 字段 | 类型 | 说明 |
|---|---|---|
| code | integer | 大于 0 的业务错误码。 |
| message | string | 具体错误信息。 |
| data | object | null | 附加错误详情；没有附加信息时为 null。 |
| request_id | string | 请求追踪 ID，与响应头 X-Request-Id 一致。 |
data 中可能携带：env_id（string）、env_ids（string[]）、status（string）、issues（object[]）。每个校验问题包含 code（string）、path（string[]）、message（string）。具体返回字段取决于实际错误。
批量请求中，外层可能返回 HTTP 200、code = 0，而部分项失败。请检查各项的 success 和 error。单项错误位于 data.items[].error，如有附加详情则位于该错误对象内。运行时错误也可能直接透传。
HTTP 状态码
| HTTP | 说明 |
|---|---|
| 400 | 请求格式或参数错误 |
| 401 | 缺少 API Key 或 API Key 无效 |
| 403 | 权限或安全策略禁止访问 |
| 404 | 资源或路由不存在 |
| 409 | 操作与当前状态冲突 |
| 422 | 请求校验失败 |
| 500 | 服务内部错误 |
| 502 | 上游服务错误 |
| 503 | 服务暂不可用 |