ブラウザプロファイルを変更する

API リファレンス

ブラウザプロファイルを変更する

Request

既存のブラウザープロファイルを更新します。リクエストに含まれるフィールドのみが変更されます。

前提条件：プロファイルがチーム内に存在すること。エンドツーエンド暗号化されたプロファイルは更新できません。OS とブラウザー種別は変更できません。起動中のプロファイルも更新できます。
副作用：プロファイルのレコード、その拡張設定、Cookie を書き込み、高度な指紋設定をマージします（上書きされない限り既存の値は保持されます）。
完了シグナル：同期的です。
リトライ：同一のリクエストボディで繰り返しても安全です。ただし楽観ロックはありません。同一プロファイルへの同時更新は後書き優先で、指紋のマージは書き込み前に読み取るため、同時に呼び出すと変更が失われることがあります。

文書化されたビジネスエラー: 19001, 19039, 19104, 19105, 19106, 19107, 19108, 19142, 19159, 19160, 19175, 19193。各コードの意味は Error Codes を参照してください。どの操作でも共通コードが返る場合があります。

Bodyapplication/json

browserTypeIdinteger

ブラウザー種別 ID：1=Chrome、2=Firefox

operatorSystemIdinteger

OS 種別 ID：1:Windows 2:macOS 3:Android 4:IOS 5:Linux

isEncryptinteger

プロファイルを暗号化するかどうか：0=しない、1=する

startupParamsArray of strings

追加のブラウザー起動パラメーター

accountInfoobject(AccountInfo)

アカウント情報

advancedSettingobject(AdvancedSetting)

ブラウザーの高度な指紋設定

afterStartupConfigobject(AfterStartupConfig)

起動後の設定

browserCoreinteger

カーネルバージョン。デフォルト：0（自動マッチング）。利用可能なバージョンは /api/env/advanced/ua/versions で取得できます。

cookiesstring

事前に読み込む Cookie 文字列（省略可）

envNamestring

環境名

envRemarkstring

環境の備考。最大長：1500 文字

groupIdstring

環境グループ ID。デフォルト：未グループ（0）

groupNamestring, <= 50 characters

グループ名（最大50文字）。指定された場合、システムはまず groupId を確認します：有効なグループが見つかればそれを使用し、見つからなければ groupName で検索します。同名のグループが存在すればそれを参照し、存在しなければ新しいグループを作成します。各チームは最大1,000グループに制限されています。

proxyIdstring

プロキシ ID。デフォルト：0

tagIdsArray of strings

タグ ID。デフォルト：なし

uaVersioninteger

UA プリセットバージョン。デフォルト：0（すべて）

disableAudiointeger

音声を無効化：0 = オフ、1 = オン

disableImginteger

画像の読み込みを無効化：0 = オフ、1 = オン

disableVideointeger

動画の読み込みを無効化：0 = オフ、1 = オン

imgLimitSizeinteger

画像の最大サイズ（KB）

envIdstringrequired

環境 ID

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"
  }'

Responses

成功。この操作の data は常に null です。結果は code で示されます。

Headers

any

Bodyapplication/json

codeintegerrequired

msgstring or nullrequired

datanullrequired

requestIdstringrequired

Response

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