Logs
Retorna os registros de conexão do serviço Datacenter 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.
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.
Família ISP. true retorna apenas conexões bem-sucedidas; false, apenas as que falharam.
Família ISP. Código de resultado, por exemplo, 105. Pode ser repetido ou separado por vírgulas. Os códigos estão na página Registros de log.
Família ISP. Categoria do resultado. Pode ser repetida ou separada por vírgulas.
Família ISP. Encontra uma única conexão pelo valor de requestId (ULID de 26 caracteres).
Família ISP. O IP do seu cliente (sourceIp); endereço IPv4/IPv6 completo, correspondência exata.
Família ISP. IP de saída (egressIp); endereço IPv4/IPv6 completo, correspondência exata.
Família ISP. Nome do host de destino ou parte dele (letras, números, . e -); não diferencia maiúsculas de minúsculas. No mínimo 3 caracteres; a busca abrange apenas registros a partir de 17/09/2026.
Família ISP. O protocolo efetivamente usado: http ou socks5.
Família ISP. true retorna apenas registros de UDP ASSOCIATE; false não aplica filtro.
Família ISP. Número do slot de porta (1-100000).
Família ISP. A porta do proxy à qual você se conectou (gatePort, 1-65535).
Família ISP. Conexões com latência de conexão de pelo menos esse valor em ms (1-3600000). Registros sem latência medida (latencyMs null) são excluídos.