Skip to content

Tạo hồ sơ trình duyệt nâng cao

Request

Tạo một profile trình duyệt với cấu hình dấu vân tay đầy đủ.

  • Điều kiện tiên quyết: cùng các bước kiểm tra gói và hạn mức trong ngày như khi tạo nhanh. Tên profile phải là duy nhất trong nhóm, tọa độ phải nằm ngoài Trung Quốc đại lục, và advancedSetting.ua phải nhất quán với uaVersion. Nếu bạn truyền proxyId, nó phải đã tồn tại trong nhóm.
  • Tác động: chèn profile, thông tin đăng nhập của nó (được mã hóa khi lưu) và cấu hình sau khi khởi động; tiêu tốn dung lượng của gói và bộ đếm tạo trong ngày. Một URL nền tảng tùy chỉnh còn tạo thêm một bản ghi site.
  • Hoàn tất: đồng bộ. data chứa ID của profile mới.
  • Thử lại: không idempotent. Lệnh gọi thứ hai với cùng một envName chỉ định rõ sẽ thất bại ở bước kiểm tra trùng tên; nếu không đặt tên thì nó tạo ra một bản trùng lặp. Không có khóa idempotency. Đừng thử lại một cách mù quáng sau khi hết thời gian chờ: hãy truy vấn trạng thái trước.
  • 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: 19001, 19002, 19004, 19005, 19063, 19064, 19100, 19101, 19102, 19103, 19104, 19105, 19106, 19107, 19108, 19109, 19110, 19111, 19112, 19141, 19175. Xem 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.

Bodyapplication/json
browserTypeIdintegerrequired

ID loại trình duyệt; 1=Chrome, 2=Firefox

operatorSystemIdintegerrequired

ID loại hệ điều hành; 1:Windows 2:macOS 3:Android 4:IOS 5:Linux

isEncryptinteger

Có mã hóa profile hay không; 0=Không, 1=Có

startupParamsArray of strings

Tham số khởi động trình duyệt bổ sung

accountInfoobject(AccountInfo)

Thông tin tài khoản

advancedSettingobject(AdvancedSetting)

Thiết lập dấu vân tay nâng cao của trình duyệt

afterStartupConfigobject(AfterStartupConfig)

Cấu hình sau khi khởi động

browserCoreinteger

Phiên bản kernel; mặc định: 0 (tự động khớp). Lấy các phiên bản khả dụng qua /api/env/advanced/ua/versions.

cookiesstring

Chuỗi cookie nạp trước (không bắt buộc)

envNamestring

Tên môi trường

envRemarkstring

Ghi chú môi trường; độ dài tối đa: 1500 ký tự

groupIdstring

ID nhóm môi trường; mặc định: chưa thuộc nhóm (0)

groupNamestring, <= 50 characters

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.

proxyIdstring

ID proxy; mặc định: 0

tagIdsArray of strings

ID các thẻ; mặc định: không có

uaVersioninteger

Phiên bản UA đặt trước; mặc định: 0 (tất cả)

disableAudiointeger

Tắt âm thanh: 0 = không, 1 = có

disableImginteger

Tắt tải hình ảnh: 0 = không, 1 = có

disableVideointeger

Tắt tải video: 0 = không, 1 = có

imgLimitSizeinteger

Kích thước ảnh tối đa (KB)

proxyobject

Thông tin proxy

curl -i -X POST \
  http://127.0.0.1:40000/api/env/create/advanced \
  -H 'Content-Type: application/json' \
  -d '{
    "browserTypeId": 1,
    "operatorSystemId": 1,
    "isEncrypt": 1
  }'

Responses

Thành công. data là một giá trị chuỗi duy nhất.

Headers
any
Bodyapplication/json
codeintegerrequired
msgstring or nullrequired
datastringrequired
requestIdstringrequired
Response
{ "code": 0, "msg": null, "data": "string", "requestId": "0d8b6f1c-9f4e-4d02-9d1a-7c3f5a1b2c3d" }