Refresh profile fingerprint

Довідник API

Refresh profile fingerprint

Request

Regenerate the fingerprint of a profile.

Provide at least one of envId or uniqueId. The operating system in the request takes precedence; when it is omitted, the operating system stored on the profile is used to pick a published kernel. No client information is read.

Security

OpenApiBearer

Bodyapplication/jsonrequired

envIdstring(EnvironmentId)^[1-9]\d*$

Profile ID. Provide this or uniqueId.

Example:"1800000000000001"

uniqueIdinteger, (int32)

Profile sequence number. Provide this or envId.

Example:1001

browserCoreinteger, >= 0

Kernel major version. 0 or omitted means automatic matching.

Example:124

uaVersioninteger, >= 0

UA major version. 0 or omitted refreshes according to business rules.

Example:124

browserTypeIdinteger(BrowserType)

Browser type:

1 — Chrome
2 — Firefox

Enum:12

Example:1

operatorSystemIdinteger(OperatingSystem)

Operating system:

1 — Windows
2 — macOS
3 — Android
4 — iOS
5 — Linux

Enum:12345

Example:1

systemBitTypeinteger(SystemBitType)

System bitness. Defaults to 1:

0 — 32-bit
1 — 64-bit

Default:1

Enum:01

Example:1

architectureinteger(Architecture)

CPU architecture. Defaults to 0:

0 — x86
1 — ARM

Default:0

Enum:01

Example:0

advancedSettingobject(AdvancedSetting)

Dynamic fingerprint configuration. Keys come from the profile advanced-settings protocol; each value may be a string, number, boolean, array, or object depending on the key.

Example:

{
  "language": "en-US",
  "timezone": "America/Los_Angeles"
}

POST

/env/fingerprint/refresh

curl -i -X POST \
  https://api.morelogin.com/env/fingerprint/refresh \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "envId": "1800000000000001",
    "browserCore": 124,
    "uaVersion": 124,
    "browserTypeId": 1,
    "operatorSystemId": 1,
    "systemBitType": 1,
    "architecture": 0
  }'

Responses

Success

Bodyapplication/json

codeintegerrequired

Return result code. 0 means success; other codes indicate exceptions.

Example:0

msgstring or nullrequired

Error message. Usually null on success.

Example:null

requestIdstring

Operation request ID. This field may be present when the request passes through the API gateway.

Example:"1d4f3ea968664593860b94b35d4ebf5e"

datanull

Example:null

Response

{
  "code": 0,
  "msg": null,
  "requestId": "1d4f3ea968664593860b94b35d4ebf5e",
  "data": null
}