コンテンツへスキップ

プロキシ情報の変更

Request

プロキシ設定を更新します。

  • 前提条件:プロキシがチーム内に存在すること。ダイナミックプロキシはこのエンドポイントから更新できません。 デバイスサービスは認識される値である必要があります。
  • 副作用:これは部分更新ではなく全体上書きです — 省略したフィールドは現在の値を保持するのではなくデフォルト値に戻ります。まずプロキシを読み出し、完全な形で送り返してください。
  • 反映範囲:変わるのはプロキシレコード自体だけなので、プロファイルの紐付けはそのまま保たれますが、既に稼働中のブラウザーやクラウドフォンは起動時の接続情報を使い続けます。新しい設定を適用するには再起動してください。
  • 完了シグナル:同期的です。楽観ロックはないため、同時更新は後書き優先になります。

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

Security
Authorization
Bodyapplication/jsonrequired
idstringrequired

プロキシの一意な ID

proxyIpstringrequired

プロキシサーバーの IP アドレス

proxyPortintegerrequired

プロキシサーバーのポート

proxyNamestring

プロキシの任意の名前

countrystring

国(例:"US"、"CN")

citystring

都市名

usernamestring

認証ユーザー名(必要な場合)

passwordstring

認証パスワード(必要な場合)

proxyTypeinteger

プロキシのプロトコル種別:

  • 0 = HTTP
  • 1 = HTTPS
  • 2 = SOCKS5
  • 3 = SSH
proxyProviderintegerrequired

プロキシ種別 ID:

  • 0 = HTTP
  • 1 = HTTPS
  • 2 = SOCKS5
  • 3 = SSH
  • 4 = Oxylabs
  • 5 = Proxys.io
  • 6 = GeoSurf
  • 7 = Luminati
  • 8 = Lumauto
  • 9 = Oxylabsauto
  • 10 = Trojan
  • 11 = Shadowsocks
  • 12 = vmess
  • 13 = ABCPROXY
  • 14 = LunaProxy
  • 15 = IPHTML
  • 16 = PiaProxy
  • 17 = 922S5
encryptionTypeinteger

暗号化方式(デバイスサービス固有。通常は平文の 0)

ipMonitorboolean

IP 変更の監視を有効にする

ipChangeActioninteger

IP が変わったときに取る動作:

  • 1 = 通知 / 更新(一般的な値)

すべての選択肢はシステムのドキュメントを参照してください。

refreshUrlstring

IP の更新を実行する URL(デバイスサービスが対応している場合)

statestring

予約フィールドまたは任意の状態(省略可)

curl -i -X POST \
  https://api.morelogin.com/proxyInfo/update \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "id": "1566403036579198",
    "proxyIp": "108.11.23.85",
    "proxyPort": 4096,
    "proxyName": "MyProxy",
    "country": "US",
    "city": "New York",
    "username": "",
    "password": "",
    "proxyType": 0,
    "proxyProvider": 0,
    "encryptionType": 0,
    "ipMonitor": true,
    "ipChangeAction": 1,
    "refreshUrl": "",
    "state": ""
  }'

Responses

成功。この操作はペイロードを返しません。結果は code で示されます。

Headers
any
Bodyapplication/json
codeintegerrequired

戻り結果コード。0 は正常、それ以外は例外を示します。

msgstring or nullrequired

エラーメッセージ

requestIdstringrequired

操作リクエスト ID

Response
{ "code": 0, "msg": "", "requestId": "efgh5678" }