# Tạo hồ sơ trình duyệt nhanh

Tạo từ 1 đến 200 profile trình duyệt dùng chung một cấu hình.
- **Điều kiện tiên quyết**
: gói của nhóm phải còn đủ số profile, và hạn mức tạo trong ngày chưa được dùng hết.
`isEncrypt=1`
 yêu cầu nhóm đã cấu hình khóa mã hóa. Firefox chỉ khả dụng trên Windows và macOS.
`groupId`
 phải đã tồn tại, nhưng nếu truyền
`groupName`
 thay cho nó thì nhóm sẽ được tạo tự động.
- **Tác động**
: chèn các profile, tiêu tốn dung lượng của gói, và tăng bộ đếm tạo trong ngày. Truyền thông tin kết nối proxy cũng có thể tạo thêm một bản ghi proxy.
- **Hoàn tất**
: đồng bộ.
`data`
 chứa ID của các profile mới theo thứ tự tạo.
- **Thử lại**
: không idempotent, và không có khóa idempotency. Hãy xác nhận bằng
`/env/page`
 thay vì thử lại.
- **Local API**
: các kernel ứng viên được lọc theo phiên bản client desktop đang chạy, và các lệnh gọi đồng thời từ cùng một nhóm được xếp tuần tự bằng khóa ở cấp nhóm.

Các mã lỗi nghiệp vụ đã ghi nhận: `19002`, `19063`, `19064`, `19104`, `19106`, `19107`, `19108`, `19111`, `19112`, `14023`. Xem [Error Codes](/vi/api-reference/getting-started/error-codes) để 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/create/quick
Version: 2026-09-05

## Request fields (application/json):

  - `browserTypeId` (integer, required)
    1:Chrome, 2:Firefox
    Example: 1

  - `groupId` (string)
    ID nhóm môi trường; mặc định: không được nhóm (0)
    Example: 0

  - `groupName` (string)
    Tên nhóm (tối đa 50 ký tự). Nếu được cung cấp, hệ thống sẽ kiểm tra groupId trước: nếu tìm thấy nhóm hợp lệ thì sử dụng nhóm đó; nếu không, tìm kiếm theo groupName. Nếu nhóm có tên đó tồn tại thì tham chiếu nhóm đó; nếu không thì tạo nhóm mới. Mỗi đội bị giới hạn 1.000 nhóm.

  - `isEncrypt` (integer)
    Bật mã hóa đầu cuối? 0: Không, 1: Có; mặc định: 0

  - `operatorSystemId` (integer, required)
    Loại hệ điều hành: 1: Windows, 2: macOS, 3: Android, 4: iOS
    Example: 1

  - `quantity` (integer, required)
    Số lượng môi trường cần tạo; phạm vi: [1–50]
    Example: 1

  - `browserCore` (integer)
    Phiên bản nhân trình duyệt; mặc định: 0 (tự động khớp). Lấy các phiên bản khả dụng thông qua '/api/env/advanced/ua/versions'
    Example: 140

  - `proxy` (object)
    Máy chủ proxy

  - `proxy.skipDuplicateProxy` (boolean)
    Áp dụng khi cung cấp thông tin kết nối mà không chỉ định `proxyId` hiện có. Khi đặt thành `true`, hệ thống dùng lại proxy trùng khớp và tạo bản ghi mới nếu không tìm thấy. Khi đặt thành `false`, hệ thống tạo bản ghi mới ngay cả khi có proxy trùng khớp.

  - `proxy.proxyId` (string)
    ID ủy quyền

  - `proxy.proxyName` (string)
    Tên máy chủ proxy (tối đa 600 ký tự)

  - `proxy.proxyType` (integer)
    Loại proxy, 0: http, 1: https. Không được để trống khi proxyProvider là 7/8

  - `proxy.proxyProvider` (string)
    Loại proxy 0: http, 1: https, 2: socks5, 3: ssh, 4: Oxylabs, 5: Proxys.io, 7: Luminati, 8: Lumauto, 9: Oxylabsauto, 10: Trojan, 11: Shadowsocks, 13: ABCPROXY, 14: LunaProxy, 15: IPHTML, 16: PiaProxy, 17: 922S5, 18: 360Proxy

  - `proxy.proxyIp` (string)
    Địa chỉ IP proxy. Có thể để trống khi proxyProvider là 16/17/18; bắt buộc đối với các trường hợp khác.

  - `proxy.proxyPort` (integer)
    Cổng proxy (chỉ cho phép các số từ 1-65535). Có thể để trống khi proxyProvider là 16/17/18; bắt buộc đối với các trường hợp khác.

  - `proxy.username` (string)
    Tên người dùng (tối đa 200 ký tự)

  - `proxy.password` (string)
    Mật khẩu (tối đa 100 ký tự)

  - `proxy.refreshUrl` (string)
    Làm mới URL

  - `proxy.country` (string)
    Quốc gia (mã quốc gia cụ thể, xem phụ lục). Bắt buộc khi proxyProvider là 16/17/18

  - `proxy.city` (string)
    Thành phố

  - `proxy.state` (string)
    Tiểu bang/Tỉnh

  - `proxy.encryptionType` (integer)
    Phương thức mã hóa. Không được để trống khi proxyProvider là 11. 1: aes-128-gcm, 2: aes-192-gcm, 3: aes-256-gcm, 4: aes-128-cfb, 5: aes-192-cfb, 6: aes-256-cfb, 7: aes-128-ctr, 8: aes-192-ctr, 9: aes-256-ctr, 10: rc4-md5, 11: chacha20-ietf, 12: xchacha20, 13: chacha20-ietf-poly1305, 14: xchacha20-ietf-poly1305

  - `proxy.ipMonitor` (boolean)
    Cho phép theo dõi thay đổi địa chỉ IP? true: Bật, false: Tắt

  - `proxy.ipChangeAction` (integer)
    Giám sát thay đổi địa chỉ IP: 0: Chặn truy cập, 1: Cảnh báo

## Response 200:

  - `200` (unknown)
    Thành công. `data` là mảng chuỗi, và là mảng rỗng khi không có gì để trả về.

## Response 200 fields (application/json):

  - `code` (integer, required)

  - `msg` (string | null, required)

  - `data` (array, required)

  - `requestId` (string, required)

