Saltar para o conteúdo

Modificando informações de proxy

Request

Atualiza uma configuração de proxy.

  • Pré-requisitos: o proxy precisa existir na equipe. Proxies dinâmicos não podem ser atualizados por este endpoint. O provedor precisa ser um valor reconhecido.
  • Efeito: é uma sobrescrita completa, não um patch: os campos que você omitir voltam aos valores padrão em vez de manter os atuais. Leia o proxy primeiro e envie-o de volta completo.
  • Propagação: os perfis mantêm o vínculo porque só o registro do proxy muda, mas um navegador ou Cloud Phone que já esteja em execução continua usando os dados de conexão com que iniciou. Reinicie-o para adotar os novos.
  • Conclusão: sincrônica. Sem bloqueio otimista, então atualizações simultâneas são resolvidas pela última escrita.

Erros de negócio documentados: 14003, 14023. Consulte Error Codes para o significado de cada código. Qualquer operação também pode retornar os códigos comuns.

Bodyapplication/jsonrequired
idstringrequired

ID de proxy exclusivo

proxyIpstringrequired

Endereço IP do servidor proxy

proxyPortintegerrequired

Porta do servidor proxy

proxyNamestring

Nome personalizado para o proxy

countrystring

País (ex.: "EUA", "CN")

citystring

Nome da cidade

usernamestring

Nome de usuário para autenticação (se necessário)

passwordstring

Senha de autenticação (se necessário)

proxyTypeinteger

Tipo de protocolo proxy:

  • 0 = HTTP
  • 1 = HTTPS
  • 2 = SOCKS5
  • 3 = SSH
proxyProviderintegerrequired

ID do 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
encryptionTypeinteger

Tipo de criptografia (específico do provedor, geralmente 0 para texto simples)

ipMonitorboolean

Ativar monitoramento de alterações de IP

ipChangeActioninteger

Ação a ser tomada quando o IP muda:

  • 1 = Notificar / Atualizar (valor comum)

Consulte a documentação do sistema para obter todas as opções.

refreshUrlstring

URL para acionar a atualização de IP (se compatível com o provedor)

statestring

Campo reservado ou estado personalizado (opcional)

POST
/api/proxyInfo/update
curl -i -X POST \
  http://127.0.0.1:40000/api/proxyInfo/update \
  -H 'Content-Type: application/json' \
  -d '{
    "id": "1566403036579198",
    "proxyIp": "108.11.23.85",
    "proxyPort": 4096,
    "proxyName": "MyProxy",
    "country": "US",
    "city": "New York",
    "username": "",
    "password": "",
    "proxyType": 0,
    "proxyProvider": 0,
    "encryptionType": 0,
    "ipMonitor": true,
    "ipChangeAction": 1,
    "refreshUrl": "",
    "state": ""
  }'

Responses

Sucesso. Esta operação não retorna carga útil; o resultado é informado por code.

Headers
any
Bodyapplication/json
codeintegerrequired

Código de resultado retornado: 0: Normal. Outros códigos são exceções.

msgstring or nullrequired

Mensagem de erro

requestIdstringrequired

ID da solicitação de operação

Response
{ "code": 0, "msg": "", "requestId": "efgh5678" }