Logs
Retorna os registros de requisição do serviço Residential Proxy, com filtros e paginação.
https://api.proxynet.io/api/v1/orders/{id}/logsO seu plano precisa incluir acesso a logs. Em ISP, Datacenter e Gaming, cada registro é uma CONEXÃO e é gravado quando a conexão é encerrada; o significado dos campos está na página Registros de log. O registro mais recente vem primeiro.
Todo registro vem com o mesmo conjunto fixo de chaves; um campo sem valor não é omitido, vem como null.
Valores de filtro inválidos não são ignorados em silêncio; retornam 400 invalid_request. Um parâmetro desconhecido, um intervalo cujo início é posterior ao fim ou um parâmetro exclusivo de ISP enviado a um serviço Mobile/Residential também retornam 400; details.field informa qual é o parâmetro. offset + limit não pode passar de 10000.
Se meta.partial for true, a lista pode estar incompleta: na família ISP, os registros antigos não puderam ser lidos naquele momento; em Mobile/Residential, só os registros mais recentes foram retornados. Tente de novo em instantes. Se meta.source for none, ainda não há fonte de logs para este serviço. Se o armazenamento de logs estiver temporariamente inacessível, retorna 503 service_unavailable.
Autorização
Enviado no formato Bearer <token>. Este endpoint exige o escopo logs:read (Logs); um token sem esse escopo recebe 403.
Parâmetros de caminho
ID do serviço. Obtenha-o no campo id da resposta de GET /orders.
Parâmetros de consulta
Nível; pode ser enviado várias vezes. Na família ISP, é derivado do código de resultado: 0 → connect, 100/101 → auth, 105/106 → quota, 201 → disconnect, demais códigos → error. Registros anteriores a 17/09/2026 só podem ser connect ou error.
Busca livre por IP. Aceita apenas dígitos, a-f, . e :. Na família ISP, um endereço IPv4/IPv6 completo corresponde exatamente ao IP do cliente, de destino, de saída ou de entrada; uma parte do endereço (por exemplo, 185.23) precisa ter pelo menos 3 caracteres e é buscada dentro do endereço de destino (apenas registros a partir de 17/09/2026). Em Mobile/Residential, é buscada dentro do endereço de destino ou do cliente. Para buscar por domínio, use target_host.
Início, ISO-8601. Na família ISP, aplica-se ao momento em que a conexão foi ENCERRADA e é ajustado ao momento de criação do pedido; registros mais antigos não são retornados.
Fim, ISO-8601. Não pode ser anterior ao início.
Grupo de status HTTP. Apenas Mobile e Residential; os registros da família ISP não têm código de status HTTP, e ali retorna 400 (use result, category ou ok no lugar).
Limite inferior do tempo em que a conexão ficou aberta, em ms (inteiro não negativo). Não é latência; para latência, use min_latency_ms.
Limite superior do tempo em que a conexão ficou aberta, em ms. Não pode ser menor que min_duration_ms.
Registros por página: 1-200, padrão 50. 0, um valor negativo ou não inteiro retorna 400; valores acima de 200 são reduzidos a 200 (meta.limit mostra o valor aplicado).
Número de registros a pular. offset + limit não pode passar de 10000; em vez de ir mais fundo, restrinja o intervalo com start/end.