curl --request POST \
--url https://api.wppfy.com/instance/proxy \
--header 'Content-Type: application/json' \
--header 'token: <api-key>' \
--data '
{
"mode": "custom",
"proxy_url": "http://usuario:senha@proxy-do-cliente.example:8080",
"proxy_fallback": "internal"
}
'{
"details": "Proxy configurado",
"proxy": {
"mode": "custom",
"effective_mode": "custom",
"fallback": {
"active": false,
"reason": "",
"since": 0
},
"proxy_url": "http://***:***@proxy-do-cliente.example:8080",
"proxy_fallback": "internal",
"managed": false,
"last_test_at": 0,
"last_test_error": "",
"validation_error": false
},
"restart_requested": true
}Configurar o cambiar el proxy
Define explícitamente uno de los tres estados aceptados:
mode=custom: usa un proxy propio informado enproxy_url;mode=internal: usa la infraestructura interna; omode=none: conexión directa, permitida solo conconfirm_no_proxy=true.
Importante: POST /instance/proxy confirma que la configuración fue guardada, no que el proxy ya se haya comprobado en uso.
La validación operativa principal ocurre en el próximo ciclo real de conexión de la instancia.
En términos prácticos:
200 OKaquí = configuración persistida con éxito;- las fallas reales de conectividad pueden aparecer después; y
- para observar el estado real, consulte
GET /instance/proxyy lea:effective_modeeffective_detailfallback.activelast_test_errorvalidation_error
Cuando mode=custom, también es posible definir la contingencia mediante proxy_fallback:
internal: intenta la infraestructura interna y, si aun así falla, puede usar conexión directa como último recurso;never: no usa contingencia; o- una URL de proxy de contingencia controlada por el propio cliente.
Cuando mode=internal, rotate_now: true cambia inmediatamente el proxy interno persistido.
Si hay más de un origen interno disponible, la plataforma elige otro origen sin exponer al proveedor.
Si hay solo un origen, cambia únicamente el proxy/IP dentro de ese origen.
Protocolos aceptados en URLs de proxy personalizado:
http://usuario:senha@host:portahttps://usuario:senha@host:portasocks5://usuario:senha@host:portasocks5h://usuario:senha@host:porta
El esquema genérico socks:// no se acepta. Para proxies SOCKS, use socks5:// o socks5h://.
curl --request POST \
--url https://api.wppfy.com/instance/proxy \
--header 'Content-Type: application/json' \
--header 'token: <api-key>' \
--data '
{
"mode": "custom",
"proxy_url": "http://usuario:senha@proxy-do-cliente.example:8080",
"proxy_fallback": "internal"
}
'{
"details": "Proxy configurado",
"proxy": {
"mode": "custom",
"effective_mode": "custom",
"fallback": {
"active": false,
"reason": "",
"since": 0
},
"proxy_url": "http://***:***@proxy-do-cliente.example:8080",
"proxy_fallback": "internal",
"managed": false,
"last_test_at": 0,
"last_test_error": "",
"validation_error": false
},
"restart_requested": true
}Autorizaciones
Cuerpo
Campo canónico para definir la estrategia de proxy.
custom, internal, none Obligatorio cuando mode=custom.
Protocolos aceptados: http://, https://, socks5:// y socks5h://.
El esquema genérico socks:// no es compatible; use socks5:// o socks5h://.
"http://usuario:senha@ip:porta"
Política de contingencia para mode=custom.
Acepta internal, never o una URL de proxy de contingencia usando http://, https://, socks5:// o socks5h://.
Obligatorio cuando mode=none.
Cuando es true con mode=internal, cambia de inmediato el proxy interno persistido sin exponer el proveedor utilizado.
País ISO alpha-2 utilizado para validar la salida del proxy gestionado. Úselo solo con mode=internal.
"br"
Estado/provincia del objetivo geográfico devuelto por el catálogo de ciudades.
"sp"
Slug de la ciudad devuelto por GET /proxy-managed/cities.
"campinas"