# Fazendo solicitações

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

A consulta básica requer apenas passar `username` e `password`. 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` é 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 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 divisão da estrutura:

<figure><img src="/files/9421b11a87faa9fb0d6e8722d3f2532257d9f19b" alt=""><figcaption></figcaption></figure>

#### Parâmetros de consulta

| Parâmetro                                                   | Descrição                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| ----------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <mark style="background-color:green;">**`customer`**</mark> | Nome de usuário                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| `cc`                                                        | Código de país sem distinção entre maiúsculas e minúsculas em formato de 2 letras [**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**](/products/pt-br/proxies/residential-proxies/location-settings/select-country.md).                                                                                                                     |
| `city`                                                      | Nome da cidade em inglês sem distinção entre maiúsculas e minúsculas. Este parâmetro deve ser acompanhado por `cc` para melhor 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**](/products/pt-br/proxies/residential-proxies/location-settings/select-city.md) para mais informações sobre targeting em nível de cidade. |
| `st`                                                        | Nome de estado dos EUA sem distinção entre maiúsculas e minúsculas com us\_ no início, por exemplo, `us_california`, `us_illinois`. [**Clique aqui** ](/products/pt-br/proxies/residential-proxies/location-settings/select-state.md)para mais informações sobre targeting em nível de 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. São suportados caracteres aleatórios, 0-9 e A-Z.                                                                                                                                                                                                                                                                                                                               |
| `sesstime`                                                  | O parâmetro de tempo da sessão mantém o mesmo IP por um determinado período. O tempo máximo da sessão é 30 minutos.                                                                                                                                                                                                                                                                                                                                                                                                                          |
| <mark style="background-color:green;">**`password`**</mark> | Senha                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developers.oxylabs.io/products/pt-br/proxies/residential-proxies/making-requests.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
