コンテンツへスキップ

高度なブラウザプロファイルの作成

Request

完全な指紋設定を持つブラウザープロファイルを 1 件作成します。

  • 前提条件:クイック作成と同じプランおよび当日上限のチェックが行われます。プロファイル名はチーム内で一意であること、座標は中国本土の外であること、advancedSetting.ua は uaVersion と整合していることが必要です。proxyId を指定する場合、それがチーム内に既に存在していなければなりません。
  • 副作用:プロファイル、そのアカウント資格情報(保存時に暗号化)、起動後設定を挿入し、プランの容量と当日作成カウンターを消費します。カスタムプラットフォーム URL を指定するとサイトレコードも作成されます。
  • 完了シグナル:同期的です。data に新しいプロファイル ID が入ります。
  • リトライ:冪等ではありません。同じ envName を明示した 2 回目の呼び出しは一意性チェックで失敗し、名前を指定しない場合は重複が作られます。冪等キーはありません。タイムアウト後に無条件でリトライせず、まず状態を照会してください。
  • Local API:カーネル候補は稼働中のデスクトップクライアントのバージョンで絞り込まれ、同一チームからの同時呼び出しはチーム単位のロックで直列化されます。

文書化されたビジネスエラー: 19001, 19002, 19004, 19005, 19063, 19064, 19100, 19101, 19102, 19103, 19104, 19105, 19106, 19107, 19108, 19109, 19110, 19111, 19112, 19141, 19175。 各コードの意味は Error Codes を参照してください。どの操作でも共通コードが返る場合があります。

Bodyapplication/json
browserTypeIdintegerrequired

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

operatorSystemIdintegerrequired

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)

proxyobject

プロキシ情報

curl -i -X POST \
  http://127.0.0.1:40000/api/env/create/advanced \
  -H 'Content-Type: application/json' \
  -d '{
    "browserTypeId": 1,
    "operatorSystemId": 1,
    "isEncrypt": 1
  }'

Responses

成功。data は単一の string 値です。

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