Saltar al contenido
Referencia de API
/
Recursos compartidos
/
/Proxies

Obtener una lista de proxies

Request

Lista las configuraciones de proxy del equipo, página a página.

  • Efecto: ninguno. Solo lectura. Es seguro reintentar con retroceso acotado.
  • Nota: las contraseñas se omiten para los miembros ordinarios y para los proxies en la nube y dinámicos. Los proxies dinámicos aparecen aquí pero se gestionan en otro sitio y no se pueden editar mediante los endpoints de proxy.
Bodyapplication/jsonrequired
pageNointeger

Número de página actual (comienza desde 1)

Example:1
pageSizeinteger

Número de elementos por página

Example:10
isCloudPhoneProxyboolean

Indica si el proxy se utiliza para el uso de telefonía en la nube.

  • true: Excluir direcciones IP locales/privadas (p. ej., 127.0.0.1, 360, pia, rangos privados)
  • false: Mostrar todos los proxies
Example:false
proxyCategoryTypeinteger

Tipo de categoría de proxy:

  • 1 = Plataforma en la nube
  • 2 = IP propia
Example:2
proxyIpstring

Filtrar por dirección IP del proxy (coincidencia parcial)

Example:""
proxyNamestring

Filtrar por nombre de proxy (coincidencia parcial)

Example:""
proxyProvidersArray of integers

Lista de identificadores de proveedores de proxy. Valores admitidos:

  • 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
Example:
[]
proxyStatusinteger

Estado de asignación del proxy:

  • 0 = Normal
  • 1 = Sin asignar
  • 2 = En actualización
  • 3 = Caducado
  • 4 = Próximo a caducar

Nota: Los proxies propios siempre utilizan el estado 1.

Example:1
proxyCheckStatusinteger

Estado de la comprobación del proxy:

  • 0 = Pendiente
  • 1 = Correcto
  • 2 = Fallido
  • 3 = Error desconocido
Example:1
proxyTypesArray of integers

Tipos de protocolo proxy:

  • 0 = HTTP
  • 1 = HTTPS
  • 2 = SOCKS5
  • 3 = SSH
Example:
[]
POST
/api/proxyInfo/page
curl -i -X POST \
  http://127.0.0.1:40000/api/proxyInfo/page \
  -H 'Content-Type: application/json' \
  -d '{
    "pageNo": 1,
    "pageSize": 10,
    "isCloudPhoneProxy": false,
    "proxyCategoryType": 2,
    "proxyIp": "",
    "proxyName": "",
    "proxyProviders": [],
    "proxyStatus": 1,
    "proxyCheckStatus": 1,
    "proxyTypes": []
  }'

Responses

Correcto. data.dataList contiene los registros de la página solicitada y es un array vacío cuando no hay coincidencias; data.total, data.current y data.pages describen la paginación.

Headers
any
Bodyapplication/json
codeintegerrequired

Código de resultado devuelto 0: Normal. Los demás códigos son excepciones.

msgstring or nullrequired

Mensaje de error

dataobjectrequired
requestIdstringrequired

ID de solicitud de operación

Response
{
  "code": 0,
  "msg": null,
  "data": {
    "current": "1",
    "dataList": [ … ],
    "pages": "1",
    "total": "1"
  },
  "requestId": "0d8b6f1c-9f4e-4d02-9d1a-7c3f5a1b2c3d"
}