Criando uma Task

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

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. Assim que você tiver uma chave, o botão acima da lista exibirá Create Key.

Dê um nome descritivo para a chave (por exemplo, "production-scraper" ou "dev-testing"). A caixa de diálogo API Key Created exibe 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 você perder essa tela, clique no ícone de olho na linha da chave mais tarde para revelá-la novamente. Chaves legadas criadas antes da disponibilização desse recurso não podem ser recuperadas; gere-as novamente uma vez para atualizar. Fluxo completo: Managing API Keys.

Sua chave se parece com isto: pk_live_a1b2c3d4e5f6...

Etapa 3: Escolher um endpoint

O FourA tem quatro endpoints para cenários diferentes:

Auto (POST /api/auto/)

O padrão inteligente. Envie uma URL e uma regra de validate, e o FourA escolhe o caminho mais econômico que funcione: request direta, proxy rotativo ou navegador completo. Ideal para quando você estiver acessando um novo site e ainda não souber do que ele precisa.

Single (POST /api/single/)

Envia uma request HTTP 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 (lazy load) e páginas que exigem execução de JS. Tempo de resposta: 2 a 10 segundos.

Proxy (POST /api/proxy/)

Encaminha a request por meio de proxies rotativos com repetição automática. Ideal para sites que verificam a origem da requisição ou que 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 resposta

{
  "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

Passo 6: Tente uma requisição de 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

Próximos Passos

• Visão Geral do Dashboard: Demonstração completa do dashboard
• Playground: Teste requests no dashboard antes de escrever código
• Smart Fetch (Auto): Análise aprofundada sobre o endpoint auto
• Escolhendo o Endpoint Correto: Comparação detalhada
• Problemas Comuns: Resolva problemas rapidamente