# Fazendo solicitações

#### **Consulta básica**

A consulta básica requer apenas informar `username` e `password`. Nenhum outro parâmetro é necessário. Essa consulta resultará em uma requisição feita a partir de um endereço IP aleatório (proxy). A cada nova requisição será usado um proxy diferente.

#### Exemplos de código

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

{% tabs %}
{% tab title="cURL" %}

```shell
curl -x pr.oxylabs.io:7777 -U "customer-USERNAME:PASSWORD" https://ip.oxylabs.io/location
```

{% endtab %}

{% tab title="PHP" %}

```php
<?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;
?>
```

{% endtab %}

{% tab title="Python" %}

```python
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())
```

{% endtab %}

{% tab title="Java" %}

```java
package example;

import org.apache.http.HttpHost;
import org.apache.http.client.fluent.*;

public class Example {
    public static void main(String[] args) throws Exception {
        HttpHost entry = new HttpHost("pr.oxylabs.io", 7777);
        String query = Executor.newInstance()
            .auth(entry, "customer-USERNAME", "PASS")
            .execute(Request.Get("http://ip.oxylabs.io/location").viaProxy(entry))
            .returnContent().asString();
        System.out.println(query);
    }
}
```

{% endtab %}

{% tab title="C#" %}

```csharp
using System;
using System.Net;

class Example
{
    static void Main()
    {
        var client = new WebClient();
        client.Proxy = new WebProxy("pr.oxylabs.io:7777");
        client.Proxy.Credentials = new NetworkCredential("customer-USERNAME", "PASSWORD");
        Console.WriteLine(client.DownloadString("https://ip.oxylabs.io/location"));
    }
c
```

{% endtab %}

{% tab title="Ruby" %}

```ruby
require 'uri'
require 'net/http'

uri = URI.parse('https://ip.oxylabs.io/location')
proxy = Net::HTTP::Proxy('pr.oxylabs.io', 7777, 'customer-USERNAME', 'PASSWORD')

req = Net::HTTP::Get.new(uri.path)

result = proxy.start(uri.host,uri.port) do |http|
    http.request(req)
end

puts result.body
```

{% endtab %}
{% endtabs %}

Um único proxy backconnect (`pr.oxylabs.io:7777)`permite que você escolha um proxy de país ou cidade específico por meio de parâmetros adicionais no nome de usuário. Essa abordagem também suporta 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á a descrição da estrutura:

<figure><img src="https://1214208351-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzrXw45naRpCZ0Ku9AjY1%2Fuploads%2FVQLieFQN8pPNeUfWMjhU%2FCode%20explained%20for%20Resi%20documentation%20(upd%202024-03).png?alt=media&#x26;token=5b48bede-2e1c-4676-9ba9-37bb0cbf3fc4" alt=""><figcaption></figcaption></figure>

#### Parâmetros da consulta

| Parâmetro                                                   | Descrição                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| <mark style="background-color:green;">**`customer`**</mark> | Nome de usuário                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| `cc`                                                        | Código de país de 2 letras, case insensitive [**formato 3166-1 alpha-2**](https://en.wikipedia.org/wiki/ISO_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**](https://developers.oxylabs.io/documentation/pt-br/proxies/residential-proxies/broken-reference).                                                                                                                                 |
| `city`                                                      | Nome da cidade em inglês, case insensitive. Este parâmetro deve ser acompanhado por `cc` para 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**](https://developers.oxylabs.io/documentation/pt-br/proxies/residential-proxies/location-settings/select-city) para mais informações sobre segmentação por cidade. |
| `st`                                                        | Nome do estado dos EUA, case insensitive, começando com us\_, por exemplo, `us_california`, `us_illinois`. [**Clique aqui** ](https://developers.oxylabs.io/documentation/pt-br/proxies/residential-proxies/location-settings/select-state)para mais informações sobre segmentação por estado.                                                                                                                                                                                                                                             |
| `sessid`                                                    | ID de 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. String aleatória, caracteres 0-9 e A-Z são suportados.                                                                                                                                                                                                                                                                                                                       |
| `sesstime`                                                  | O parâmetro sesstime mantém o mesmo IP por um determinado período. O tempo máximo de sessão é de 30 minutos.                                                                                                                                                                                                                                                                                                                                                                                                                               |
| <mark style="background-color:green;">**`password`**</mark> | Password                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |

&#x20;   \- parâmetro obrigatório