> For the complete documentation index, see [llms.txt](https://developers.oxylabs.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.oxylabs.io/products/pt-br/proxies/residential-proxies/getting-started.md).

# Primeiros passos

Faça uma solicitação para `https://ip.oxylabs.io/location` usando um proxy residencial de um local aleatório por meio do nosso [**ponto de entrada backconnect**](/products/pt-br/proxies/residential-proxies/making-requests.md). Substitua `USERNAME` e `PASSWORD` pelas credenciais de usuário do seu proxy. Lembre-se de que cada solicitação retorna um novo endereço IP, pois Oxylabs Residential Proxies rotacionam automaticamente.

{% hint style="info" %}
Use [**ip.oxylabs.io/location**](https://ip.oxylabs.io/location) para verificar os parâmetros dos seus IPs — este domínio fornece informações de quatro bancos de dados de geolocalização: MaxMind, IP2Location, DB-IP e IPinfo.io. Os parâmetros incluem endereço IP, provedor, país, cidade, CEP, ASN, nome da organização e fuso horário.
{% endhint %}

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

{% hint style="info" %}
Nossos Residential Proxies oferecem suporte a `HTTP`, `HTTPS`, `HTTP3` e `SOCKS5` protocolos. Você pode saber mais sobre como usá-los [**aqui**](/products/pt-br/proxies/residential-proxies/protocols.md). 
{% endhint %}

Agora faça uma solicitação usando um proxy da França. Tudo o que você precisa fazer é adicionar `cc-FR` à sua string de nome de usuário. Abaixo está um exemplo em cURL, e aqui você pode encontrar [exemplos de código em outras linguagens](/products/pt-br/proxies/residential-proxies/location-settings/select-country.md).

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

Aqui está outro exemplo de uma solicitação que passa por um proxy de Londres, Reino Unido. Adicionando `cc-GB-city-london` à string de nome de usuário permite especificar uma cidade. Clique [**aqui**](/products/pt-br/proxies/residential-proxies/location-settings/select-city.md) para obter mais informações sobre como dominar a segmentação de proxy por cidade.

```shell
curl -x pr.oxylabs.io:7777 -U "customer-USERNAME-cc-GB-city-london:PASSWORD" https://ip.oxylabs.io
```

Se você precisar manter o mesmo proxy por mais de uma solicitação, use um [**controle de sessão**](/products/pt-br/proxies/residential-proxies/session-control.md)**.** Adicione `sessid-abc12345` à sua string de nome de usuário, em que `abc12345` pode ser qualquer string aleatória, e enquanto você continuar enviando solicitações com essa string (ID de sessão), você obterá o mesmo IP do proxy.

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

Confira nossos [**tutoriais de integração**](/integrations/pt-br/proxy-integrations.md) com as ferramentas de terceiros mais populares, como [**ShadowRocket**](/integrations/pt-br/proxy-integrations/residential-proxies-guides/shadowrocket.md), [**SwitchyOmega**](broken://pages/10c2b5271061d7bf859ba6b47e071d39416da51c) , ou [**AdsPower**](/integrations/pt-br/proxy-integrations/residential-proxies-guides/adspower.md).

Você também pode configurar Residential Proxies usando o [**gerador de endpoints**](/products/pt-br/proxies/residential-proxies/endpoint-generator.md).

Faça login no [**painel**](https://dashboard.oxylabs.io/en/overview/RP), selecione Residential Proxies e clique no gerador de endpoints. Escolha os parâmetros e obtenha uma lista de endpoints para integrar nossos proxies com as ferramentas de sua preferência.

Para descobrir suas estatísticas de uso, tráfego gerado, contagem de solicitações e mais, faça login no [**painel**](https://dashboard.oxylabs.io/en/). Você também pode adicionar usuários de proxy (subusuários) e acompanhar as estatísticas deles separadamente.

Se tiver mais alguma dúvida, entre em contato com seu gerente de conta ou com nossa equipe de suporte em [**support@oxylabs.io**](mailto:support@oxylabs.io).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://developers.oxylabs.io/products/pt-br/proxies/residential-proxies/getting-started.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.