For the complete documentation index, see llms.txt. This page is also available as Markdown.

Fazendo solicitações

Aprenda a fazer solicitações com Residential Proxies. Domine a estrutura básica da consulta e use parâmetros para direcionamento por localização, seleção de cidade e sessões.

Consulta básica

A consulta básica requer apenas informar nome de usuário e senha. Nenhum outro parâmetro é necessário. Essa consulta fará com que a solicitação seja feita a partir de um endereço IP aleatório (proxy). Cada nova solicitação usará um proxy diferente.

Exemplos de código

Neste exemplo, uma consulta para ip.oxylabs.io/location é realizada a partir de um IP aleatório:

curl -x pr.oxylabs.io:7777 -U "customer-USERNAME:PASSWORD" https://ip.oxylabs.io/location
<?php
$username = 'USERNAME';
$password = 'PASSWORD';
$proxy = 'pr.oxylabs.io:7777';
$query = curl_init('https://ip.oxylabs.io/location');
curl_setopt($query, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($query, CURLOPT_PROXY, "http://$proxy");
curl_setopt($query, CURLOPT_PROXYUSERPWD, "customer-$username:$password");
$output = curl_exec($query);
curl_close($query);
if ($output)
    echo $output;
?>
import urllib.request
import random
username = 'USERNAME'
password = 'PASSWORD'
entry = ('http://customer-%s:%s@pr.oxylabs.io:7777' %
    (username, password))
query = urllib.request.ProxyHandler({
    'http': entry,
    'https': entry,
})
execute = urllib.request.build_opener(query)
print(execute.open('https://ip.oxylabs.io/location').read())

Um único proxy backconnect (pr.oxylabs.io:7777)permite escolher um proxy específico de país ou cidade por meio de parâmetros adicionais no nome de usuário. Essa abordagem também oferece suporte ao controle de sessão. Aqui está um exemplo de credenciais:

customer-USERNAME-cc-US-city-CITY-sessid-abcde12345:PASSWORD

customer-USERNAME-cc-US-city-CITY-sessid-abcde12345-sesstime-5:PASSWORD

Abaixo está uma análise da estrutura:

Parâmetros de consulta

Parâmetro
Descrição

customer

Nome de usuário

cc

Código de país sem diferenciar maiúsculas e minúsculas em 2 letras formato 3166-1 alpha-2. Por exemplo, DE para a Alemanha, GB para o Reino Unido, TH para a Tailândia. Você pode encontrar mais detalhes sobre como usar proxies específicos por país aqui.

city

Nome da cidade em inglês, sem diferenciar maiúsculas e minúsculas. Este parâmetro deve ser acompanhado por cc para obter maior precisão, por exemplo, cc-GB-city-london para Londres, Reino Unido; cc-DE-city-berlin para Berlim, Alemanha. Para uma cidade com mais de duas palavras, substitua o espaço por _, por exemplo, city-st_petersburg ou city-rio_de_janeiro. Clique aqui para mais informações sobre segmentação em nível de cidade.

st

Nome do estado dos EUA sem diferenciar maiúsculas e minúsculas, com us_ no início, por exemplo, us_california, us_illinois. Clique aqui para mais informações sobre segmentação em nível de estado.

sessid

ID da sessão para manter o mesmo IP nas próximas consultas. A sessão expira em 10 minutos. Depois disso, um novo endereço IP é atribuído a esse ID de sessão. Uma string aleatória e caracteres de 0 a 9 e de A a Z são suportados.

sesstime

O parâmetro de tempo de sessão mantém o mesmo IP por um determinado período. O tempo máximo de sessão é de 30 minutos.

senha

Senha

- Parâmetro obrigatório

Nó de entrada para a China

Configuramos nós de entrada nas regiões de Hong Kong e Pequim para melhor conectividade a partir da China. Observe que se trata de um nó proxy HTTPS. Todos os parâmetros de nome de usuário são idênticos aos do nó de entrada regular.

Observe que algumas ferramentas de terceiros atualmente não funcionam com os nós de entrada de Hong Kong e Pequim. As ferramentas de terceiros que funcionam com esses nós de entrada são:

  1. SwitchyOmega

  2. Shadowrocket

No momento, estamos trabalhando para corrigir o restante das integrações nas quais o protocolo HTTPS terá suporte.

Se você estiver se conectando à nossa rede residencial a partir da China e ainda tiver problemas com os nós de entrada fornecidos, entre em contato em support@oxylabs.io, e encontraremos uma solução juntos.

Atualizado

Isto foi útil?