# Agregar proxy

Crea una configuración de proxy en el equipo.
- **Requisitos previos**: `proxyPort` es obligatorio y debe estar entre 1 y 65535, y `proxyProvider` debe ser un proveedor reconocido.
- **Efecto**: inserta un registro de proxy y devuelve su identificador, listo para vincular a perfiles. No se envía nada al proveedor del proxy.
- **Finalización**: sincrónica.
- **Reintentos**: **no hay comprobación de unicidad de nombre ni de configuración.** Enviar el mismo cuerpo dos veces produce dos proxies con dos identificadores. Tras un timeout, busca en `/proxyInfo/page` antes de reenviar.

Errores de negocio documentados: `14023`. Consulte [Error Codes](../Getting%20Started/error-codes.md) para el significado de cada código. Cualquier operación puede devolver además los códigos comunes.

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

## Request fields (application/json):

  - `city` (string)
    Ciudad

  - `country` (string)
    Código de país (ISO 3166-1 alfa-2). Solo es necesario si proxyProvider=17.
    Example: AD

  - `encryptionType` (integer)
    Tipo de cifrado, los valores válidos son números enteros del 1 al 14.
    Example: 14

  - `ipChangeAction` (integer)
    Acción ante cambio de IP: 0 = Bloquear, 1 = Advertir
    Example: 1

  - `ipMonitor` (boolean)
    Habilitar la monitorización de cambios de IP
    Example: false

  - `password` (string)
    Contraseña para la autenticación del proxy

  - `proxyIp` (string, required)
    Dirección IP del proxy
    Example: 8.10.22.46

  - `proxyName` (string)
    Nombre proxy (admite marcadores de posición como {{random}})
    Example: sock5_{{random}}

  - `proxyPort` (integer, required)
    Número de puerto proxy
    Example: 65534

  - `proxyProvider` (integer, required)
    Tipo de proveedor de proxy:
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.
Reglas especiales:
- Si proxyProvider es 7 u 8, proxyType es obligatorio.
- Si proxyProvider es 17, country es obligatorio; state y city son opcionales.
    Example: 2

  - `proxyType` (integer)
    Tipo de protocolo proxy: 0=HTTP, 1=HTTPS, 2=SOCKS5, 3=SSH.
Solo es necesario cuando proxyProvider es 7 u 8.
    Example: 1

  - `refreshUrl` (string)
    URL para actualizar la IP del proxy dinámico (si es compatible)

  - `state` (string)
    Estado/Provincia

  - `username` (string)
    Nombre de usuario para la autenticación del proxy

## Response 200 fields (application/json):

  - `code` (integer, required)
    Código de resultado devuelto 0: Normal. Los demás códigos son excepciones.

  - `msg` (string | null, required)
    Mensaje de error

  - `data` (integer, required)
    ID de proxy

  - `requestId` (string, required)
    ID de solicitud de operación