# Controle de Redirecionamento e Modo Raw Buffer

> URL: https://foura.ai/pt/blog/redirect-control-raw-buffer-mode
> Updated: 2026-09-27
> Index: https://foura.ai/llms.txt

Cadeias de redirecionamento quebram scrapers. Respostas binárias são corrompidas quando decodificadas como texto. Dois problemas que surgem constantemente assim que você passa da fase de "buscar uma página, analisar o HTML".

Lançamos duas novas opções de request para lidar com ambos: `followRedirects` e `returnBuffer`. Elas já estão disponíveis na API.

## Como funciona

### Controle de redirecionamento com followRedirects

A maioria das APIs de scraping trata redirecionamentos como um booleano: seguir ou não. Isso funciona até você encontrar uma cadeia de redirecionamentos em loop, ou precisar da própria resposta intermediária 302 para extrair um parâmetro de rastreamento.

O `followRedirects` do FourA aceita um número inteiro entre 0 e 20. Omita o parâmetro (ou defina como 0) e você receberá a resposta bruta de redirecionamento, incluindo todos os headers. Defina como 5 e a request seguirá até cinco saltos antes de retornar a resposta final.

```bash
curl -X POST "https://eu.api.foura.ai/v1/request" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/short-link",
    "followRedirects": 3,
    "unblocker": true
  }'
```

Isso segue até três redirects. Se a cadeia for resolvida em dois, você recebe a página final. Se for maior que três, você recebe o que quer que o terceiro salto tenha retornado.

A distinção importa mais do que parece. Sites de e-commerce fazem redirects por URLs de rastreamento antes de chegar à página do produto. Você quer seguir esses redirects. Mas redes de afiliados e encurtadores de URL às vezes criam cadeias com seis, sete ou oito saltos. Além disso, alguns loops de redirect nunca são resolvidos. Limitar a um número específico significa coletar dados sem ficar preso em um loop infinito que esgota o seu timeout de request.

Antes disso, a solução paliativa era enviar um request com redirects desativados, processar o header `Location` manualmente e enviar outro request. Isso representava no mínimo duas chamadas de API, o dobro de latência e código adicional para manter. Agora é apenas uma chamada com um número.

### Respostas Binárias Raw com returnBuffer

Ao coletar imagens, PDFs ou payloads protobuf, a decodificação de texto corrompe os dados. A biblioteca HTTP assume que a resposta é texto, aplica detecção de charset e altera silenciosamente qualquer byte incompatível. O protobuf fica ilegível. Os headers de imagem quebram. O resultado são arquivos corrompidos sem nenhuma mensagem de erro clara para explicar o motivo.

O `returnBuffer` instrui a API a ignorar completamente a decodificação de texto.

```bash
curl -X POST "https://eu.api.foura.ai/v1/request" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/product-image.jpg",
    "returnBuffer": true
  }'
```

O corpo da response retorna como bytes brutos (codificado em base64 nas responses JSON). Decodifique do seu lado e você terá exatamente o que o servidor enviou. Sem suposições de charset, sem conversão de encoding, sem corrupção silenciosa.

Esse era um dos chamados de suporte mais comuns que víamos: usuários coletando imagens de produtos ou catálogos em PDF e recebendo arquivos que não abriam. A solução era sempre a mesma, mas agora há uma flag dedicada em vez de uma gambiarra.

## Impacto

Ambos os recursos reduzem o número de chamadas de API por job. `followRedirects` elimina loops manuais para seguir redirects. `returnBuffer` elimina o ciclo de "fazer a requisição, perceber a corrupção e tentar novamente com configurações diferentes".

Para alvos com muitos redirects (links de afiliados, encurtadores de URL, cadeias de rastreamento de e-commerce), vimos o número de requests cair entre 40% e 60% em testes iniciais quando os usuários migram do tratamento manual de redirects para `followRedirects`. E para tarefas de coleta de arquivos binários (imagens de produtos, downloads de documentos), `returnBuffer` transforma um processo complexo em uma única opção (resultados preliminares).

Não são recursos chamativos. São o tipo de coisa em que você não pensa até seu scraper quebrar às 3 da manhã porque um site adicionou um redirect extra no fluxo de checkout.

## Para Usuários Avançados

Combine `followRedirects` com validação de response para obter controle preciso sobre cadeias de redirect. Siga redirects, mas aborte a request se o destino final for bloqueado:

```bash
curl -X POST "https://eu.api.foura.ai/v1/request" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/product/12345",
    "followRedirects": 5,
    "unblocker": true,
    "validate": {
      "status": { "fail": [403, 503] },
      "data": { "fail": ["Access Denied", "captcha"] }
    }
  }'
```

Isso segue até cinco redirecionamentos e depois verifica a resposta final. Se o site redirecionou você para uma página de verificação ou uma barreira de acesso negado, a request falha de forma limpa. Sem dados corrompidos para filtrar downstream.

Para coleta de binários, combine `returnBuffer` com requests HEAD quando você precisar checar os tipos de conteúdo antes de baixar arquivos grandes. O FourA lida com HEAD corretamente, permitindo inspecionar headers sem buscar o body. Verifique o Content-Type, decida se vale a pena o download e então faça a request completa com `returnBuffer: true`.

E se você estiver usando [tarefas de navegador](https://foura.ai/blog/browser-tasks-scrape-javascript-heavy-sites) para alvos pesados em JavaScript, observe que essas opções se aplicam ao motor HTTP direto. Requests de navegador lidam com redirecionamentos por meio da navegação nativa do navegador, que os segue por padrão sem limite.

## O que vem a seguir

Estamos trabalhando para expor mais controles no nível da request por meio da API: resolução DNS personalizada, ajuste de timeout por fase e opções de gerenciamento de certificados. O objetivo é o controle total do perfil do navegador por meio de uma interface REST limpa, sem a sobrecarga de infraestrutura.

Se houver uma opção específica que você precisa, estamos à disposição. O [dashboard](https://foura.ai/blog/dashboard-analytics-and-usage-insights) já mostra como suas requests operam com essas novas opções, para que você possa medir a diferença por conta própria.
