Перейти к содержимому
Справочник API
/
/
/
Advanced create browser p...

Advanced create browser profile

Request

Create a single browser profile with a full fingerprint configuration.

The browser kernel is matched from published kernels using the operating system and kernel fields in the request. No client version is read.

Security
OpenApiBearer
Bodyapplication/jsonrequired
envNamestring, <= 100 characters

Profile name.

Example:"marketing-01"
browserTypeIdinteger(BrowserType)required

Browser type:

  • 1 — Chrome
  • 2 — Firefox
Enum:12
Example:1
operatorSystemIdinteger(OperatingSystem)required

Operating system:

  • 1 — Windows
  • 2 — macOS
  • 3 — Android
  • 4 — iOS
  • 5 — Linux
Enum:12345
Example:1
groupIdstring^\d+$

Existing group ID. 0 means ungrouped.

Example:"0"
groupNamestring, <= 50 characters

Group name. The group is looked up or created automatically when supplied.

Example:"Marketing"
tagIdsArray of strings

Tag IDs. An empty array means no tags.

Example:
[
  "1800000000000301"
]
proxyIdstring^\d+$

Existing proxy ID. 0 means no proxy.

Example:"0"
proxyobject(ProxyInput)

Proxy connection details. When proxyId refers to an existing proxy, that proxy is reused; otherwise a new proxy is created from these fields.

isEncryptinteger(ToggleFlag)

Whether to encrypt the profile. Defaults to 0.

Enum:01
Example:0
envRemarkstring, <= 1500 characters

Profile remark.

Example:"Created through the Open API"
uaVersioninteger, >= 0

UA major version. Defaults to 0, meaning any.

Example:124
browserCoreinteger, >= 0

Kernel major version. Defaults to 0, which selects a published kernel automatically.

Example:124
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
accountInfoobject(AccountInfo)

Platform account bound to the profile.

isShowAccountinteger(ToggleFlag)

Password protection switch.

Enum:01
Example:0
afterStartupConfigobject(AfterStartupConfigInput)

Behavior applied after the browser starts.

startupParamsArray of strings

Browser startup parameters.

Example:
[
  "--disable-notifications"
]
cookiesstring

Cookies as a JSON text payload.

Example:"[{\"name\":\"sid\",\"value\":\"abc\"}]"
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"
}
disableAudiointeger(ToggleFlag)

Whether to block audio playback.

Enum:01
Example:0
disableVideointeger(ToggleFlag)

Whether to block video loading.

Enum:01
Example:0
disableImginteger(ToggleFlag)

Whether to block image loading.

Enum:01
Example:0
imgLimitSizeinteger, [ 0 .. 100000 ]

Maximum image size to load, in KB.

Example:1000
POST
/env/create/advanced
curl -i -X POST \
  https://api.morelogin.com/env/create/advanced \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "envName": "marketing-01",
    "browserTypeId": 1,
    "operatorSystemId": 1,
    "groupName": "Marketing",
    "isEncrypt": 0,
    "envRemark": "Created through the Open API",
    "uaVersion": 124,
    "browserCore": 124,
    "systemBitType": 1,
    "architecture": 0,
    "afterStartupConfig": {
      "afterStartup": 2,
      "autoOpenUrls": [
        "https://example.com"
      ],
      "stayOnCheckIPPage": false
    },
    "startupParams": [
      "--disable-notifications"
    ],
    "disableAudio": 0,
    "disableVideo": 0,
    "disableImg": 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"
datastring(EnvironmentId)^[1-9]\d*$required

Browser profile (environment) ID. Serialized as a decimal string to avoid JavaScript precision loss on 64-bit integers.

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