# 添加代理

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

## Response 200 fields (application/json):

  - `code` (integer, required)
    返回结果码 0:正常 其他为异常

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

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

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