# Tải xuống nhân trình duyệt

Tải xuống và cài đặt nhân trình duyệt. Hỗ trợ tải xuống hàng loạt tối đa 20 nhân mỗi yêu cầu. Thời gian chờ cho thao tác này có thể lên đến khoảng 30 phút; bên gọi nên đặt thời gian chờ lớn hơn 1805 giây.
Yêu cầu phiên bản ứng dụng MoreLogin **2.61.1** trở lên.
### Xử lý yêu cầu trùng lặp
- Nếu cùng loại trình duyệt và phiên bản chính xuất hiện nhiều lần trong một yêu cầu, chỉ thực hiện một lần tra cứu và tải xuống, nhưng mỗi mục nhập đều có kết quả riêng.
- Các yêu cầu đồng thời cho cùng phiên bản sẽ tham gia vào tác vụ đang thực hiện thay vì bắt đầu tải xuống mới.
- Nếu phiên bản yêu cầu đã được cài đặt với phiên bản phụ mới nhất, trạng thái sẽ là
`already_installed`
.
- Nếu phiên bản phụ cũ hơn đã được cài đặt, nó sẽ được cập nhật lên phiên bản phụ mới nhất có sẵn.

### Tham chiếu mã lỗi
| errorCode | Mô tả |
|  --- | --- |
| `INVALID_JSON` | Nội dung JSON không đúng định dạng |
| `INVALID_REQUEST` | Cấu trúc yêu cầu không hợp lệ |
| `BATCH_LIMIT_EXCEEDED` | Mảng `Cores` vượt quá 20 mục |
| `UNSUPPORTED_BROWSER_TYPE` | Loại trình duyệt không được hỗ trợ |
| `INVALID_VERSION` | Định dạng phiên bản không hợp lệ |
| `METADATA_LOOKUP_FAILED` | Không thể truy vấn metadata nhân |
| `UNSUPPORTED_VERSION` | Phiên bản nhân không tồn tại hoặc không được hỗ trợ trên nền tảng này |
| `CLIENT_NOT_READY` | Ứng dụng khách chưa sẵn sàng |
| `SDK_NOT_READY` | SDK chưa khởi tạo |
| `INSUFFICIENT_DISK_SPACE` | Không đủ dung lượng đĩa |
| `DOWNLOAD_FAILED` | Tải xuống thất bại |
| `CHECKSUM_MISMATCH` | Xác minh checksum MD5 thất bại |
| `EXTRACTION_FAILED` | Giải nén hoặc cài đặt thất bại |
| `TIMEOUT` | Hết thời gian thao tác |
| `UNKNOWN` | Lỗi không xác định |

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

## Description:

  - `Xử lý yêu cầu trùng lặp` ()
    - Nếu cùng loại trình duyệt và phiên bản chính xuất hiện nhiều lần trong một yêu cầu, chỉ thực hiện một lần tra cứu và tải xuống, nhưng mỗi mục nhập đều có kết quả riêng.
- Các yêu cầu đồng thời cho cùng phiên bản sẽ tham gia vào tác vụ đang thực hiện thay vì bắt đầu tải xuống mới.
- Nếu phiên bản yêu cầu đã được cài đặt với phiên bản phụ mới nhất, trạng thái sẽ là
`already_installed`
.
- Nếu phiên bản phụ cũ hơn đã được cài đặt, nó sẽ được cập nhật lên phiên bản phụ mới nhất có sẵn.

  - `Tham chiếu mã lỗi` ()
    | errorCode | Mô tả |
|  --- | --- |
| `INVALID_JSON` | Nội dung JSON không đúng định dạng |
| `INVALID_REQUEST` | Cấu trúc yêu cầu không hợp lệ |
| `BATCH_LIMIT_EXCEEDED` | Mảng `Cores` vượt quá 20 mục |
| `UNSUPPORTED_BROWSER_TYPE` | Loại trình duyệt không được hỗ trợ |
| `INVALID_VERSION` | Định dạng phiên bản không hợp lệ |
| `METADATA_LOOKUP_FAILED` | Không thể truy vấn metadata nhân |
| `UNSUPPORTED_VERSION` | Phiên bản nhân không tồn tại hoặc không được hỗ trợ trên nền tảng này |
| `CLIENT_NOT_READY` | Ứng dụng khách chưa sẵn sàng |
| `SDK_NOT_READY` | SDK chưa khởi tạo |
| `INSUFFICIENT_DISK_SPACE` | Không đủ dung lượng đĩa |
| `DOWNLOAD_FAILED` | Tải xuống thất bại |
| `CHECKSUM_MISMATCH` | Xác minh checksum MD5 thất bại |
| `EXTRACTION_FAILED` | Giải nén hoặc cài đặt thất bại |
| `TIMEOUT` | Hết thời gian thao tác |
| `UNKNOWN` | Lỗi không xác định |

## Request fields (application/json):

  - `Cores` (array, required)
    Danh sách nhân cần tải xuống (1–20 mục)

  - `Cores.BrowserType` (integer, required)
    Loại trình duyệt. `1`:Chrome, `2`:Firefox

  - `Cores.Version` (string, required)
    Số phiên bản chính của nhân, ví dụ `"124"`, `"146"`

## Response 200:

  - `200` (unknown)
    Thành công. `data` là một đối tượng với các trường `total`, `succeeded`, `failed` và `results`.

## Response 200 fields (application/json):

  - `code` (integer, required)
    Mã phản hồi. `0`:tất cả thành công; `-1`:thành công một phần; `-2`:tất cả thất bại

  - `msg` (string | null)
    Thông báo lỗi cấp yêu cầu; thường là `null` khi thành công

  - `data` (object, required)

  - `data.total` (integer, required)
    Tổng số tác vụ yêu cầu

  - `data.succeeded` (integer, required)
    Số tác vụ thành công (bao gồm đã cài đặt)

  - `data.failed` (integer, required)
    Số tác vụ thất bại

  - `data.results` (array, required)
    Kết quả thực thi cho mỗi mục nhập, theo cùng thứ tự với yêu cầu

  - `data.results.index` (integer)
    Chỉ mục tương ứng trong mảng `Cores` (bắt đầu từ 0)

  - `data.results.browserType` (integer | null)
    Loại trình duyệt

  - `data.results.requestedVersion` (string | null)
    Phiên bản chính đã yêu cầu

  - `data.results.resolvedVersion` (string)
    Phiên bản đầy đủ thực tế đã giải quyết; được trả về khi thành công hoặc khi metadata đã giải quyết

  - `data.results.status` (string)
    Trạng thái tác vụ:`installed`, `already_installed` hoặc `failed`

  - `data.results.source` (string)
    Nguồn tải xuống:`downloaded`, `already_installed` hoặc `joined_in_flight`

  - `data.results.errorCode` (string)
    Mã phân loại lỗi ổn định được trả về khi thất bại

  - `data.results.serverCode` (integer)
    Tùy chọn. Mã lỗi nghiệp vụ gốc từ dịch vụ nền tảng

  - `data.results.msg` (string)
    Thông báo hiển thị; có thể thay đổi theo ngôn ngữ ứng dụng. Không sử dụng để kiểm tra kết quả theo chương trình

  - `requestId` (string)
    Định danh yêu cầu duy nhất; hãy cung cấp khi liên hệ hỗ trợ

