# プロキシを追加する

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

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

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

## 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の場合、国は必須です。州と都市は任意です。
    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 fields (application/json):

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

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

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

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