Logs
Devuelve los registros de solicitudes del servicio Mobile Proxy, filtrables y paginados.
https://api.proxynet.io/api/v1/orders/{id}/logsTu plan debe incluir acceso a logs. En ISP, Datacenter y Gaming, cada registro es una CONEXIÓN y se escribe cuando se cierra la conexión; el significado de los campos está en la página Registros de log. El registro más reciente va primero.
Cada registro se devuelve con el mismo conjunto fijo de claves; un campo sin valor no falta, llega como null.
Los valores de filtro no válidos no se ignoran en silencio: devuelven 400 invalid_request. Un parámetro desconocido, un rango cuyo inicio es posterior al final o enviar un parámetro propio de ISP a un servicio de Mobile/Residential también devuelven 400; details.field indica de qué parámetro se trata. offset + limit no puede superar 10000.
Si meta.partial es true, la lista puede estar incompleta: en la familia ISP no se pudieron leer los registros antiguos en ese momento; en Mobile/Residential solo se devolvieron los registros más recientes. Vuelve a intentarlo un poco más tarde. Si meta.source es none, este servicio todavía no tiene fuente de logs. Si no se puede acceder temporalmente al almacén de logs, devuelve 503 service_unavailable.
Autorización
Se envía como Bearer <token>. Este endpoint requiere el permiso logs:read (Logs); un token sin él recibe 403.
Parámetros de ruta
El identificador del servicio. Obtenlo del campo id de la respuesta de GET /orders.
Parámetros de consulta
Nivel; se puede enviar varias veces. En la familia ISP se deriva del código de resultado: 0 → connect, 100/101 → auth, 105/106 → quota, 201 → disconnect, los demás códigos → error. Los registros anteriores al 17/09/2026 solo pueden ser connect o error.
Búsqueda libre de IP. Solo se aceptan dígitos, a-f, . y :. En la familia ISP, una dirección IPv4/IPv6 completa coincide exactamente con la IP del cliente, de destino, de salida o de entrada; una parte de la dirección (p. ej., 185.23) debe tener al menos 3 caracteres y se busca dentro de la dirección de destino (solo registros posteriores al 17/09/2026). En Mobile/Residential se busca dentro de la dirección de destino o de la del cliente. Para buscar por dominio, usa target_host.
Inicio, ISO-8601. En la familia ISP se aplica al momento en que la conexión SE CERRÓ y se ajusta al momento de creación del pedido; no se devuelven registros anteriores.
Fin, ISO-8601. No puede ser anterior al inicio.
Grupo de estado HTTP. Solo Mobile y Residential; los registros de la familia ISP no tienen código de estado HTTP, así que allí devuelve 400 (en su lugar, usa result, category u ok).
Límite inferior del tiempo que la conexión estuvo abierta, en ms (entero no negativo). No es la latencia; para la latencia, min_latency_ms.
Límite superior del tiempo abierta, en ms. No puede ser menor que min_duration_ms.
Registros por página: 1-200, predeterminado 50. Un valor 0, negativo o no entero devuelve 400; un valor mayor que 200 se reduce a 200 (meta.limit muestra el valor aplicado).
El número de registros que se omiten. offset + limit no puede superar 10000; en lugar de ir más lejos, acota el rango con start/end.