# Adicionando proxy

Cria uma configuração de proxy na equipe.
- **Pré-requisitos**: `proxyPort` é obrigatório e precisa estar entre 1 e 65535, e `proxyProvider` precisa ser um provedor reconhecido.
- **Efeito**: insere um registro de proxy e retorna o identificador dele, pronto para vincular a perfis. Nada é enviado ao fornecedor do proxy.
- **Conclusão**: sincrônica.
- **Nova tentativa**: **não há verificação de unicidade de nome nem de configuração.** Enviar o mesmo corpo duas vezes produz dois proxies com dois identificadores. Depois de um timeout, procure em `/proxyInfo/page` antes de reenviar.

Erros de negócio documentados: `14023`. Consulte [Error Codes](../Getting%20Started/error-codes.md) para o significado de cada código. Qualquer operação também pode retornar os códigos comuns.

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

## Request fields (application/json):

  - `city` (string)
    Cidade

  - `country` (string)
    Código do país (ISO 3166-1 alfa-2). Necessário apenas se proxyProvider=17.
    Example: AD

  - `encryptionType` (integer)
    Tipo de criptografia, valores válidos são números inteiros de 1 a 14.
    Example: 14

  - `ipChangeAction` (integer)
    Ação em caso de alteração de IP: 0 = Bloquear, 1 = Avisar
    Example: 1

  - `ipMonitor` (boolean)
    Ativar monitoramento de alterações de IP
    Example: false

  - `password` (string)
    Senha para autenticação de proxy

  - `proxyIp` (string, required)
    Endereço IP do proxy
    Example: 8.10.22.46

  - `proxyName` (string)
    Nome do proxy (suporta marcadores como {{random}})
    Example: sock5_{{random}}

  - `proxyPort` (integer, required)
    Número da porta do proxy
    Example: 65534

  - `proxyProvider` (integer, required)
    Tipo de provedor 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.
Regras especiais:
- Se proxyProvider for 7 ou 8, proxyType é obrigatório.
- Se proxyProvider for 17, country é obrigatório; state e city são opcionais.
    Example: 2

  - `proxyType` (integer)
    Tipo de protocolo proxy: 0=HTTP, 1=HTTPS, 2=SOCKS5, 3=SSH.
Necessário apenas quando proxyProvider for 7 ou 8.
    Example: 1

  - `refreshUrl` (string)
    URL para atualizar o IP do proxy dinâmico (se compatível)

  - `state` (string)
    Estado/Província

  - `username` (string)
    Nome de usuário para autenticação de proxy

## Response 200 fields (application/json):

  - `code` (integer, required)
    Código de resultado retornado: 0: Normal. Outros códigos são exceções.

  - `msg` (string | null, required)
    Mensagem de erro

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

  - `requestId` (string, required)
    ID da solicitação de operação