# Fazendo requisições

## Consulta básica

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

#### Exemplos de código

Neste exemplo, uma consulta para `ip.oxylabs.io` é realizada 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 permite escolher um proxy de um país específico por meio de parâmetros adicionais no nome de usuário. Essa abordagem também suporta controle de sessão. Abaixo está um exemplo da estrutura das credenciais:

`customer-USERNAME-cc-US-sessid-abcde12345:PASSWORD`

#### Parâmetros de consulta

| Parâmetro                                                | Descrição                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <mark style="background-color:green;">**cliente**</mark> | Nome de usuário                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| `cc`                                                     | Código de país em 2 letras, insensível a maiúsculas/minúsculas [**formato 3166-1 alpha-2**](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). Por exemplo, `DE` para Alemanha, `GB` para o Reino Unido, `TH` para 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/mobile-proxies/broken-reference).                                                                                                                                     |
| `city`                                                   | Nome da cidade em inglês, insensível a maiúsculas/minúsculas. 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/mobile-proxies/location-settings/select-city) para mais informações sobre segmentação por cidade. |
| `st`                                                     | Nome do estado dos EUA insensível a maiúsculas/minúsculas com us\_ no início, por exemplo, `us_california`, `us_illinois`. [**Clique aqui**](https://developers.oxylabs.io/documentation/pt-br/proxies/mobile-proxies/location-settings/select-state) para mais informações sobre segmentação por estado.                                                                                                                                                                                                                                               |
| `sessid`                                                 | ID de sessão para manter o mesmo IP em consultas subsequentes. A sessão expira em 10 minutos. Depois disso, um novo endereço IP é atribuído a esse ID de sessão. Cadeia aleatória, caracteres 0-9 e 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.                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| <mark style="background-color:green;">**senha**</mark>   | Senha                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |

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