Skip to content

Chỉnh sửa hồ sơ trình duyệt

Request

Cập nhật một profile trình duyệt hiện có. Chỉ các trường xuất hiện trong yêu cầu bị thay đổi.

  • Điều kiện tiên quyết: profile phải tồn tại trong nhóm. Không thể cập nhật các profile được mã hóa đầu-cuối. Không thể thay đổi hệ điều hành và loại trình duyệt. Một profile đang chạy vẫn cập nhật được.
  • Tác động: ghi bản ghi profile, các thiết lập mở rộng và cookie của nó, và hợp nhất các thiết lập dấu vân tay nâng cao (các giá trị hiện có được giữ lại trừ khi bị ghi đè).
  • Hoàn tất: đồng bộ.
  • Thử lại: an toàn khi gọi lại với cùng một request body. Lưu ý là không có khóa lạc quan: các lần cập nhật đồng thời lên cùng một profile sẽ lấy lần ghi cuối cùng, và việc hợp nhất dấu vân tay đọc trước khi ghi, nên các lệnh gọi song song có thể làm mất thay đổi.

Các mã lỗi nghiệp vụ đã ghi nhận: 19001, 19039, 19104, 19105, 19106, 19107, 19108, 19142, 19159, 19160, 19175, 19193. 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
browserTypeIdinteger

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

operatorSystemIdinteger

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)

envIdstringrequired

ID môi trường

hostnameSourceinteger

Nguồn tên thiết bị:

  • 0 — tùy chỉnh
  • 1 — thật
Enum:01
Example:0
hostnamestring

Tên thiết bị. Được dùng khi hostnameSource là 0.

Example:"DESKTOP-OPENAPI"
macAddressSourceinteger

Nguồn địa chỉ MAC:

  • 0 — tùy chỉnh
  • 1 — thật
Enum:01
Example:0
macAddressstring

Địa chỉ MAC. Được dùng khi macAddressSource là 0.

Example:"00:16:3E:12:34:56"
curl -i -X POST \
  http://127.0.0.1:40000/api/env/update \
  -H 'Content-Type: application/json' \
  -d '{
    "browserTypeId": 1,
    "operatorSystemId": 1,
    "isEncrypt": 1,
    "envId": "1661515884160372",
    "hostnameSource": 0,
    "hostname": "DESKTOP-OPENAPI",
    "macAddressSource": 0,
    "macAddress": "00:16:3E:12:34:56"
  }'

Responses

Thành công. data luôn là null với thao tác này; kết quả được thể hiện qua code.

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