コンテンツへスキップ

プロファイルプロキシを一括変更

Request

複数のブラウザープロファイルにプロキシを紐付けます。

  • 前提条件:envIds または uniqueIds の少なくとも一方を指定します。proxyId を指定する場合、それがチーム内に既に存在していなければならず、存在しなければ自動作成されるのではなく呼び出しが拒否されます。
  • 副作用:各プロファイルに proxyId を書き込みます。proxyId を省略または 0 にした場合、接続情報が完全に一致する既存のプロキシが再利用され、一致するものがなければ呼び出し元のチームに新しいプロキシレコードが作成されます。
  • 完了シグナル:同期的です。起動中のブラウザーは起動時のプロキシを使い続けます。
  • リトライ:同じ proxyId の再紐付けは冪等ですが、生の接続情報を含む呼び出しを繰り返すと、重複排除が外れるたびに新しいプロキシレコードが作られる可能性があります。

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

Bodyapplication/jsonrequired
envIdsArray of strings

シリアルID付きのものを1つ選択してください。1つは必須です。

proxyobjectrequired

環境ごとにバインドされているプロキシを変更するために使用します。proxyId が指定されている場合は、その ID で表されるプロキシにバインドします。指定されていない場合は、新しく追加されたプロキシにバインドします。プロキシ情報が変更されていない場合は、再バインドは発生しません (proxyIp、proxyPort、proxyType、または proxyProvider のいずれかに変更があった場合は、新しいプロキシとみなされ、再バインドが成功します)。

uniqueIdsArray of strings

環境IDを含むものを選択してください(必須項目です)

curl -i -X POST \
  http://127.0.0.1:40000/api/env/setProxy/batch \
  -H 'Content-Type: application/json' \
  -d '{
    "proxy": {
      "city": "string",
      "country": "string",
      "encryptionType": 1,
      "ipChangeAction": 1,
      "ipMonitor": true,
      "password": "string",
      "proxyId": "1661515884160372",
      "proxyIp": "string",
      "proxyName": "example-name",
      "proxyPort": 1,
      "proxyProvider": "string",
      "proxyType": 1,
      "refreshUrl": "https://example.com/resource",
      "state": "string",
      "username": "example-name"
    }
  }'

Responses

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

Headers
any
Bodyapplication/json
codeinteger
msgstring or null
databoolean
requestIdstringrequired
Response
{ "code": 0, "msg": null, "data": true, "requestId": "d57cfecfc6904fcaa57da9f65b2a15fd" }