Crear una tarea

Esta guía te explica cómo crear una API key y enviar tu primera request usando el Dashboard de FourA.

Paso 1: Abre el Dashboard

Ve al Dashboard e inicia sesión con tu cuenta de FourA.

Paso 2: Crea una API Key

Ve a la página de 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 en texto sin formato con un botón para copiar, y debajo de 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 lleva allí directamente.

Si no la copiaste a tiempo, haz clic en el icono del ojo en la fila de la clave más tarde para mostrarla de nuevo. Las claves antiguas creadas antes de que existiera esta opción no se pueden recuperar; vuelve a generarlas una vez para actualizarlas. Flujo completo: Managing API Keys.

Tu clave se ve así: pk_live_a1b2c3d4e5f6...

Paso 3: Elige un Endpoint

FourA tiene cuatro endpoints para diferentes escenarios:

Auto (POST /api/auto/)

La opción inteligente por defecto. Envía una URL junto con una regla validate y FourA elegirá la ruta más económica que funcione: request directa, proxy rotatorio o navegador completo. Ideal cuando apuntas a un sitio nuevo y aún no sabes qué necesita.

Single (POST /api/single/)

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

Browser (POST /api/browser/)

Ejecuta una instancia del navegador Chrome para renderizar JavaScript. Ideal para SPAs, contenido con lazy loading y páginas que requieren ejecución de JS. Tiempo de respuesta: de 2 a 10 segundos.

Proxy (POST /api/proxy/)

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

Paso 4: Envía tu primera request

Abre una terminal y ejecuta:

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

{
  "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 response que devolvió el destino.

Campos clave:

• status: código de estado HTTP del sitio de destino
• data: el cuerpo de la response (HTML, JSON o texto sin procesar)
• total_time: duración de la request en segundos

Paso 6: Prueba una request de navegador

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

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 respuesta del navegador utiliza body en lugar de data:

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

Problemas comunes

Pasos siguientes

• Dashboard Overview: Recorrido completo del dashboard
• Playground: Prueba requests en el dashboard antes de escribir código
• Smart Fetch (Auto): Análisis detallado del endpoint auto
• Choosing the Right Endpoint: Comparación detallada
• Common Issues: Resuelve problemas rápidamente