# Criando uma Task

> URL: https://foura.ai/pt/docs/dashboard/creating-a-task
> Updated: 2026-10-28
> Index: https://foura.ai/llms.txt

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](https://foura.ai/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](https://foura.ai/docs/dashboard/api-keys).

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:

```bash
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

```json
{
  "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:

```bash
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`:

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

- [Visão Geral do Dashboard](https://foura.ai/docs/dashboard/overview): Demonstração completa do dashboard
- [Playground](https://foura.ai/docs/dashboard/playground): Teste requests no dashboard antes de escrever código
- [Smart Fetch (Auto)](https://foura.ai/docs/guides/smart-fetch): Análise aprofundada sobre o endpoint auto
- [Escolhendo o Endpoint Correto](https://foura.ai/docs/guides/choosing-task-type): Comparativo detalhado
- [Problemas Comuns](https://foura.ai/docs/troubleshooting/common-issues): Resolva problemas rapidamente
