# プロキシを追加する

チーム内にプロキシ設定を作成します。
- **前提条件**：`proxyPort` は必須で 1〜65535 の範囲、`proxyProvider` は認識されるデバイスサービスである必要があります。
- **副作用**：プロキシレコードを挿入し、その ID を返します。そのままプロファイルへ紐付けできます。プロキシ事業者側へは何も送信されません。
- **完了シグナル**：同期的です。
- **リトライ**：**名前や設定の一意性チェックはありません。** 同じリクエストボディを 2 回送ると、ID の異なるプロキシが 2 件作られます。タイムアウト後は再送前に `/proxyInfo/page` を検索してください。

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

Endpoint: POST /proxyInfo/add
Version: 2026-09-05
Security: Authorization

## Security:

  - `Authorization` (unknown)
    http bearer JWT

## Request fields (application/json):

  - `city` (string)
    市区町村

  - `country` (string)
    国コード（ISO 3166-1 alpha-2）。proxyProvider=17 の場合にのみ必須です。
    Example: AD

  - `encryptionType` (integer)
    暗号化方式。有効な値は 1 から 14 までの整数です。
    Example: 14

  - `ipChangeAction` (integer)
    IP 変更時の動作：0 = ブロック、1 = 警告
    Example: 1

  - `ipMonitor` (boolean)
    IP 変更の監視を有効にする
    Example: false

  - `password` (string)
    プロキシ認証のパスワード

  - `proxyIp` (string, required)
    プロキシの IP アドレス
    Example: 8.10.22.46

  - `proxyName` (string)
    プロキシ名（{{random}} などのプレースホルダーに対応）
    Example: sock5_{{random}}

  - `proxyPort` (integer, required)
    プロキシのポート番号
    Example: 65534

  - `proxyProvider` (integer, required)
    プロキシ種別の種別：
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.
特別な規則：
- proxyProvider が 7 または 8 の場合、proxyType は必須です。
- proxyProvider が 17 の場合、country は必須で、state と city は省略できます。
    Example: 2

  - `proxyType` (integer)
    プロキシのプロトコル種別： 0=HTTP, 1=HTTPS, 2=SOCKS5, 3=SSH.
proxyProvider が 7 または 8 の場合にのみ必須です。
    Example: 1

  - `refreshUrl` (string)
    動的プロキシの IP を更新する URL（対応している場合）

  - `state` (string)
    都道府県/州

  - `username` (string)
    プロキシ認証のユーザー名

## Response 200:

  - `200` (unknown)
    成功。`data` は単一の integer 値です。

## Response 200 fields (application/json):

  - `code` (integer, required)
    戻り結果コード。0 は正常、それ以外は例外を示します。

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

  - `data` (integer, required)
    プロキシ ID

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