# プロキシ情報の変更

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

文書化されたビジネスエラー: `14003`, `14023`。 各コードの意味は [Error Codes](../Getting%20Started/error-codes.md) を参照してください。どの操作でも共通コードが返る場合があります。

Endpoint: POST /api/proxyInfo/update
Version: 2026-09-05

## Request fields (application/json):

  - `id` (string, required)
    固有のプロキシID

  - `proxyIp` (string, required)
    プロキシサーバーのIPアドレス

  - `proxyPort` (integer, required)
    プロキシサーバーポート

  - `proxyName` (string)
    プロキシのカスタム名

  - `country` (string)
    国（例：「US」、「CN」）

  - `city` (string)
    都市名

  - `username` (string)
    認証用ユーザー名（必要な場合）

  - `password` (string)
    認証パスワード（必要な場合）

  - `proxyType` (integer)
    プロキシプロトコルタイプ：
- `0` = HTTP
- `1` = HTTPS
- `2` = SOCKS5
- `3` = SSH

  - `proxyProvider` (integer, required)
    プロキシプロバイダ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

  - `encryptionType` (integer)
    暗号化の種類（プロバイダ固有、通常は0で平文）

  - `ipMonitor` (boolean)
    IPアドレス変更監視を有効にする

  - `ipChangeAction` (integer)
    IPアドレス変更時の対応：
- `1` = 通知／更新（共通値）

> 詳細なオプションについては、システムドキュメントをご確認ください。

（※IPアドレス変更時の対応）

  - `refreshUrl` (string)
    IPアドレスの更新をトリガーするURL（プロバイダがサポートしている場合）

  - `state` (string)
    予約フィールドまたはカスタム状態（オプション）

## Response 200 fields (application/json):

  - `code` (integer, required)
    戻り結果コード0：正常。その他のコードは例外です。

  - `msg` (string | null, required)
    エラーメッセージ

  - `requestId` (string, required)
    操作リクエストID

