# Khởi tạo hồ sơ trình duyệt

Dùng để khởi tạo hồ sơ; bạn phải chỉ định ID hồ sơ. Sau khi khởi động thành công, bạn có thể truy cập giao diện gỡ lỗi hồ sơ để thực thi tự động hóa Selenium và Puppeteer. Đối với Selenium, hãy sử dụng
WebDriver phù hợp với phiên bản kernel tương ứng. Đường dẫn WebDriver
có thể được lấy từ phản hồi sau khi khởi động hồ sơ. Yêu cầu
phiên bản máy khách MoreLogin 2.15.0 trở lên.
Các mã lỗi nghiệp vụ đã ghi nhận: `19099`, `19143`. Xem [Error Codes](../Getting%20Started/error-codes.md) để biết ý nghĩa từng mã. Mọi thao tác cũng có thể trả về các mã dùng chung.

Endpoint: POST /api/env/start
Version: 2026-09-05

## Request fields (application/json):

  - `envId` (string)
    Mã định danh môi trường. Phải cung cấp ít nhất một trong hai giá trị `envId` hoặc `uniqueId`.
Nếu cung cấp cả hai, `envId` sẽ được ưu tiên.
    Example: 1993244721490239488

  - `uniqueId` (integer)
    Số sê-ri môi trường (mã định danh dạng số nguyên nhỏ). Phải cung cấp ít nhất một trong hai giá trị `envId` hoặc `uniqueId`.
Nếu cung cấp cả hai, `envId` sẽ được ưu tiên.
    Example: 1

  - `encryptKey` (string)
    Khóa mã hóa. Chỉ cần thiết nếu tính năng mã hóa đầu cuối được bật cho môi trường.
    Example: xxx

  - `isHeadless` (boolean)
    Liệu có khởi động ở chế độ không giao diện người dùng hay không. Mặc định là `false` nếu bỏ qua tham số này.
Lưu ý: Yêu cầu phiên bản máy khách v2.36.0 trở lên.
    Example: false

  - `cdpEvasion` (boolean)
    Kích hoạt tính năng né tránh dấu vân tay CDP để giảm nguy cơ bị phát hiện.
Chỉ áp dụng cho môi trường PC.
Mặc định: `false`.
Lưu ý: Yêu cầu phiên bản máy khách v2.36.0 trở lên.
    Example: false

  - `closeCheckIPPage` (boolean)
    Có bỏ qua việc mở trang kiểm tra hay không.
true: kiểm tra proxy trước khi thực thi
false: kiểm tra proxy sau khi thực thi
Lưu ý: Yêu cầu client phiên bản v2.56.0 hoặc mới hơn.
    Example: false

  - `checkIPErrorHandle` (integer)
    Hành động thực hiện nếu kiểm tra proxy thất bại
Kiểu số: 1 hoặc 2
1: Không khởi động môi trường nếu kiểm tra proxy thất bại
2: Vẫn khởi động môi trường dù kiểm tra proxy thất bại
Nếu đã truyền giá trị cho closeCheckIPPage thì tham số này bị bỏ qua; mặc định: 1
Lưu ý: Yêu cầu client phiên bản v2.56.0 hoặc mới hơn.
    Example: 1

## Response 200:

  - `200` (unknown)
    Thành công. `data` là một đối tượng với các trường `envId`, `debugPort`, `type`, `version` và `webdriver`.

## Response 200 fields (application/json):

  - `code` (integer)

  - `msg` (string | null)

  - `data` (object, required)

  - `data.envId` (string, required)
    hồ sơ

  - `data.debugPort` (string, required)

  - `data.type` (string, required)

  - `data.version` (integer, required)

  - `data.webdriver` (string, required)

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