Docs › Dashboard › Fazendo a Primeira Requisição

Fazendo a Primeira Requisição

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

Passo 1: Abrir o Dashboard

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

Passo 2: Criar uma Chave de API

Acesse a página de API Keys e clique em Create Key.

Dê à chave um nome descritivo (ex: "production-scraper" ou "dev-testing"). A chave completa é exibida apenas uma vez, portanto, copie-a imediatamente.

Sua chave se parecerá com isto: pk_live_a1b2c3d4e5f6...

Passo 3: Escolher um Endpoint

O FourA possui três endpoints para diferentes cenários:

Single (POST /api/single/)

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

Browser (POST /api/browser/)

Executa uma instância do navegador Chrome para renderizar JavaScript. Ideal para SPAs, conteúdo carregado sob demanda (lazy-loaded) e páginas que exigem execução de JS. Tempo de response: de 2 a 10 segundos.

Proxy (POST /api/proxy/)

Roteia a request através de proxies rotativos com tentativa automática. Ideal para sites com detecção de bots ou conteúdo com restrição geográfica.

Passo 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"}'

Passo 5: Ler a Response

{
  "status": 200,
  "headers": [["content-type", "text/html"]],
  "data": "<html>...</html>",
  "total_time": 0.45
}

Campos principais:

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

Passo 6: Experimentar uma Request de Browser

Se a página de destino usa JavaScript para renderizar conteúdo, use o endpoint 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
Conteúdo vazio Alterne do endpoint single para o browser: a página provavelmente precisa de renderização de JS
CAPTCHA na response Alterne para o endpoint proxy para rotação automática de IP
Timeout Aumente o timeout_ms ou verifique se a URL está correta

Próximos Passos

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