# Crear una tarea

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

Esta guía te orienta para crear una API key y enviar tu primera request usando el Dashboard de FourA.

## Paso 1: Abre el Dashboard

Ve al [Dashboard](https://foura.ai/dashboard) e inicia sesión con tu cuenta de FourA.

## Paso 2: Crea una API Key

Ve a la página **API Keys** y haz clic en **Create API key**. Una vez que tengas una clave, el botón encima de la lista mostrará **Create Key**.

Asigna a la clave un nombre descriptivo (por ejemplo, "production-scraper" o "dev-testing"). El diálogo **API Key Created** muestra la clave sin procesar con un botón para copiar, y bajo **Test your first request**, un comando curl listo para ejecutar con **Copy command**. En un teléfono o tablet, **Try it in the Playground** te llevará allí directamente.

Si no lo copiaste, haz clic en el icono del ojo en la fila de la clave para volver a mostrarla más tarde. Las claves heredadas creadas antes del lanzamiento de esta función no se pueden recuperar; vuelve a generarlas una vez para actualizarlas. Flujo completo: [Managing API Keys](https://foura.ai/docs/dashboard/api-keys).

Tu clave se ve así: `pk_live_a1b2c3d4e5f6...`

## Paso 3: Elige un Endpoint

FourA cuenta con cuatro endpoints para diferentes escenarios:

### Auto (`POST /api/auto/`)

La opción inteligente por defecto. Envía una URL, idealmente con una regla `validate`, y FourA escala progresivamente desde un proxy rotativo hasta un navegador completo a través de proxy, deteniéndose en la primera respuesta válida. Define `forceProxy: false` para que intente una request directa primero. Es ideal cuando trabajas con un sitio nuevo y aún no sabes qué necesita.

### Single (`POST /api/single/`)

Envía una HTTP request rápida. Ideal para páginas HTML estáticas y endpoints de API. Tiempo de response: típicamente menos de 2 segundos.

### Browser (`POST /api/browser/`)

Ejecuta una instancia de navegador Chrome para renderizar JavaScript. Ideal para SPAs, contenido con carga diferida (lazy load) y páginas que requieren ejecución de JS. Tiempo de response: de 2 a 10 segundos.

### Proxy (`POST /api/proxy/`)

Enruta la request a través de proxies rotativos con reintento automático. Ideal para sitios que verifican el origen de la conexión o que responden de forma distinta según el país.

## Paso 4: Envía tu primera request

Abre una terminal y ejecuta:

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

## Paso 5: Lee la 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
}
```

El campo `headers` es un array de objetos, uno por cada salto de redirección. Cada entrada tiene un `result` con la línea de estado más cada header de respuesta que devolvió el destino.

Campos clave:
- **status**: código de estado HTTP del sitio de destino
- **data**: el cuerpo de la respuesta (HTML, JSON o texto sin formato)
- **total_time**: duración de la request en segundos

## Paso 6: Prueba una request con navegador

Si la página de destino usa JavaScript para renderizar contenido, usa el endpoint de navegador en su lugar:

```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}'
```

La response del navegador utiliza `body` en lugar de `data`:

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

## Problemas comunes

| Problema | Solución |
|---------|----------|
| No estás seguro de qué motor usar | Empieza con el endpoint auto. Elige la ruta adecuada y recuerda lo que funcionó. |
| Contenido vacío | Cambia del endpoint single al browser: es probable que la página requiera renderizado de JS |
| Página de verificación en la respuesta | Cambia al endpoint proxy para la rotación automática de IP |
| Timeout | Aumenta `timeout_ms` o verifica que la URL sea correcta |
| Perdiste tu clave | Haz clic en el icono del ojo en la fila de la clave en **API Keys** para mostrarla, o regenera si la clave es legacy |

## Pasos siguientes

- [Vista general del Dashboard](https://foura.ai/docs/dashboard/overview): Recorrido completo por el dashboard
- [Playground](https://foura.ai/docs/dashboard/playground): Prueba requests en el dashboard antes de escribir código
- [Smart Fetch (Auto)](https://foura.ai/docs/guides/smart-fetch): Análisis detallado del endpoint auto
- [Elegir el endpoint correcto](https://foura.ai/docs/guides/choosing-task-type): Comparación detallada
- [Problemas comunes](https://foura.ai/docs/troubleshooting/common-issues): Resuelve problemas rápidamente
