> 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/documentation/pt-br/comecar/inicio-rapido-web-unblocker.md).

# Início rápido: Web Unblocker

{% hint style="success" %}
Já está familiarizado com o básico? Confira [documentação do Web Unblocker](/products/pt-br/web-unblocker.md).
{% endhint %}

Oxylabs [Web Unblocker](https://oxylabs.io/products/web-unblocker) é uma solução de proxy com tecnologia de IA, projetada para lidar com os sistemas de gerenciamento de tráfego de bots mais sofisticados (por exemplo, Akamai, Cloudflare ou DataDome). Ela gerencia automaticamente a rotação de proxies, a impressão digital do navegador e o tratamento de CAPTCHA, para que você possa se concentrar nos dados.

{% stepper %}
{% step %}

### Configuração e credenciais

1. **Crie uma conta:** Cadastre-se no [Dashboard da Oxylabs](https://dashboard.oxylabs.io/).
2. **Crie um usuário de API:** Navegue até Web Unblocker → Users e crie um nome de usuário e uma senha (Estas são credenciais para autorizar o acesso ao Web Unblocker e são separadas do seu login no dashboard)
   {% endstep %}

{% step %}

### Sua primeira solicitação

Web Unblocker é integrado como um proxy. Use o endpoint `unblock.oxylabs.io:60000` e passe suas instruções por meio de cabeçalhos personalizados.

```bash
curl -k -x unblock.oxylabs.io:60000 -U 'USERNAME:PASSWORD' \
'https://sandbox.oxylabs.io/products' \
-H 'x-oxylabs-geo-location: United States' \
-H 'x-oxylabs-render: html'
```

{% hint style="info" %}
Substitua `USERNAME` e `PASSWORD` pelas credenciais do seu usuário
{% endhint %}
{% endstep %}
{% endstepper %}

### Cabeçalhos essenciais

Ao contrário dos proxies padrão, o Web Unblocker usa cabeçalhos para controlar seus recursos orientados por IA:

| Cabeçalho                 | Valor                              | Descrição                                                                           |
| ------------------------- | ---------------------------------- | ----------------------------------------------------------------------------------- |
| `x-oxylabs-geo-location`  | `Estados Unidos`, `Alemanha`, etc. | Define o nó de saída para um país específico.                                       |
| `x-oxylabs-render`        | `html` ou `png`                    | Ativa a renderização de JavaScript ou retorna uma captura de tela.                  |
| `x-oxylabs-session-id`    | `AnyRandomString`                  | Mantém o mesmo IP para várias solicitações (Sticky Session).                        |
| `x-oxylabs-force-headers` | `1`                                | Força a ferramenta a enviar seus próprios cabeçalhos personalizados para o destino. |

### Códigos de resposta comuns

| Código | Status                | Descrição                                                          |
| ------ | --------------------- | ------------------------------------------------------------------ |
| `200`  | `OK`                  | Solicitação bem-sucedida. Você recebe o HTML completo renderizado. |
| `401`  | `Não autorizado`      | Credenciais inválidas do usuário de API ou autenticação ausente.   |
| `429`  | `Muitas solicitações` | Você atingiu o limite de taxa da sua conta.                        |
| `550`  | `Com falha`           | O sistema não conseguiu acessar o site após várias tentativas.     |

Você pode encontrar a [lista completa de códigos de resposta](/products/pt-br/web-unblocker/response-codes.md) na seção do produto Web Unblocker.

### Próximas etapas

* **Controle avançado do navegador:** Precisa clicar em botões ou rolar a página? Confira as [Instruções personalizadas do navegador](/products/pt-br/web-unblocker/custom-browser-instructions.md) na seção Produtos.
* **Segmentação geográfica:** Para dados localizados, veja a [Geolocalização](/products/pt-br/web-unblocker/making-requests/geo-location.md) página para segmentar países, cidades ou coordenadas específicas.


---

# 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/documentation/pt-br/comecar/inicio-rapido-web-unblocker.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.