Docs › Dashboard › Criando uma Task

Criando uma Task

Este guia orienta você na criação de uma API key e no envio da sua primeira request usando o Dashboard da FourA.

Passo 1: Abra o Dashboard

Navegue até o Dashboard e faça login com a sua conta da FourA.

Passo 2: Crie uma API Key

Vá para a página API Keys e clique em Create Key.

Dê um nome descritivo para a key (por exemplo, "production-scraper" ou "dev-testing"). A caixa de diálogo de confirmação mostra a key em texto simples com um botão de cópia.

Se você perdê-la, clique no ícone de olho na linha da key mais tarde para revelá-la novamente. Keys legadas criadas antes de a revelação ser lançada não podem ser recuperadas; regenere-as uma vez para fazer a troca. Fluxo completo: Gerenciando API Keys.

A sua key será parecida com isto: pk_live_a1b2c3d4e5f6...

Passo 3: Escolha um Endpoint

A FourA tem quatro endpoints para cenários diferentes:

Auto (POST /api/auto/)

O padrão inteligente. Passe um URL mais uma regra de validate e a FourA escolhe o caminho mais barato que funciona: request direta, proxy rotativo ou browser completo. Melhor quando você está direcionando para um novo site e ainda não sabe o que ele precisa.

Single (POST /api/single/)

Envia uma request HTTP rápida. Melhor para páginas HTML estáticas e endpoints de API. Tempo de resposta: normalmente menos de 2 segundos.

Browser (POST /api/browser/)

Executa uma instância do Chrome para renderizar JavaScript. Melhor para SPAs, conteúdo carregado lentamente e páginas que requerem execução de JS. Tempo de resposta: 2 a 10 segundos.

Proxy (POST /api/proxy/)

Roteia a request por proxies rotativos com repetição automática. Melhor para sites com detecção de bot ou conteúdo restrito geograficamente.

Passo 4: Envie a Sua Primeira Request

Abra um terminal e execute:

curl -X POST https://eu.api.foura.ai/api/single/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method": "GET", "url": "https://example.com"}'

Passo 5: Leia a Response

{
  "status": 200,
  "headers": [
    {
      "result": { "version": "HTTP/2", "code": 200, "reason": "" },
      "content-type": "text/html; charset=UTF-8",
      "content-length": "1256"
    }
  ],
  "data": "<html>...</html>",
  "total_time": 0.45
}

O campo headers é um array de objetos, um por salto de redirecionamento. Cada entrada tem um result com a linha de status mais cada cabeçalho de response que o alvo retornou.

Campos-chave:

  • status: Código de status HTTP do site alvo
  • data: o corpo da response (HTML, JSON ou texto bruto)
  • total_time: duração da request em segundos

Passo 6: Tente uma Request de Browser

Se a página alvo usar JavaScript para renderizar o conteúdo, use o endpoint de browser em vez disso:

curl -X POST https://eu.api.foura.ai/api/browser/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/products", "timeout_ms": 15000}'

A response do browser usa body em vez de data:

{
  "status": 200,
  "headers": {"content-type": "text/html"},
  "body": "<html>...</html>"
}

Problemas Comuns

Problema Solução
Não tem certeza de qual engine usar Comece com o endpoint auto. Ele escolhe o caminho certo e lembra o que funcionou.
Conteúdo vazio Mude do endpoint single para browser: a página provavelmente precisa de renderização JS
Captcha na response Mude para o endpoint proxy para rotação automática de IP
Timeout Aumente timeout_ms ou verifique se o URL está correto
Perdeu a sua key Clique no ícone de olho na linha da key em API Keys para revelá-la, ou regenere se a key for legada

Próximos Passos

Atualizado em: 8 de julho de 2026
← Visão geral do Dashboard Gerenciar chaves de API →