# Requisições com IPs na lista de permissões

Com IPs na whitelist, você pode acessar os Proxies Residenciais da Oxylabs **sem precisar fornecer um `nome de usuário` e `senha`**. Ao colocar seu endereço IP na whitelist, você pode especificar todos os seus parâmetros de proxy **diretamente no subdomínio.** 

Se você adicionar um IP à whitelist, deve se conectar usando **ou o IP na whitelist ou credenciais**, mas não ambos, pois isso pode levar a comportamentos inesperados.

#### Exemplo de código 

Aqui está um exemplo de código direcionando para Nova York com um ID de sessão dado: 

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

```shell
curl -x https://cc-us-city-new_york-sessid-test123.bc.pr.oxylabs.io:7777 https://ip.oxylabs.io/location
```

{% endtab %}

{% tab title="PHP" %}

```php
<?php
$session_id = 'test123';  // Your session ID
$city = 'new_york';  // The city you want to target
$proxy = "cc-us-city-$city-sessid-$session_id.bc.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");
$output = curl_exec($query);
curl_close($query);

if ($output)
    echo $output;
?>

```

{% endtab %}

{% tab title="Python" %}

```python
import urllib.request

session_id = 'test123'  # Your session ID
city = 'new_york'  # The city you want to target
proxy = 'cc-us-city-%s-sessid-%s.bc.pr.oxylabs.io:7777' % (city, session_id)

query = urllib.request.ProxyHandler({
    'http': proxy,
    'https': proxy,
})

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("cc-us-city-new_york-sessid-test123.bc.pr.oxylabs.io", 7777);

        String query = Executor.newInstance()
            .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("cc-us-city-new_york-sessid-test123.bc.pr.oxylabs.io:7777");

        Console.WriteLine(client.DownloadString("https://ip.oxylabs.io/location"));
    }
}

```

{% endtab %}

{% tab title="Go" %}

```ruby
package main

import (
	"fmt"
	"io/ioutil"
	"net/http"
	"net/url"
)

func main() {
	proxyURL, _ := url.Parse("https://cc-us-city-new_york-sessid-test123.bc.pr.oxylabs.io:7777")
	client := &http.Client{Transport: &http.Transport{Proxy: http.ProxyURL(proxyURL)}}

	resp, err := client.Get("https://ip.oxylabs.io/location")
	if err != nil {
		fmt.Println("Error:", err)
		return
	}
	defer resp.Body.Close()

	body, _ := ioutil.ReadAll(resp.Body)
	fmt.Println(string(body))
}
```

{% endtab %}
{% endtabs %}

**Parâmetros de consulta**

| Parâmetro    | Descrição                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `cc`         | Código de país insensível a maiú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**](https://developers.oxylabs.io/documentation/pt-br/proxies/residential-proxies/location-settings/select-country).                                                                                            |
| `city`       | Nome da cidade em inglês, insensível a maiú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**](https://developers.oxylabs.io/proxies/residential-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 com us\_ no começo, por exemplo, `us_california`, `us_illinois`. [**Clique aqui** ](https://developers.oxylabs.io/proxies/residential-proxies/location-settings/select-state)para mais informações sobre segmentação por estado.                                                                                                                                                                                                                                                |
| `cn`         | Para obter um proxy de qualquer um dos sete continentes, adicione o `cn-`  parâmetro e o código de duas letras à string de autorização. Clique aqui para mais informações sobre segmentação por continente                                                                                                                                                                                                                                                                                                                     |
| `postalcode` | <p>Para conectar-se a um proxy usando um CEP, adicione e especifique o <code>postalcode</code> parâmetro com um <strong>CEP de cinco dígitos</strong> . Este parâmetro deve ser usado combinado com o parâmetro de código do país <code>cc</code> e um código de país insensível a maiúsculas em 2 letras <a href="https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2"><strong>3166-1 alpha-2</strong></a>. <br><a href="../location-settings/zip-postal-code">Saiba mais aqui.</a></p>                                          |
| `ASN`        | Você pode escolher proxies de carriers específicos. Você precisa inserir o número ASN requerido na sua solicitação. [Saiba mais aqui](https://developers.oxylabs.io/documentation/pt-br/proxies/residential-proxies/location-settings/asn-targeting).                                                                                                                                                                                                                                                                          |
| `sessid`     | ID de sessão para manter o mesmo IP em consultas subsequentes. A sessão expira em 10 minutos. Após isso, um novo endereço IP é atribuído a esse ID de sessão. String aleatória; são suportados caracteres de 0-9 e A-Z.                                                                                                                                                                                                                                                                                                        |
| `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.                                                                                                                                                                                                                                                                                                                                                                                                         |