Criando uma Task

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

Etapa 1: Abrir o Dashboard

Acesse o Dashboard e faça login com sua conta FourA.

Etapa 2: Criar uma Chave de API

Vá para a página API Keys e clique em Create API key. Depois que você tiver uma chave, o botão acima da lista exibirá Create Key.

Dê um nome descritivo à chave (por exemplo, "production-scraper" ou "dev-testing"). A caixa de diálogo API Key Created mostra a chave em texto simples com um botão de cópia e, em Test your first request, um comando curl pronto para execução com Copy command. Em um celular ou tablet, Try it in the Playground leva você até lá.

Se perder essa tela, clique no ícone de olho na linha da chave mais tarde para revelá-la novamente. Chaves legadas criadas antes do lançamento do recurso de revelação não podem ser recuperadas; regenere-as uma vez para fazer a transição. Fluxo completo: Gerenciando Chaves de API.

Sua chave se parece com isto: pk_live_a1b2c3d4e5f6...

Etapa 3: Escolher um Endpoint

A FourA oferece quatro endpoints para diferentes cenários:

Auto (POST /api/auto/)

O padrão inteligente. Passe uma URL, de preferência com uma regra validate, e a FourA percorre uma sequência progressiva, de um proxy rotativo a um navegador completo via proxy, parando na primeira resposta válida. Defina forceProxy: false para permitir uma tentativa inicial com request direta. Ideal quando você está acessando um novo site e ainda não sabe o que ele exige.

Single (POST /api/single/)

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

Browser (POST /api/browser/)

Executa uma instância do navegador Chrome para renderizar JavaScript. Ideal para SPAs, conteúdo com carregamento lento e páginas que exigem execução de JS. Tempo de resposta: 2 a 10 segundos.

Proxy (POST /api/proxy/)

Roteia a request por meio de proxies rotativos com repetição automática. Ideal para sites que verificam a origem da requisição ou respondem de forma diferente dependendo do país.

Etapa 4: Enviar 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"}'

Etapa 5: Ler 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 para cada salto de redirecionamento. Cada entrada possui um result com a linha de status e todos os headers de resposta retornados pelo destino.

Campos principais:

  • status: código de status HTTP do site de destino
  • data: o corpo da resposta (HTML, JSON ou texto sem formatação)
  • total_time: duração da requisição em segundos

Etapa 6: Tente uma requisição com navegador

Se a página de destino usa JavaScript para renderizar conteúdo, use o endpoint de navegador:

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 resposta do navegador usa body em vez de data:

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

Problemas Comuns

Problema Solução
Dúvida sobre qual engine usar Comece com o endpoint auto. Ele escolhe o caminho correto e memoriza o que funcionou.
Conteúdo vazio Alterne do endpoint single para o browser: a página provavelmente precisa de renderização JS
Página de verificação na response Alterne para o endpoint proxy para rotação automática de IP
Timeout Aumente timeout_ms ou verifique se a URL está correta
Perdeu sua chave Clique no ícone de olho na linha da chave em API Keys para exibi-la, ou gere novamente se a chave for legada

Próximos Passos

Atualizado em: 28 de outubro de 2026