# 下载浏览器内核

下载并安装浏览器内核。支持批量下载，每次请求最多 20 个内核。此操作的超时时间最长约 30 分钟，建议调用方超时设置大于 1805 秒。
需要 MoreLogin 客户端版本 **2.61.1** 或更高。
### 重复请求处理
- 同一请求中出现多个相同浏览器类型和主版本的任务，只查询一次、只执行一次实际下载，但每个输入项都会返回结果。
- 多个并发请求下载相同版本会加入正在进行的任务，不重复下载。
- 如果已安装的完整版本与最新版本一致，状态返回
`already_installed`
。
- 如果已安装的是旧的小版本，将下载并更新到当前最新小版本。

### 错误码参考
| errorCode | 说明 |
|  --- | --- |
| `INVALID_JSON` | JSON 格式错误 |
| `INVALID_REQUEST` | 请求结构错误 |
| `BATCH_LIMIT_EXCEEDED` | `Cores` 超过 20 条 |
| `UNSUPPORTED_BROWSER_TYPE` | 不支持的浏览器类型 |
| `INVALID_VERSION` | 版本格式错误 |
| `METADATA_LOOKUP_FAILED` | 查询内核信息失败 |
| `UNSUPPORTED_VERSION` | 内核版本不存在或当前平台不支持 |
| `CLIENT_NOT_READY` | 客户端未准备完成 |
| `SDK_NOT_READY` | SDK 未初始化 |
| `INSUFFICIENT_DISK_SPACE` | 磁盘空间不足 |
| `DOWNLOAD_FAILED` | 下载失败 |
| `CHECKSUM_MISMATCH` | MD5 校验失败 |
| `EXTRACTION_FAILED` | 解压或安装失败 |
| `TIMEOUT` | 执行超时 |
| `UNKNOWN` | 未知异常 |

Endpoint: POST /api/env/core/download
Version: 2026-09-05

## Description:

  - `重复请求处理` ()
    - 同一请求中出现多个相同浏览器类型和主版本的任务，只查询一次、只执行一次实际下载，但每个输入项都会返回结果。
- 多个并发请求下载相同版本会加入正在进行的任务，不重复下载。
- 如果已安装的完整版本与最新版本一致，状态返回
`already_installed`
。
- 如果已安装的是旧的小版本，将下载并更新到当前最新小版本。

  - `错误码参考` ()
    | errorCode | 说明 |
|  --- | --- |
| `INVALID_JSON` | JSON 格式错误 |
| `INVALID_REQUEST` | 请求结构错误 |
| `BATCH_LIMIT_EXCEEDED` | `Cores` 超过 20 条 |
| `UNSUPPORTED_BROWSER_TYPE` | 不支持的浏览器类型 |
| `INVALID_VERSION` | 版本格式错误 |
| `METADATA_LOOKUP_FAILED` | 查询内核信息失败 |
| `UNSUPPORTED_VERSION` | 内核版本不存在或当前平台不支持 |
| `CLIENT_NOT_READY` | 客户端未准备完成 |
| `SDK_NOT_READY` | SDK 未初始化 |
| `INSUFFICIENT_DISK_SPACE` | 磁盘空间不足 |
| `DOWNLOAD_FAILED` | 下载失败 |
| `CHECKSUM_MISMATCH` | MD5 校验失败 |
| `EXTRACTION_FAILED` | 解压或安装失败 |
| `TIMEOUT` | 执行超时 |
| `UNKNOWN` | 未知异常 |

## Request fields (application/json):

  - `Cores` (array, required)
    待下载的内核列表（1–20 项）

  - `Cores.BrowserType` (integer, required)
    浏览器类型。`1`：Chrome，`2`：Firefox

  - `Cores.Version` (string, required)
    内核主版本号，例如 `"124"`、`"146"`

## Response 200:

  - `200` (unknown)
    成功。`data` 是对象，包含字段 `total`、`succeeded`、`failed`、`results`。

## Response 200 fields (application/json):

  - `code` (integer, required)
    响应代码。`0`：全部成功；`-1`：部分成功；`-2`：全部失败

  - `msg` (string | null)
    请求级错误消息；正常执行通常为 `null`

  - `data` (object, required)

  - `data.total` (integer, required)
    请求任务总数

  - `data.succeeded` (integer, required)
    成功数量（包括已安装）

  - `data.failed` (integer, required)
    失败数量

  - `data.results` (array, required)
    每个输入项对应的执行结果，顺序与请求一致

  - `data.results.index` (integer)
    对应 `Cores` 中的下标（从 0 开始）

  - `data.results.browserType` (integer | null)
    浏览器类型

  - `data.results.requestedVersion` (string | null)
    请求的主版本

  - `data.results.resolvedVersion` (string)
    实际解析到的完整版本，成功或已解析元数据时返回

  - `data.results.status` (string)
    任务状态：`installed`、`already_installed` 或 `failed`

  - `data.results.source` (string)
    下载来源：`downloaded`、`already_installed` 或 `joined_in_flight`

  - `data.results.errorCode` (string)
    任务失败时返回的稳定错误分类码

  - `data.results.serverCode` (integer)
    可选。平台服务返回的原始业务错误码

  - `data.results.msg` (string)
    展示消息，可能随客户端语言变化。不要用于程序化结果判断

  - `requestId` (string)
    请求唯一标识；联系支持时请提供

