# 添加代理

在团队中创建一条代理配置。
- **前置条件**：`proxyPort` 必填且必须在 1–65535 之间，`proxyProvider` 必须是已识别的供应商。
- **副作用**：写入一条代理记录并返回其 ID，可直接用于绑定浏览器。不会向代理供应商发送任何请求。
- **完成信号**：同步。
- **重试**：**不做名称或配置的唯一性校验。** 同一个请求体提交两次会产生两条代理、两个 ID。超时后请先在 `/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，则 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 fields (application/json):

  - `code` (integer, required)
    返回结果代码 0：正常；其他代码均为例外情况。

  - `msg` (string | null, required)
    错误信息

  - `data` (integer, required)
    代理 ID

  - `requestId` (string, required)
    操作请求 ID