Làm mới dấu vân tay

Tài liệu tham khảo API

Làm mới dấu vân tay

Request

Sinh lại dấu vân tay của một profile trình duyệt.

Điều kiện tiên quyết: xác định profile bằng envId hoặc uniqueId. Profile đã mã hóa sẽ bị từ chối. Một profile đang chạy không bị chặn, nhưng dấu vân tay mới chỉ áp dụng từ lần khởi động kế tiếp.
Tác động: sinh một dấu vân tay mới, ngẫu nhiên hóa tên host và địa chỉ MAC, và khớp lại kernel trình duyệt. Các giá trị bạn cung cấp trong yêu cầu sẽ thắng các giá trị được sinh ra.
Hoàn tất: đồng bộ.
Thử lại: đừng bao giờ thử lại tự động. Mỗi lần gọi sinh ra một dấu vân tay ngẫu nhiên khác nhau, nên thử lại mù quáng sau khi hết thời gian chờ sẽ thay đổi profile lần thứ hai. Hãy so sánh bằng /env/detail trước.

Các mã lỗi nghiệp vụ đã ghi nhận: 19039, 19104, 19105, 19106, 19107, 19108, 19111, 19142, 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/jsonrequired

envIdstringrequired

Mã định danh hồ sơ (mã định danh môi trường). Phải cung cấp chính xác một trong hai giá trị envId hoặc uniqueId.

uniqueIdstring

Số sê-ri hồ sơ (mã định danh duy nhất). Phải cung cấp chính xác một trong hai giá trị envId hoặc uniqueId.

uaVersioninteger

Phiên bản User-Agent mục tiêu (ví dụ: Chrome 129).

Nếu bỏ qua, sẽ sử dụng phiên bản UA hiện tại từ hồ sơ.

Example:129

browserTypeIdinteger

Loại trình duyệt. 1 = Chrome, 2 = Firefox.

Enum:12

operatorSystemIdinteger

Loại hệ điều hành. 1 = Windows, 2 = macOS, 3 = Android, 4 = iOS.

Enum:1234

advancedSettingobject(AdvancedSetting)

Cấu hình nâng cao về dấu vân tay và hành vi trình duyệt.

curl -i -X POST \
  http://127.0.0.1:40000/api/env/fingerprint/refresh \
  -H 'Content-Type: application/json' \
  -d '{
    "envId": "1869988538611834880",
    "uniqueId": "",
    "uaVersion": 129,
    "browserTypeId": 1,
    "operatorSystemId": 2,
    "advancedSetting": {}
  }'

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

codeinteger

msgstring or null

datanull

requestIdstring

Response

{
  "code": 0,
  "msg": null,
  "data": null,
  "requestId": "0d8b6f1c-9f4e-4d02-9d1a-7c3f5a1b2c3d"
}